v0.1.0-alpha  ·  open source  ·  MIT

Understand
any GitHub repo
instantly.

Paste any repository URL — get back a full breakdown of purpose, architecture, key files, dependencies, and a contribution guide. Built for developers, by developers. No config, 0 setup.

$ reposage
try: vercel/next.js  ·  tiangolo/fastapi  ·  torvalds/linux
Python 3.11 Next.js 14 FastAPI PostgreSQL Redis MIT License Self-hostable
reposage — bash — 80×28
dantechdevs:~/projects$ reposage explain vercel/next.js
fetching repository context...
analyzing 2,847 files & 14 languages...
building context graph...
## purpose
React framework for production-grade web apps.
Supports SSR, SSG, ISR, and App Router (RSC).
## key files
packages/next/src/ core runtime critical
turbopack/crates/ Rust bundler new
examples/ 70+ starter templates
## stack
TypeScript · Rust · React · Node.js · SWC
shareable → reposage.dev/vercel/next.js
dantechdevs:~/projects$
~30s
average analysis time
6 layers
of context extracted
100%
open source & free
0 config
required to start
features

Everything you need to grok any codebase

From high-level purpose to contribution guide — RepoSage reads the repo so you don't waste hours cloning and grepping around.

01
🏗️
Architecture summary
Understand the project's purpose, patterns, and folder structure in plain language. No assumptions.
02
🗂️
Key file mapping
Pinpoints the 5–10 most critical files and explains exactly what each one does and why it matters.
03
📦
Dependency analysis
Full tech stack breakdown — every framework, lib, and tool explained in plain terms, not docs links.
04
🤝
Contributor guide
Auto-generates a contribution guide from the actual repo structure, conventions, and commit history.
05
💬
Repo chat
"Where is auth handled?" "How do I add an endpoint?" Ask anything. Get precise, contextual answers.
06
🔗
Shareable links
Every breakdown gets a permanent URL. Drop it in PRs, Slack, or onboarding docs.
tech stack

Built with serious tools

Python + FastAPI on the backend, Next.js on the front. GitHub API for repo context, PostgreSQL for caching, Redis for async jobs. Designed to be self-hosted in a single docker-compose up.

toolversionlayer
⚡ Next.js14frontend
🐍 Python + FastAPI3.11 / 0.110backend
🐘 PostgreSQL16storage
🔴 Redis + Celery7queue
🐙 GitHub APIv3 / v4data
🚀 Vercel + Railway—deploy
backend/services/explainer.py 
async def explain_repo(repo_url: str):
    # 1. extract context from GitHub API
    context = await fetch_repo_context(
        repo_url,
        files=["README.md", "pyproject.toml"],
        include_tree=True,
        recent_commits=10,
    )

    # 2. build structured prompt
    prompt = build_explainer_prompt(context)

    # 3. stream response → SSE → browser
    async with client.messages.stream(
        messages=[{
            "role": "user",
            "content": prompt,
        }]
    ) as s:
        async for chunk in s.text_stream:
            yield chunk
how_it_works

From URL to insight in four steps

RepoSage pulls GitHub context and generates a structured breakdown — streamed live to your browser in under 30 seconds.

01
Paste a GitHub URL
Any public repo. Any language. Any size. No authentication needed. Just drop the URL and hit enter.
02
Context extraction
RepoSage fetches README, file tree, config files, detected languages, and recent commits via the GitHub API.
03
Analysis & breakdown
Generates structured output: purpose, architecture, key files, dependency graph, and contribution guide. Streamed live.
04
Explore & share
Ask follow-up questions, dive deeper into any section, and share the permanent link with your team or in your PR.
// open source
Build it with us.

RepoSage is open source and actively looking for contributors. Python backend, TypeScript frontend, docs, tests — all help is welcome. Check the good-first-issue label to get started.

★ Star on GitHub Read the docs →