Production-grade infrastructure for building AI coding assistants. An open-source alternative to Cursor/Devin with good security and self-hosting capabilities.
Forge is a 75% complete platform for building AI-powered developer tools with features that existing solutions lack:
- 🏠 Self-Hosted - Deploy on-premises for compliance (HIPAA, SOC2, etc.)
- 🤖 Multi-LLM - OpenAI, Anthropic, or bring your own model
- 🔒 Security - RBAC, policy engine, secrets detection
- 📊 Complete Audit Trails - Track every AI interaction
- 🐳 Production-Ready - Docker, PostgreSQL, Redis, Weaviate
# Clone repository
git clone https://github.com/yusufadeagbo/Forge.git
cd Forge
# Copy environment file
cp .env.example .env
# Edit .env and add your API keys:
# - OPENAI_API_KEY (required)
# - ANTHROPIC_API_KEY (optional)
# Start infrastructure (PostgreSQL, Redis, Weaviate, MinIO)
docker-compose up -d
# Install dependencies
npm install
# Build all packages
npm run build
# Run database migrations
cd packages/memory && npx prisma migrate dev && cd ../..
# Start API server
./start-api.sh
# In another terminal, verify it works:
curl http://localhost:3000/api/v1/health
# Should return: {"status":"healthy",...}See docs/GETTING_STARTED.md for detailed setup.
-
Core Infrastructure
- REST API with Express
- PostgreSQL + Prisma ORM
- Redis caching
- Weaviate vector database
- MinIO object storage
- Docker Compose orchestration
-
AI Integration
- Multi-LLM routing (OpenAI, Anthropic)
- Intelligent fallback logic
- Token usage tracking
- Spec generation from natural language
- Job orchestration system
-
Security & Compliance
- Role-based access control (RBAC)
- Policy engine for approval workflows
- Secrets detection in code
- Complete audit trails
-
Developer Tools
- CLI for project management
- Code indexing with tree-sitter
- GitHub PR integration structure
- VS Code extension structure
- Docker sandbox execution
- Actual code generation
- Test running & validation
- Diff generation
- GitHub PR creation
- VS Code extension completion
- Multi-repository support
- Cost tracking dashboard
- Web UI for management
Monorepo with 12 packages:
packages/
├── api/ # REST API server (Express + TypeScript)
├── cli/ # Command-line interface
├── executor/ # Docker sandbox manager
├── indexer/ # Code indexing (tree-sitter)
├── memory/ # Database repositories (Prisma)
├── model-router/ # LLM routing & fallback logic
├── monitoring/ # Prometheus metrics
├── planner/ # Spec & job generation
├── pr-manager/ # GitHub/GitLab integration
├── safety/ # Security & secrets detection
├── shared/ # Common types & utilities
└── vscode/ # VS Code extension (WIP)
Tech Stack: TypeScript · Node.js · Docker · PostgreSQL · Redis · Weaviate · Prisma · Express
- Getting Started Guide - Setup and first steps
- Architecture Overview - System design
- Development Guide - Contributing guide
- API Reference - REST API documentation
- Model Router Setup - LLM configuration
- GitHub Integration - GitHub App setup
I welcome contributions! See CONTRIBUTING.md for guidelines.
Areas I need help with:
- ✅ Completing executor integration
- 🧪 Test coverage improvements
- 📚 Documentation enhancements
- 🎨 VS Code extension development
- 🐛 Bug fixes and optimizations
Existing AI coding tools (Cursor, Devin, GitHub Copilot) are excellent but have limitations:
| Requirement | Cursor/Devin | Copilot | Forge |
|---|---|---|---|
| Self-hosted | ❌ No | ❌ No | ✅ Yes |
| Multi-LLM | ❌ No | ❌ No | ✅ Yes |
| Advanced RBAC | ✅ Built-in | ||
| Policy Engine | ❌ No | ❌ No | ✅ Yes |
| Audit Trails | ✅ Complete | ||
| Secrets Detection | ✅ Built-in | ||
| Compliance Ready | ❌ No | ❌ No | ✅ Yes |
Forge was built to solve these problems with production-grade, self-hosted architecture.
- Secrets Detection - Automatically scans code for API keys, tokens, passwords
- Policy Engine - Define approval workflows for sensitive operations
- RBAC - Fine-grained role-based access control
- Audit Logs - Complete tracking of all operations
Found a security issue? Email yusufadeagbo100@gmail.com or see SECURITY.md.
| Metric | Value |
|---|---|
| Completion | 75% |
| Production Code | 10,119 lines (5,651 prod + 4,468 tests) |
| Packages | 12/12 building successfully |
| Test Coverage | Partial (expanding) |
| Build Status | ✅ Passing |
See ROADMAP.md for detailed status and upcoming features.
Banks, healthcare, and government contractors that can't send code to external APIs.
Large organizations managing dozens of microservices that need coordinated changes.
Teams using proprietary or specialized language models (finance-tuned, medical-tuned, etc.).
Agencies that need approval workflows before AI-generated code goes to production.
MIT License - see LICENSE for details.
Free to use, modify, and distribute. No restrictions for commercial use.
Built with excellent open source tools:
- OpenAI & Anthropic for LLM APIs
- Prisma for database ORM
- tree-sitter for code parsing
- Weaviate for vector search
- Docker for containerization
Author: Yusuf Adeagbo
GitHub: @yusufadeagbo
Email: yusufadeagbo100@gmail.com
LinkedIn: https://www.linkedin.com/in/yusufadeagbo/
💼 Available for consulting on AI developer tools and integrations
Q: Can I use this in production?
A: It's 75% complete. Core platform works, but executor integration is in progress. Suitable for evaluation and contribution.
Q: What LLMs are supported?
A: OpenAI (GPT-4, GPT-3.5) and Anthropic (Claude). Easy to add more via the model router.
Q: Is this really better than Cursor?
A: Different use case. Cursor is great for individual developers. Forge is for teams that need self-hosting, compliance, and controls.
Q: How can I help?
A: Check CONTRIBUTING.md and look for issues labeled good-first-issue or help-wanted.
⭐ If you find this project interesting, please star the repository!
Made with ❤️ by developers who believe in open, secure, and AI tools.