An artifact-driven, event-orchestrated, multi-agent platform for deterministic AI-native software development lifecycle automation.
AIDE coordinates 13 specialized AI agents (5 cognitive, 8 governance) through a governed, phase-based software development lifecycle. It turns unstructured ideas into released software with deterministic state management, versioned rollback, and human oversight.
Refinement → Specification → Planning → Execution → Review → Release
| Layer | Services |
|---|---|
| Gateway | API Gateway (auth, rate-limit, routing) |
| Orchestration | Orchestrator (coordinator, state machine, event dispatch) |
| Domain | Artifact Service, Execution Service, Review Service |
| Integration | Git Service, Notification Service |
| Frontend | Next.js Dashboard, CLI |
- Backend: TypeScript / NestJS microservices
- Frontend: Next.js 14 (App Router) + Tailwind CSS
- Database: PostgreSQL 16 + Prisma ORM
- Queue: BullMQ (Redis-backed)
- Events: Kafka or NATS
- Deployment: Docker + Kubernetes (Helm)
- Node.js 20+ (see
.nvmrc) - Docker & Docker Compose
- Git
# 1. Clone the repository
git clone https://github.com/your-org/aide-platform.git
cd aide-platform
# 2. Install dependencies
npm install
# 3. Copy environment variables
cp .env.example .env
# Edit .env with your configuration
# 4. Start infrastructure (PostgreSQL, Redis, NATS)
docker compose -f infra/docker-compose.yml up -d
# 5. Run database migrations
npx prisma migrate dev
# 6. Seed the database
npx prisma db seed
# 7. Start all services in development mode
npx turbo dev- Dashboard: http://localhost:3000
- API Gateway: http://localhost:4000
- API Docs (Swagger): http://localhost:4000/api/docs
aide-platform/
├── apps/
│ ├── api-gateway/ # NestJS — auth, rate-limit, routing
│ ├── orchestrator/ # NestJS — coordinator, state machine
│ ├── artifact-service/ # NestJS — CRUD, versioning, lineage
│ ├── execution-service/ # NestJS — builder agent, step retry
│ ├── review-service/ # NestJS — compliance, drift detection
│ ├── git-service/ # NestJS — branch, commit, PR
│ ├── notification-service/ # NestJS — HITL prompts, webhooks
│ └── dashboard/ # Next.js 14 — web UI
├── packages/
│ ├── shared-types/ # Zod schemas, TS interfaces, enums
│ ├── event-contracts/ # Event constants and payload schemas
│ ├── db-client/ # Prisma client, migrations, seed
│ ├── logger/ # Pino logging wrapper
│ └── test-utils/ # Shared test factories and mocks
├── infra/ # Docker, Helm, Terraform
├── prisma/ # Schema and migrations
└── .github/ # CI/CD workflows
| Command | Description |
|---|---|
npm run build |
Build all packages and apps |
npm run dev |
Start all services in development mode |
npm run lint |
Lint all packages and apps |
npm run test |
Run unit tests |
npm run test:integration |
Run integration tests |
npm run format |
Format all files with Prettier |
npm run type-check |
Run TypeScript type checking |
npm run clean |
Remove all build artifacts |
MIT