MCPcopy Index your code
hub / github.com/antarixxx/gitsummarize

github.com/antarixxx/gitsummarize @main

Chat with this repo
repository ↗ · DeepWiki ↗ · + Follow
156 symbols 471 edges 61 files 4 documented · 3%
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

🧠 GitSummarize

Image

Generate beautiful, world-class documentation from any GitHub repository — instantly.

Just replace hub with summarize in any GitHub URL to generate a live, interactive documentation hub.

https://gitsummarize.com/


🚀 Features

GitSummarize analyzes any GitHub repo (public or private) and generates:

  • 📄 System-level architecture overviews
  • 📁 Per-directory and file summaries
  • 🧠 Natural language descriptions of purpose, flow, and structure
  • 🔗 Business Logic and Rules Extraction
  • 📊 Architecture diagrams and flows

It’s perfect for onboarding, exploring unfamiliar codebases, and writing technical documentation — all powered by Gemini.


🧰 Tech Stack

Area Stack
Frontend Next.js, TypeScript, Tailwind CSS, ShadCN
Backend FastAPI, Python, Server Actions
Database PostgreSQL (Supabase)
AI Gemini 2.5 Pro
Analytics PostHog
Hosting Vercel (Frontend), Render (Backend)

🤔 Why GitSummarize?

We wanted to contribute to open-source projects but found it difficult to understand massive codebases quickly.

GitSummarize automates the hardest part: figuring out what the code does and how it's structured — giving you useful documentation and high level overview of the codebase.


🧪 Local Development / Self-Hosting

  1. Clone the repo bash git clone https://github.com/antarixxx/gitsummarize cd gitsummarize

  2. Run the Next.js Project bash npm run dev

    You can now access the website at localhost:3000.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Acknowledgements

Shoutout to GitIngest and GitDiagram for the inspiration and styling.

📈 Rate Limits

We are currently hosting it for free with rate limits though this is somewhat likely to change in the future based on Gemini's API policies.

🤔 Future Steps

  • Expand documentation to cover more topics (Setup, Onboarding Guide)
  • Add Architecture Diagrams

Star History

Star History Chart

Extension points exported contracts — how you extend this code

CopyButtonProps (Interface)
(no doc)
frontend/src/components/copy-button.tsx
ApiKeyDialogProps (Interface)
(no doc)
frontend/src/components/api-key-dialog.tsx
MermaidChartProps (Interface)
(no doc)
frontend/src/components/mermaid-diagram.tsx
MainCardProps (Interface)
(no doc)
frontend/src/components/main-card.tsx
CustomizationDropdownProps (Interface)
(no doc)
frontend/src/components/customization-dropdown.tsx

Core symbols most depended-on inside this repo

cn
called by 19
frontend/src/lib/utils.ts
_truncate_text
called by 4
backend/src/gitsummarize/clients/ai_client_abc.py
upsert_repo_metadata
called by 3
backend/src/gitsummarize/clients/supabase.py
get_repo_metadata_from_url
called by 3
backend/src/gitsummarize/clients/github.py
_parse_gh_url
called by 3
backend/src/gitsummarize/clients/github.py
handleDropdownToggle
called by 2
frontend/src/components/main-card.tsx
getStepNumber
called by 2
frontend/src/components/loading.tsx
shouldShowReasoning
called by 2
frontend/src/components/loading.tsx

Shape

Function 82
Method 42
Interface 15
Class 14
Route 3

Languages

TypeScript56%
Python44%

Modules by API surface

frontend/src/app/[username]/[repo]/page.tsx19 symbols
backend/src/gitsummarize/clients/github.py19 symbols
backend/app.py9 symbols
frontend/src/components/loading.tsx8 symbols
backend/src/gitsummarize/exceptions/exceptions.py8 symbols
frontend/src/app/page.tsx6 symbols
backend/src/gitsummarize/clients/supabase.py6 symbols
backend/src/gitsummarize/clients/openai.py6 symbols
backend/src/gitsummarize/clients/google_genai.py6 symbols
frontend/src/components/main-card.tsx5 symbols
backend/src/gitsummarize/auth/key_manager.py5 symbols
frontend/src/components/private-repos-dialog.tsx4 symbols

For agents

$ claude mcp add gitsummarize \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact