Describe it. Nova builds it.
Open-source agent orchestration framework powered by Amazon Nova. Multi-agent parallel builds, quality gates, live preview & one-command deploy.
Ask Nova
Nova knows the entire framework. Ask about models, benchmarks, architecture, or how to build your project.
Try asking about:
- Nova Lite vs Pro vs Premier
- Benchmark scores & grading
- 11 agent formations
- 3-tier prompt system
- Autonomy levels (A0-A5)
- Circuit breaker & self-correction
- Deploying to production
- The Python API
Models
Switch models with /model <alias>. Same pipeline, different brain.
Benchmark Results CUSTOM SUITE
Nova Forge's own benchmark suite: 4 scenarios from Easy to Nightmare. 25+ automated verification checks per run including HTTP endpoint testing, code quality analysis, and interface fidelity scoring. View source →
Expense Tracker — 5 tasks, 5 files, Flask + SQLite
Kanban Board — 7 tasks, 7 files, auth + 3 tables + status machine HARD
nova-lite
32K
Fast and affordable. Great for learning and quick tasks. Best with focused, single-file builds.
nova-pro
300K
Strong all-rounder. Handles complex coding tasks and reads large codebases. Good balance of capability and cost.
nova-premier
1M
Most powerful Nova model. Best for complex multi-file projects and deep reasoning.
How It Works
A multi-agent pipeline from natural language to deployed application.
Interview
Plan & Decompose
Parallel Build
Gate Review
Preview & Deploy
Formations
Pre-configured multi-agent team layouts. Set with /formation <name>. Nova auto-selects based on your project.
feature-impl
RecommendedAdding features to an existing project. Backend and frontend work in parallel, then integrator, then tester.
/formation feature-implnew-project
Greenfield project setup. Architect output unblocks implementers. Team lead reviews architecture first.
/formation new-projectsingle-file
Small, focused file edits. 1-3 tasks, single file. Quick fixes and config changes.
/formation single-filelightweight-feature
Small, single-layer features (frontend-only OR backend-only). Implementer and tester in parallel.
/formation lightweight-featurebug-investigation
Root cause unknown. Three parallel investigators with distinct strategies. First to find root cause creates fix.
/formation bug-investigationsecurity-review
Security audit and threat modeling. Scanner and modeler in parallel, then fixer for critical findings.
/formation security-reviewperf-optimization
Performance profiling and optimization. Sequential deep single-expert work with regression testing.
/formation perf-optimizationcode-review
PR review and quality assessment. Three reviewers (security, performance, coverage) in parallel. Read-only.
/formation code-reviewrecovery
NewPost-failure diagnosis. Investigator traces root cause, fixer applies the fix, validator confirms it works.
/formation recoveryall-hands-planning
NewSpec review with 4 parallel reviewers (architecture, feasibility, security, UX) then synthesizer combines findings.
/formation all-hands-planningintegration-check
NewPost-build cross-file verification. Auditor checks references, fixer repairs mismatches, verifier confirms.
/formation integration-checkQuick Start
Three commands to your first AI-powered build.
Clone & Setup
git clone https://github.com/herakles-dev/nova-forge.git && cd nova-forge && python3 -m venv .venv && source .venv/bin/activate && pip install -r requirements.txt
Configure AWS
export AWS_ACCESS_KEY_ID=... AWS_SECRET_ACCESS_KEY=... AWS_DEFAULT_REGION=us-east-1
Build Something
python3 forge_cli.py
Describe what you want. Nova plans, builds, reviews, and deploys it.
Try It
Copy a prompt directly into the CLI. Each one generates a complete, working project.
Personal Finance App
Auth, categories, charts, CSV export, budget alerts
Kanban Board
Auth, 4 columns, priorities, assignees, project stats, 3 tables
Link Shortener
Short codes, click analytics, QR codes, password protection
Markdown Notes
Folders, live preview, tags, search, keyboard shortcuts
Recipe Book API
Auth, CRUD, ingredient search, ratings, card grid UI
Habit Tracker
Streaks, calendar heatmap, categories, weekly summary
Autonomy System
Six trust levels control what Nova can do without asking. Set with /autonomy <0-5>.
| Read | Write | Bash | Deploy | Delete | ||
|---|---|---|---|---|---|---|
| A0 Manual | · | · | · | · | · | ask for all |
| A1 Guided | ✓ | · | · | · | · | |
| A2 Supervised Default | ✓ | ✓ | ~ | · | · | |
| A3 Trusted | ✓ | ✓ | ✓ | ~ | · | |
| A4 Autonomous | ✓ | ✓ | ✓ | ✓ | ~ | explicit opt-in |
| A5 Unattended | ✓ | ✓ | ✓ | ✓ | ✓ | full audit |
CLI Commands
Interactive shell commands. Launch with python3 forge_cli.py or the forge command.
/interview | Start guided project setup (scope, stack, risk, formation, model) | |
/plan | Generate task plan from spec.md | |
/build | Execute all pending tasks with AI agents | |
/status | View current build progress and task states | |
/tasks | List all tasks with status, wave, and dependencies | |
/preview | Launch dev server with shareable Cloudflare Tunnel URL (auto-retry) | |
/deploy | Production deployment (Docker + nginx + SSL) | |
/health | System health dashboard — preview, model, project, disk | |
/competition | Hackathon submission readiness validator (8 checks) |
/build --no-review | Skip the gate review step | |
/build --no-verify | Skip runtime verification | |
/guide | Interactive project wizard (skill level + all steps) | |
/resume | Resume a previous session | |
/new <name> | Create a new project directory | |
/audit | View JSONL audit trail of all builds | |
/preview stop | Stop the preview server |
/model <alias> | Switch the active model (e.g., nova-lite, nova-pro) | |
/models | Compare all models — cost, context, strengths | |
/formation <name> | View or set agent formation | |
/autonomy <0-5> | Set agent autonomy level (A0-A5) | |
/login | Set up or change API provider credentials | |
/config | View or modify all settings | |
/cd <path> | Change project directory |
forge plan "desc" | Plan a project from the command line | |
forge build | Execute the plan with AI agents | |
forge deploy | Deploy to production | |
forge preview | Launch preview with tunnel | |
forge status | View build status | |
forge models | List all models | |
forge chat | Launch interactive shell |
Programmatic API
Use Nova Forge as a library, not just a CLI.
from config import get_model_config
from forge_agent import ForgeAgent
# Create a build agent with Nova Lite
model = get_model_config("nova-lite")
agent = ForgeAgent(
model_config=model,
project_root="./my-project",
max_turns=30,
)
# Run a task
result = await agent.run(
prompt="Create a Flask REST API with /health endpoint",
system="You are a Python developer. Write working code.",
)
print(result.output)
print(result.artifacts) # {"app.py": {"action": "write", "size": 1024}}
Web API Endpoints
GET /api/info | Project metadata, models, formations, tools |
POST /api/docs/chat | Ask questions about Nova Forge (powered by Nova) |
GET /health | Health check |
Built with Nova Forge
7 games across 3 model tiers — each built in a single session, zero human code. Expand any card to see the exact prompt, model settings, and build stats. View all demos →
Nova Invaders
View build proof & prompt
Breakout
View build proof & prompt
Asteroid Forge
View build proof & prompt
Gravity Wells
View build proof & prompt
App Demos — full-stack benchmarks
Expense Tracker S
Full-stack expense manager — categories, charts, CSV export. The official benchmark scenario.
Kanban Board A
Auth, 3 tables, kanban columns — tested across all 3 Nova models.
Todo App S
FastAPI + SQLite task manager with priorities and filters.