Generate comprehensive documentation, Dockerfiles, and Docker Compose configs from any GitHub repository using AI agents.

• 🤖 AI Agentic Loop - Uses LangChain tools to explore repositories and generate context-aware documentation
• 🔍 Smart Exploration - Automatically finds key files (README, configs, requirements, source code)
• 📡 Real-time Progress - SSE streaming shows live progress as documentation is generated
• 🐳 Multi-type Generation - Supports documentation, Dockerfiles, and Docker Compose files
• 💾 Generation History - All generations are stored and accessible
• 🌐 Free Models - Runs on OpenRouter's free tier models

# Clone the repo
git clone https://github.com/Jai0401/docAgent.git
cd docAgent

# Set your API key
export OPENROUTER_API_KEY=your_key_here

# Start everything
docker-compose up

Frontend: http://localhost:5173
Backend API: http://localhost:8000

Backend:

cd backend
pip install -r requirements.txt
export OPENROUTER_API_KEY=your_key_here
uvicorn main:app --reload --port 8000

Frontend:

cd frontend
npm install
npm run dev

# Generate documentation
curl -X POST http://localhost:8000/generate \
  -H "Content-Type: application/json" \
  -d '{"url": "https://github.com/facebook/react", "generation_type": "docs"}'

# Stream progress
curl http://localhost:8000/stream/1

# Get result
curl http://localhost:8000/result/1

docAgent/
├── backend/
│   ├── main.py           # FastAPI app + endpoints
│   ├── db.py             # SQLite operations
│   ├── agent/
│   │   ├── loop.py       # Main agent loop
│   │   ├── tools.py      # LangChain tools
│   │   └── prompts.py    # System prompts
│   └── services/
│       ├── openrouter_service.py  # LLM client
│       └── git_service.py         # Git operations
├── frontend/              # React app
│   ├── src/App.jsx       # Main component
│   └── ...
├── Dockerfile
├── docker-compose.yml
└── README.md

1. Clone - Repository is cloned to /tmp/docsmith_repos/{id}/
2. Explore - Agent uses glob, read_file, grep tools to analyze project structure
3. Generate - LLM generates docs based on actual file contents
4. Save - Output saved as OUTPUT.md in the cloned repo directory

MIT © Jaimin Godhani