Understand any codebase
without reading code

AI-powered documentation that turns complex repositories into beginner-friendly learning guides. Built for PMs and AI-native builders.

$ pip install code-guro
Star on GitHub

Beautiful documentation, generated in minutes

Structured guides covering everything from architecture to code quality — no manual writing required.

code-guro-output/html/00-overview.html

Everything you need to understand a codebase

Multi-Part Curriculum

From high-level overview to deep-dive analysis, get a complete picture organized the way you'd want to learn it.

Framework Detection

Automatically recognizes Next.js, React, Vue, Django, Flask, Express, Rails, and more for context-aware analysis.

Interactive Q&A

Ask follow-up questions in an interactive session to dig deeper into any part of the codebase.

Cost Estimation

Know exactly what an analysis will cost before you run it. Transparent token counting across all providers.

Four steps. Full understanding.

1

Install

One command to get started.

pip install code-guro
2

Configure

Set up your LLM provider.

code-guro configure
3

Analyze

Point it at any repository.

code-guro analyze
4

Learn

Open the generated HTML docs and explore at your own pace.

Choose your LLM

Works with the providers you already use.

Anthropic
OpenAI
Google

Frequently Asked Questions

Do I need to know how to code to use Code Guro?

Not at all. Code Guro is built for people who don't read code fluently. Just install it with pip install code-guro, run the setup wizard, and point it at your project. It generates a structured, beginner-friendly curriculum that explains your codebase in plain language — no programming knowledge required.

Which AI provider should I choose?

Code Guro supports LLMs from Anthropic, OpenAI, and Google. Claude is recommended for the best code understanding. Gemini is the most cost-effective option at a fraction of the price. You can switch providers anytime by running code-guro configure.

How much does it cost?

Code Guro itself is free and open source. You only pay for the AI API calls. A small project (10–50 files) typically costs $0.05–$0.30, while a large project (200+ files) may cost $1–$5. Code Guro always shows you an estimated cost before running and asks for confirmation if it exceeds $1.

What kind of output do I get?

You get a 7-part learning guide covering everything from a high-level overview to deep dives into core files. Output comes in both HTML (with navigation sidebar, dark mode, and diagrams) and Markdown formats. Think of it as a personalized course built around your specific codebase.

Can I analyze a GitHub repository I don't have locally?

Yes! Just pass a public GitHub URL directly: code-guro analyze https://github.com/user/repo. Code Guro will clone it and generate the documentation for you.