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

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

1. Clone the repository:

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

2. Install dependencies:

   npm install

3. Configure secrets for local development:

   # 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:

   npm run dev

5. Access the application:

   • Frontend: http://localhost:3000
   • Backend API: http://localhost:3001/api/health

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

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 build --target backend -t agentage-backend .
docker build --target frontend -t agentage-frontend .

docker compose up -d

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

This project is licensed under the MIT License - see the LICENSE file for details.

• Secrets Configuration Guide - Setup OAuth and environment secrets
• Secrets Injection Process - How secrets are deployed
• GitHub Secrets Setup - CI/CD configuration
• OAuth Setup Guide - OAuth provider configuration

• Documentation
• Issues
• Discussions