README.md

Coder Buddy

An AI-powered coding assistant built with LangGraph

Transform natural language into complete, working projects - file by file - using real developer workflows.

---

Architecture

Coder Buddy operates as a three-agent pipeline - each agent specializing in a distinct phase of software development:

 ┌─────────────────┐     ┌──────────────────┐     ┌─────────────────┐
 │  Planner Agent  │ ──▶ │ Architect Agent  │ ──▶ │   Coder Agent   │
 │                 │     │                  │     │                 │
 │ Analyzes your   │     │ Breaks plan into │     │ Implements each │
 │ request &       │     │ engineering tasks│     │ task & writes   │
 │ generates a     │     │ with explicit    │     │ directly into   │
 │ project plan    │     │ file context     │     │ files           │
 └─────────────────┘     └──────────────────┘     └─────────────────┘

---

Getting Started

Prerequisites

Before you begin, make sure you have:

• uv - a fast Python package manager. Install it here.
• Groq API Key - create a free account and generate your key here.

Installation & Startup

1. Create and activate a virtual environment

uv venv
source .venv/bin/activate

2. Install dependencies

uv pip install -r pyproject.toml

3. Configure environment variables

cp .env.example .env
# Fill in the required values in .env

4. Start the application

python main.py

or test with this command to create a calculator web app :

python agent/graph.py

---

Example Prompts

Try these to get started:

💡 "Create a to-do list application using HTML, CSS, and JavaScript."

💡 "Create a simple calculator web application."

💡 "Create a simple blog API in FastAPI with a SQLite database."

---