Repolode
ahmedkhaleel2004

ahmedkhaleel2004/gitdiagram

Convierte cualquier repositorio de GitHub en un diagrama interactivo de arquitectura o en un video explicativo narrado de un minuto, con un servidor MCP para agentes de IA.

Estrellas
18,334
Forks
1,516
Issues abiertos
52
Último commit
hace 11 horas

¿Qué es?

GitDiagram genera un diagrama de arquitectura de un repositorio de GitHub escrito por IA. Puedes abrir cualquier repositorio reemplazando «hub» por «diagram» en su URL; el diagrama vincula los componentes con los archivos y directorios correspondientes. Admite repositorios privados mediante un token de GitHub, y los diagramas se pueden exportar como PNG o copiar como código fuente Mermaid.

El proyecto también crea videos explicativos narrados de alrededor de un minuto, que describen para qué sirve un proyecto y cómo encajan sus partes principales. Los videos se pueden descargar como MP4 en formato horizontal o vertical. La creación de videos nuevos está en acceso anticipado, mientras que cualquiera puede ver los ya existentes.

Los agentes de IA pueden conectarse sin clave a un servidor MCP remoto en gitdiagram.com/mcp para consultar la arquitectura, los componentes, las conexiones y el código fuente Mermaid de un repositorio público. La aplicación está desarrollada con Next.js, React, TypeScript y Mermaid, y puede ejecutarse localmente con Bun.

Funciones clave

  • 01Genera diagramas interactivos de arquitectura para repositorios públicos y privados de GitHub
  • 02Vincula los componentes del diagrama con sus archivos y directorios de origen
  • 03Crea videos explicativos narrados de un minuto con subtítulos
  • 04Exporta diagramas como PNG o permite copiar el código fuente Mermaid
  • 05Ofrece un servidor MCP remoto para agentes de IA sin autenticación

Casos de uso

  • Orientarse rápidamente en una base de código desconocida
  • Compartir con el equipo una visión general de un proyecto
  • Permitir que un agente de programación con IA consulte la estructura de un repositorio
  • Explicar el diseño de un proyecto en un video breve

Inicio rápido

  1. 1

    Clona el repositorio

    git clone https://github.com/ahmedkhaleel2004/gitdiagram.git
  2. 2

    Instala las dependencias con Bun

    bun install
  3. 3

    Copia el archivo de entorno de ejemplo y completa las claves necesarias siguiendo la guía de configuración

  4. 4

    Inicia el servidor de desarrollo y abre localhost:3000

    bun run dev

Antes de usarlo

  • Para ejecutarlo localmente necesitas Cloudflare R2, Upstash Redis y una clave de API de OpenAI o OpenRouter.
  • La creación de nuevos videos explicativos está en acceso anticipado y las funciones de video están desactivadas de forma predeterminada.

Temas

Preguntas frecuentes

¿Qué es gitdiagram?
Convierte cualquier repositorio de GitHub en un diagrama interactivo de arquitectura o en un video explicativo narrado de un minuto, con un servidor MCP para agentes de IA. GitDiagram genera un diagrama de arquitectura de un repositorio de GitHub escrito por IA. Puedes abrir cualquier repositorio reemplazando «hub» por «diagram» en su URL; el diagrama vincula los componentes con los archivos y directorios correspondientes. Admite repositorios privados mediante un token de GitHub, y los diagramas se pueden exportar como PNG o copiar como código fuente Mermaid.
¿gitdiagram es gratuito? ¿Qué licencia tiene?
gitdiagram es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿gitdiagram sigue mantenido?
Mantenimiento activo. El último commit de gitdiagram fue el 20 oct 2026.
¿Para qué puedo usar gitdiagram?
Orientarse rápidamente en una base de código desconocida Compartir con el equipo una visión general de un proyecto Permitir que un agente de programación con IA consulte la estructura de un repositorio Explicar el diseño de un proyecto en un video breve
¿Cómo se instala gitdiagram?
Clona el repositorio: git clone https://github.com/ahmedkhaleel2004/gitdiagram.git Instala las dependencias con Bun: bun install Copia el archivo de entorno de ejemplo y completa las claves necesarias siguiendo la guía de configuración Inicia el servidor de desarrollo y abre localhost:3000: bun run dev
¿Dónde consigo gitdiagram?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/ahmedkhaleel2004/gitdiagram

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados