Next.js app that takes a public or private GitHub repository and generates a Mermaid architecture diagram with a streamed explanation. Components link to files and directories in the repo, and diagrams export as PNG or Mermaid source. It also exposes a remote MCP server at gitdiagram.com/mcp and a Markdown version of each diagram, and can generate narrated explainer videos.
Who it is for: Developers who want quick architecture overviews of unfamiliar repos
Strengths
Hosted instance and MCP server need no key or sign-in
Diagram nodes link to the repo's files and directories
Exports PNG or Mermaid source; Markdown view at /owner/repo.md
Private repos supported with a GitHub token
Weaknesses
Self-hosting needs Cloudflare R2, Upstash Redis and an OpenAI or OpenRouter key
Creating new explainer videos is early access and off by default locally
Local video generation needs Anthropic, OpenAI and OpenRouter keys
MCP server only covers public repositories
What it needs
no GPU
Docker
Needs Bun, Cloudflare R2, Upstash Redis, OpenAI or OpenRouter API key, Anthropic API key (videos)
Models: OpenAI, OpenRouter, Anthropic Claude (videos)
port 3000
Quick answers
Is gitdiagram open source?
Yes. Its code is on GitHub under the MIT license.
Can you run gitdiagram with Docker?
Yes. Its repository has a Docker setup: a Dockerfile, a Compose file or a published image.