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:

   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

📦 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

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

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

Run with Docker Compose

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 file for details.

📚 Documentation

• 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

🔗 Links

• Documentation
• Issues
• Discussions