███████╗██╗ ██╗ █████╗ ██████╗ ███╗ ███╗ ██╔════╝██║ ██║██╔══██╗██╔══██╗████╗ ████║ ███████╗██║ █╗ ██║███████║██████╔╝██╔████╔██║ ╚════██║██║███╗██║██╔══██║██╔══██╗██║╚██╔╝██║ ███████║╚███╔███╔╝██║ ██║██║ ██║██║ ╚═╝ ██║ ╚══════╝ ╚══╝╚══╝ ╚═╝ ╚═╝╚═╝ ╚═╝╚═╝ ╚═╝
Six AI agents. One command. Real working software.
Not a prototype. Not a demo. Production code ships in minutes.
🐝 Six agents argue, build, and ship together.
| Agent | Role | Superpower |
|---|---|---|
| 🏗️ Architect | System designer | Analyzes task deeply, chooses right stack, produces design all agents follow |
| ⚙️ Backend | API engineer | Reads Architect's design, generates production-grade task-specific code |
| 🎨 Frontend | UI engineer | Thinks from first principles, generates stunning dark-mode UI for any task |
| 🧪 Tester | QA enforcer | Actually RUNS the code, finds bugs, assigns fixes, blocks ship if broken |
| 📝 Docs | Technical writer | Reads actual code, documents reality not promises, Stripe-level quality |
| 📋 PM | Product manager | Writes real PRD, protects scope, triages bugs, makes ship decisions |
| Feature | ChatGPT | GitHub Copilot | Cursor | 🐝 Swarm |
|---|---|---|---|---|
| Multi-agent collaboration | ❌ | ❌ | ❌ | ✅ |
| Agents argue & debate decisions | ❌ | ❌ | ❌ | ✅ |
| Real-time cinematic terminal UI | ❌ | ❌ | ❌ | ✅ |
| Generates complete project structure | ❌ | ✅ | ||
| PM agent breaks requirements mid-build | ❌ | ❌ | ❌ | ✅ 😈 |
| Runs on GitHub Models API (free) | ❌ | ✅ | ❌ | ✅ |
| Open source & self-hostable | ❌ | ❌ | ❌ | ✅ |
| Builds Dockerfile + tests + docs | ❌ | ✅ | ||
| Tracks real cost per build | ❌ | ❌ | ❌ | ✅ |
| Works with 6 different LLMs | ❌ | ❌ | ❌ | ✅ |
| Tester actually runs the code | ❌ | ❌ | ❌ | ✅ |
| PM writes real PRD first | ❌ | ❌ | ❌ | ✅ |
No tool matches this PM chaos. 😈 It changes requirements mid-build to mirror real teams.
PLANNING → ARCHITECTURE REVIEW → IMPLEMENTATION → TESTING → DOCUMENTATION → PACKAGING → COMPLETE
| Phase | What Happens |
|---|---|
| Planning | PM writes PRD. Architect designs system. |
| Architecture Review | PM approves design. All agents briefed. |
| Implementation | Backend builds API. Frontend builds UI. |
| Testing | Tester RUNS code. Finds bugs. Assigns fixes. Signs off. |
| Documentation | Docs reads actual code. Writes accurate docs. |
| Packaging | All files written. Git initialized. PM final review. |
| Complete | Working product delivered. |
# 1. Clone
git clone https://github.com/DhruvTilva/swarm
cd swarm
# 2. Install
pip install -r requirements.txt
# 3. Build anything
python main.py "build me a YouTube video downloader with format selector"python main.py "build me a real-time crypto price tracker with alerts"
python main.py "build me an AI-powered resume analyzer with scoring"
python main.py "build me a GitHub repository analytics dashboard"
python main.py "build me a personal finance dashboard with charts"
python main.py "build me an API rate limiter with Redis and analytics"python main.py "build me a multi-tenant SaaS boilerplate with auth, billing, and role-based access"python -m venv .venv
.venv\Scripts\activate # Windows
source .venv/bin/activate # Mac/Linux
pip install -r requirements.txtswarm.config.yaml:
# GitHub Models (FREE — moderate quality)
provider: openai
api_key: "your_github_token"
model: gpt-4o
base_url: "https://models.inference.ai.azure.com"
# Groq (FREE tier — fastest inference)
# provider: groq
# api_key: "gsk_..."
# model: llama-3.3-70b-versatile
# Ollama (FREE forever — fully local and private)
# provider: ollama
# model: llama3.2
# base_url: "http://localhost:11434"
# Anthropic Claude (paid — highest quality)
# provider: anthropic
# api_key: "sk-ant-..."
# model: claude-sonnet-4-20250514
# Google Gemini (free tier available)
# provider: gemini
# api_key: "AIza..."
# model: gemini-2.0-flash
# OpenAI (paid - highest quality)
# provider: openai
# api_key: "sk-..."
# model: gpt-4o
temperature: 0.7
max_tokens: 2000
database_path: "swarm.db"
output_dir: "output"Provider override from CLI:
python main.py "build me a todo app" --provider groq
python main.py "build me a todo app" --provider ollama
python main.py "build me a todo app" --model gpt-4o
python main.py "build me a todo app" --output ./my-output| Provider | Cost | Speed | Quality | Get Started |
|---|---|---|---|---|
| GitHub Models | ✅ FREE | Fast | Moderate | github.com/settings/tokens |
| Groq | ✅ FREE tier | ⚡ Fastest | Good | console.groq.com |
| Ollama | ✅ FREE forever | Medium | Good | ollama.ai |
| Google Gemini | ✅ Free tier | Fast | Good | aistudio.google.com |
| OpenAI | 💳 Paid | Fast | Excellent | platform.openai.com |
| Anthropic Claude | 💳 Paid | Fast | Excellent | console.anthropic.com |
Swarm tracks every API call and shows estimated cost in the dashboard in real time.
Typical build costs:
| Provider | Avg Cost Per Build |
|---|---|
| GitHub Models | FREE |
| Groq free tier | FREE |
| Ollama | FREE |
| Gemini free tier | FREE |
| GPT-4o | ~$0.05 - $0.15 |
| Claude Sonnet | ~$0.03 - $0.10 |
Swarm is designed to be cost-efficient. Most users pay nothing.
output/your-project/
├── README.md ← viral-worthy, AI-written
├── requirements.txt ← actual dependencies
├── Dockerfile ← production ready
├── app/
│ ├── main.py ← working FastAPI app
│ └── service.py ← business logic
├── tests/
│ └── test_app.py ← real tests
└── .gitignore
Most AI coding tools feel like autocomplete on steroids. Swarm moves differently.
You do not prompt one assistant. You deploy a team.
The Architect draws system boundaries first. The Backend challenges over-engineered design decisions. The Frontend protects clean API contracts. The Tester catches bugs before production sees them. The Docs agent records what ships. The PM changes requirements mid-build.
They communicate. They argue. They resolve. They ship. You watch.
- 6-agent multi-agent build system
- Real-time cinematic terminal dashboard
- GitHub Models API (free with Copilot Pro)
- SQLite build memory and persistence
- Cinematic boot sequence and animations
- Multi-LLM support (Claude, Gemini, Groq, Ollama, OpenAI)
- Intelligent Architect with real system design authority
- Production-grade Backend with task-specific code generation
- God-tier Frontend with first-principles UI generation
- World-class Tester that actually runs and verifies code
- Stripe-level Docs that reads actual code
- PM with real PRD and ship decision authority
- Cost tracking per LLM call
- Provider health check on startup
- Web UI dashboard (browser-based)
- Custom agent personalities via config
Swarm is early. Join us and build real developer superpowers.
- Build magical AI collaboration workflows.
- Craft sharper terminal UI moments.
- Ship open-source tools that work on day one.
How to contribute:
- Fork the repo.
- Create your feature branch.
- Build something legendary.
- Open a PR with clear intent.
We review PRs within 48 hours.
If Swarm blew your mind: → ⭐ Star it → 🐦 Tweet it: "Watched 6 AI agents argue and ship software." → Share it on LinkedIn, Reddit r/programming, HN
🐝 Swarm — because one AI is never enough
If this blew your mind, star the repo. It takes 1 second.