¿Qué es GitDiagram?
GitDiagram es una aplicación web y un proyecto Next.js de código abierto de Ahmed Khaleel que convierte un repositorio de GitHub en un diagrama de arquitectura interactivo. Un modelo de IA lee el árbol de archivos del repositorio, su README y hasta 12 archivos de código fuente, escribe un breve resumen y después devuelve un grafo de 34 componentes agrupados como máximo, con conexiones etiquetadas. Cada ruta enlazada se comprueba contra el árbol real antes de compilar el grafo a Mermaid, y cada componente abre su archivo o carpeta en GitHub.
Los diagramas se guardan y se comparten, así que un repositorio que alguien ya ha diagramado se abre al instante. El sitio también crea vídeos explicativos narrados de alrededor de un minuto, exporta PNG o el código Mermaid, ofrece una versión en Markdown de cada diagrama guardado en gitdiagram.com/owner/repo.md y mantiene un servidor MCP remoto, gratuito y de solo lectura en gitdiagram.com/mcp. Los repositorios privados funcionan con un token de GitHub de solo lectura.
El repositorio se creó en diciembre de 2024, tiene licencia MIT y cuenta con unas 18.700 estrellas en GitHub y 1.430 forks. No publica releases etiquetadas; el último commit fue el 30 de octubre de 2026.
¿Merece la pena GitDiagram?
El valor de GitDiagram está en un flujo sin pasos: sin clonar, sin instalar, sin clave para la mayoría de usos y con un enlace para compartir al final. El proceso que hay detrás es más cuidadoso de lo que sugiere el truco de la URL. Según la documentación de arquitectura, una sola petición a GPT-6 Luna con razonamiento bajo emite en streaming un resumen y un grafo estricto; el servidor comprueba identificadores, conectividad y cada ruta enlazada contra el repositorio real, reintenta la salida no válida con indicaciones, y un compilador determinista, no el modelo, escribe el Mermaid. Después el navegador sanea el SVG y solo permite enlaces a GitHub. Eso hace que los enlaces sean fiables incluso cuando el dibujo no lo es.
El techo viene de serie. El modelo ve un extracto acotado del árbol, el README y como mucho 12 archivos de código, y no dibuja más de 34 componentes. Para una biblioteca pequeña es suficiente; para un monorepo con decenas de servicios significa una imagen gruesa en la que paquetes enteros se reducen a una caja, y la propia guía del proyecto lo llama un mapa de las partes importantes, no un grafo de dependencias completo. Los repositorios muy grandes que GitHub devuelve como árbol truncado siguen recibiendo un diagrama a partir de un listado parcial, y un README demasiado grande se rechaza de entrada. Un diagrama guardado además congela el repositorio tal como estaba; Regenerate crea uno nuevo.
El tratamiento de datos del sitio alojado está documentado con claridad en su política de privacidad. El contenido del repositorio va a OpenAI, Anthropic y OpenRouter para crear lo que pediste. Los repositorios privados necesitan un token fine-grained con Contents de solo lectura, o un inicio de sesión con Continue with GitHub limitado a los repositorios que elijas; el token se guarda en una cookie HttpOnly hasta 30 días y nunca se almacena en el servidor, y los diagramas privados viven en un espacio de nombres aparte. En el sitio funcionan las grabaciones de sesión de PostHog, con lo que se teclea enmascarado. El README y la versión en Markdown llevan espacios de patrocinio de pago, CodeRabbit en el momento de escribir esto.
Los vídeos son la parte cara y se racionan en consecuencia. Claude Opus escribe el guion, Claude Haiku 5.5 diseña las escenas, Gemini 3.8 Flash TTS a través de OpenRouter lo lee y whisper-1 sincroniza las palabras; los límites por defecto son un vídeo nuevo por navegador y 25 en todo el sitio por día UTC, con $3 por uno adicional. Frente a DeepWiki, que escribe una wiki de varias páginas con chat, GitDiagram responde una pregunta más estrecha y más rápido, y un agente de programación en tu propia copia local dibujará un diagrama más exacto de código privado o sin confirmar.
Dónde se gana su sitio
Una ingeniera de backend que evalúa tres bibliotecas de colas de trabajos de código abierto
Ver cómo está montada cada una antes de leer código
Cambia 'hub' por 'diagram' en cada URL de GitHub; los diagramas guardados se abren al instante y los nuevos tardan alrededor de un minuto. Haz clic en un componente para saltar a su carpeta. Gratis dentro del límite diario; pasado ese límite, paga tu propia clave de OpenAI.
Un desarrollador que usa Claude Code o Codex en una tarea que toca una dependencia desconocida
Darle al agente la estructura de la dependencia sin pegar su código
Añade el servidor MCP remoto con un comando y pregunta al agente cómo está estructurado el proyecto; lee el resumen guardado, los componentes, las conexiones y el código Mermaid. Gratis, limitado por defecto a 120 llamadas a herramientas por hora y red, y solo para repositorios públicos.
Una responsable de relaciones con desarrolladores en una empresa de código abierto de 20 personas
Poner una imagen de la arquitectura y un vídeo explicativo breve en el README del proyecto
Exporta el diagrama como PNG o copia el código Mermaid como primer borrador para editar, y descarga el vídeo explicativo en MP4 horizontal o 9:16 con subtítulos incrustados. Un vídeo que supera la cuota gratuita diaria cuesta $3.
Antes de decidirte
- Puesta en marcha
- Alojado: edita la URL o pega owner/repo en la página de inicio; alrededor de un minuto para un diagrama nuevo. Autoalojado: Bun 1.3.14 y Node 22, bun install, y después rellena .env con buckets de Cloudflare R2, Upstash Redis, CACHE_KEY_SECRET y una clave de OpenAI u OpenRouter antes de bun run dev.
- Integraciones
- Servidor MCP remoto (get_repository_diagram, find_repository_diagrams, get_explainer_video) para Claude, Claude Code, Codex, Cursor, VS Code, Gemini CLI, GitHub Copilot CLI y ChatGPT; un plugin de Claude Code con una skill /gitdiagram; Markdown en /owner/repo.md; exportación a PNG y Mermaid.
- Datos y privacidad
- Los diagramas y vídeos de repositorios públicos se publican para cualquiera que abra el repositorio. El contenido del repositorio va a OpenAI, Anthropic y OpenRouter. Los tokens de GitHub y las claves de OpenAI se quedan en una cookie HttpOnly del navegador hasta 30 días, nunca en el servidor; el token recomendado es fine-grained con Contents de solo lectura. En el sitio funcionan la analítica y las grabaciones de sesión de PostHog. Licencia MIT.
- Coste a escala
- El sitio alojado no tiene suscripción. Autoalojarlo supone pagar R2, Upstash y los tokens del modelo por diagrama; el proyecto no publica un coste por diagrama, aunque la aplicación muestra una estimación antes de cada ejecución y un carril Fast opcional duplica el precio del modelo. Los vídeos añaden llamadas a Anthropic, OpenAI y OpenRouter, además de renders con Chromium sin interfaz.
- Límites
- Los valores por defecto del código permiten 8 generaciones pagadas por el servidor por IP y hora (quien usa su propia clave queda exento) y 60 llamadas por hora a los endpoints de generación para todos. La generación tiene un presupuesto de 300 segundos. La creación de vídeos nuevos está en acceso anticipado, con límites diarios. Unas 55 issues y pull requests abiertas; sin releases etiquetadas.
Lo bueno
- Funciona editando una URL; nada que clonar ni instalar
- Cada ruta enlazada se valida contra el repositorio real
- Compilador Mermaid determinista y lista de enlaces solo a GitHub
- Servidor MCP gratuito de solo lectura y versión en Markdown para agentes
Lo malo
- Como máximo 12 archivos de código y 34 componentes, poco detalle en monorepos
- Los diagramas guardados se quedan obsoletos hasta que alguien los regenera
- Autoalojarlo exige Cloudflare R2, Upstash Redis y una clave de modelo
- Espacios de patrocinio en el README y en la salida Markdown
Ideal para
Ingenieros que evalúan un repositorio de GitHub desconocido, y agentes que necesitan un resumen rápido de la estructura de uno público, antes de que nadie abra el código.
Alternativas a GitDiagram
GitDiagram: preguntas frecuentes
- ¿Merece la pena GitDiagram?
- GitDiagram te da un primer mapa decente de un repositorio desconocido en lo que tardas en editar una URL, siempre que lo trates como un boceto y no como un plano. Le damos un 4.0 sobre 5.
- ¿Cuánto cuesta GitDiagram?
- De uso gratuito y de código abierto (MIT). Los diagramas nuevos son gratis dentro de un límite diario y después necesitan tu propia clave de API de OpenAI; los vídeos explicativos que superan la cuota gratuita diaria cuestan $3 cada uno.
- ¿Qué inconvenientes tiene GitDiagram?
- Como máximo 12 archivos de código y 34 componentes, poco detalle en monorepos; los diagramas guardados se quedan obsoletos hasta que alguien los regenera; autoalojarlo exige Cloudflare R2, Upstash Redis y una clave de modelo; espacios de patrocinio en el README y en la salida Markdown.
- ¿Para quién es GitDiagram?
- Ingenieros que evalúan un repositorio de GitHub desconocido, y agentes que necesitan un resumen rápido de la estructura de uno público, antes de que nadie abra el código.
- ¿Cuánto cuesta GitDiagram para un equipo o en producción?
- El sitio alojado no tiene suscripción. Autoalojarlo supone pagar R2, Upstash y los tokens del modelo por diagrama; el proyecto no publica un coste por diagrama, aunque la aplicación muestra una estimación antes de cada ejecución y un carril Fast opcional duplica el precio del modelo. Los vídeos añaden llamadas a Anthropic, OpenAI y OpenRouter, además de renders con Chromium sin interfaz.
- ¿Es GitDiagram seguro para los datos de la empresa?
- Los diagramas y vídeos de repositorios públicos se publican para cualquiera que abra el repositorio. El contenido del repositorio va a OpenAI, Anthropic y OpenRouter. Los tokens de GitHub y las claves de OpenAI se quedan en una cookie HttpOnly del navegador hasta 30 días, nunca en el servidor; el token recomendado es fine-grained con Contents de solo lectura. En el sitio funcionan la analítica y las grabaciones de sesión de PostHog. Licencia MIT.
- ¿Cuáles son las mejores alternativas a GitDiagram?
- Las alternativas más cercanas que hemos analizado son OpenWiki, Archify y Repomix.
Respuestas comprobadas el 31 oct 2026.