An open API service indexing awesome lists of open source software.

https://github.com/agentage/web

Agent Age Landing page and documentation
https://github.com/agentage/web

agent-marketplace ai ai-agent-framework ai-agents

Last synced: 5 months ago
JSON representation

Agent Age Landing page and documentation

Awesome Lists containing this project

README

          

# Agentage - AI Agent Platform

An open-source platform for building, sharing, and deploying AI agents with simplicity.

## 🚀 Quick Start

### Prerequisites

- Node.js 20 or higher
- npm 10 or higher
- Docker and Docker Compose (for deployment)

### Development Setup

1. **Clone the repository:**

```bash
git clone https://github.com/agentage/web.git
cd web
```

2. **Install dependencies:**

```bash
npm install
```

3. **Configure secrets for local development:**

```bash
# Copy the template
cp app-secrets.dev.json app-secrets.local.json

# Edit app-secrets.local.json with your OAuth credentials
# See README-SECRETS.md for detailed setup instructions
```

4. **Start development servers:**

```bash
npm run dev
```

5. **Access the application:**
- Frontend: http://localhost:3000
- Backend API: http://localhost:3001/api/health

## 📦 Project Structure

```
web/
├── packages/
│ ├── shared/ # Shared TypeScript types
│ ├── backend/ # Express.js API server
│ └── frontend/ # Next.js 14 web application
├── .github/
│ └── workflows/ # CI/CD pipelines
├── scripts/ # Development scripts
└── docs/ # Documentation
```

## 🛠️ Available Commands

```bash
npm run dev # Start development servers
npm run build # Build all packages
npm run lint # Run ESLint
npm run format # Format code with Prettier
npm run type-check # Run TypeScript type checking
npm run clean # Clean build artifacts and dependencies
```

## 🐳 Docker Deployment

### Build Images

```bash
docker build --target backend -t agentage-backend .
docker build --target frontend -t agentage-frontend .
```

### Run with Docker Compose

```bash
docker compose up -d
```

## 🤝 Contributing

1. Fork the repository
2. Create your feature branch (`git checkout -b feature/amazing-feature`)
3. Commit your changes (`git commit -m 'Add amazing feature'`)
4. Push to the branch (`git push origin feature/amazing-feature`)
5. Open a Pull Request

## 📄 License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

## 📚 Documentation

- [Secrets Configuration Guide](README-SECRETS.md) - Setup OAuth and environment secrets
- [Secrets Injection Process](docs/secrets-injection.md) - How secrets are deployed
- [GitHub Secrets Setup](docs/github-secrets-setup.md) - CI/CD configuration
- [OAuth Setup Guide](docs/auth-setup.md) - OAuth provider configuration

## 🔗 Links

- [Documentation](docs/)
- [Issues](https://github.com/agentage/web/issues)
- [Discussions](https://github.com/agentage/web/discussions)