Autonomous Full-Stack App Builder
Scaffold premium, containerized full-stack applications at the speed of thought.
AgentForge is an advanced CLI orchestrator explicitly designed for Senior Engineers, Vibe Coders, and architectural designers. Rather than spending hours manually wiring up Next.js to FastAPI, debugging Docker Compose networking, and fighting with GitHub Actions boilerplate—AgentForge handles it entirely in seconds.
Simply provide a short natural language idea, and AgentForge will instantly scaffold a complete web application—complete with strict TypeScript frontends, high-performance backends, full CI/CD deployment pipelines, and optional LLM-refined documentation.
- ⚡ Instant Scaffolding: Generate premium, production-ready
SaaS,Landing+API, orRealtimeproject templates instantly. - 🐳 Zero-Config Previews: The built-in
agentforge preview .command cleanly manages backgrounddocker-composeorchestration locally. - 🧠 Optional LLM Vibe Pass: If an
OPENROUTER_API_KEYis present, AgentForge automatically refines the generated project docs and internal configuration using powerful free models (e.g.,arcee-ai/trinity-large-preview:free) to strictly match your unique idea. - 🛡️ Clean Architecture: Emitting only modern, strict-typed boilerplate (
Next.js 14,FastAPI,Zod,Socket.io,Express). - 🌐 Vercel-Ready: Native
vercel.jsonedge routing injected automatically to prevent 404 deployment drops.
npm install -g agentforgeIf you prefer not to install globally, you can execute it dynamically:
npx agentforge create "My awesome idea"git clone https://github.com/shenald-dev/agentforge.git
cd agentforge
npm install
npm run build
npm linkagentforge create "A high conversion real estate landing page"The interactive CLI will guide you through picking a template and generating the boilerplate.
Navigate to your new project and let AgentForge orchestrate the isolated Docker environment:
cd my-new-app
agentforge preview .- Frontend Container mapped to
http://localhost:3000 - Backend API/Socket Container mapped to
http://localhost:8000
AgentForge ships with three distinct boilerplate engines designed for different product architectures.
Best for: Complex web applications requiring user state, database interactions, and heavy backend processing.
- Frontend: Next.js 14 App Router, React 18, Tailwind CSS, Lucide Icons.
- Backend: Python FastAPI, strictly typed Pydantic models, uvicorn high-performance server.
- Infrastructure: Isolated multi-container
docker-compose.yml.
Best for: Marketing sites, micro-startups, and lightweight API wrappers.
- Frontend: Next.js 14 App Router optimized for static/edge delivery.
- Backend: Lightweight Node.js Express server + CORS middleware via TypeScript.
- Infrastructure: Multi-container docker stack.
Best for: Chat apps, live-dashboards, multiplayer games.
- Frontend: Next.js 14 connected natively to Socket.io client instances.
- Backend: Node.js WebSocket engine using
socket.io. - Infrastructure: Dockerized WS pass-through architecture.
AgentForge uses a dynamic, modular Template Manager hooked into Handlebars compilation.
- The CLI Orchestrator:
Commandertraps the user input and extracts the natural language intent. - The Generator Core: The system recursively parses the selected embedded template directory (
/templates). - Token Injection: Variables like
{{projectName}}and{{author}}are dynamically injected into file names and file contents (e.g.package.json.hbs,main.py.hbs). - Vercel Overrides: A
vercel.jsonfile is enforced instructing edge platforms on how to natively route the output Next.js applications safely without user intervention.
AgentForge includes an optional AI Enhancement Pass. It uses Langchain under the hood to ingest your text and manipulate the Handlebars parsing logic in real-time to generate a custom README.md perfectly matching your prompt's intent.
To enable this, we use the OpenRouter API, allowing us to tap into hundreds of models (including completely free tiers).
Export your OpenRouter key:
# Windows (PowerShell)
$env:OPENROUTER_API_KEY="sk-or-v1-..."
# Linux / MacOS
export OPENROUTER_API_KEY="sk-or-v1-..."agentforge create "A minimalistic deep-work pomodoro timer focusing on flow state"AgentForge natively detects the API key, bridges into the LLMOptimizer singleton, and connects to the arcee-ai/trinity-large-preview:free model. The resulting project documentation will be specifically rewritten as a Pomodoro application instead of generic boilerplate.
Q: My Vercel deployment is returning a 404 NOT FOUND error?
A: This usually happens if the project wasn't detected as Next.js. AgentForge handles this automatically now, but ensure the vercel.json file generated in the frontend folder explicitly states "framework": "nextjs".
Q: Docker compose is failing to bind ports?
A: Ensure you don't have other services running locally on 3000 or 8000. You can edit the docker-compose.yml natively mapped ports to bypass this.
Q: The CLI crashes missing Handlebars files?
A: Ensure you are running npm run build if building from source. The dist directory must contain the compiled JavaScript and the copied templates directory.
Want to add a brilliant new Template to the Forge? Let's flow! Check out the CONTRIBUTING.md guide.
- 🐛 Found a bug? Open an issue to let us know.
- ✨ Have a feature idea? We are open to PRs! Just make sure to run
npm run testandnpm run lint. - 🎨 Documentation tweaks? Always welcome!
Built by a Vibe Coder. Forget the config, just build.