Why it matters
- 11K+ GitHub stars and influential position in AI agent history — inspired GPT Engineer, Devika, and a generation of AI developer tools.
- 200-line implementation makes the AI developer pattern transparent and educational — understand exactly how these agents work.
- Created by Swyx (one of the most influential developers in the AI space) with clear documentation on the AI developer concept.
- Demonstrates that simple agents can generate working code — the core insight that fueled the entire AI coding agent category.
Key capabilities
- Spec-to-codebase: Generate complete multi-file codebases from a natural language specification.
- File planning: First generates the list of files to create, then generates each file individually.
- Minimal implementation: ~200 lines of Python — readable, modifiable, educational.
- Multiple LLMs: Works with GPT-4o, GPT-3.5, and can be adapted for Claude or other APIs.
- Open source: MIT license; fork and customize for your own agent experiments.
- Human debugger mode: Option to pause after each file for human review.
Technical notes
- License: MIT (open source)
- GitHub: github.com/smol-ai/developer (11K+ stars)
- Install:
git clone+pip install -r requirements.txt - Models: GPT-4o, GPT-4, GPT-3.5-Turbo (via OpenAI API key)
- Python: 3.8+
- Created by: Swyx (shawn swyx wang); AI engineer and writer
Ideal for
- Developers learning how AI coding agents work — the minimal implementation is the best educational resource on the concept.
- Rapid scaffolding of simple projects — landing pages, REST APIs, scripts — where the spec is clear.
- Researchers and engineers who want to fork and experiment with AI developer agent architectures.
Not ideal for
- Complex production applications where generated code needs to be deployment-ready without significant editing.
- Non-Python developers who need a more polished UI — Bolt.new or GPT Engineer have better interfaces.
- Teams who need reliability and reproducibility — Smol Developer is a research tool, not a production system.
See also
- GPT Engineer — More polished spec-to-codebase agent with interactive clarification.
- Devika — More capable autonomous agent with web browsing and debugging.
- Bolt.new — Browser-based full-stack generation with live preview.