This project is an AI-powered coding agent that can plan, architect, and generate complete software projects from a single natural language prompt.
The agent follows a multi-step workflow:
- Planner β Understands the user request and creates a structured project plan
- Architect β Breaks the plan into concrete implementation tasks
- Coder β Writes full, production-ready code files step by step
- Generates complete frontend projects from a single prompt
- Supports calculator, todo apps, and generic web apps
- Multi-agent workflow using LangGraph
- Uses Groq GPT-OSS-120B for fast inference
- Automatically creates folders and files
- Generates HTML/CSS/JS or React + Vite projects
- Python
- LangGraph
- LangChain
- Groq API
- Pydantic
- Vite + React (for generated projects)
agent/
graph.py # LangGraph workflow (planner β architect β coder)
prompts.py # Prompt templates
states.py # Pydantic state models
tools.py # File system tools
generated_project/
index.html / src/
styles.css
script.js / React components
README.md
2. Create .env file
GROQ_API_KEY=your_api_key_here
3. Run the agent
python main.py
Example prompt:
Build a simple todo web app
The generated project will be created inside the generated_project/ folder.