Repolode
Enviar
ahmedkhaleel2004

ahmedkhaleel2004/gitdiagram

Transforma qualquer repositório do GitHub em um diagrama interativo de arquitetura ou em um vídeo explicativo narrado de um minuto, com um servidor MCP para agentes de IA.

Ver no GitHubSite
Estrelas
18,334
Forks
1,516
Issues abertas
52
Último commit
há 11 horas

O que é?

O GitDiagram gera um diagrama de arquitetura de um repositório do GitHub, criado por IA. Você pode abrir qualquer repositório substituindo 'hub' por 'diagram' na URL. O diagrama conecta os componentes aos arquivos e diretórios correspondentes. Repositórios privados também são compatíveis mediante um token do GitHub, e os diagramas podem ser exportados como PNG ou copiados como código Mermaid.

O projeto também cria vídeos explicativos narrados, com cerca de um minuto, que descrevem a finalidade do projeto e como suas principais partes se encaixam. É possível baixar os vídeos em MP4 nos formatos horizontal ou vertical. A criação de novos vídeos está em acesso antecipado, mas qualquer pessoa pode assistir aos já existentes.

Agentes de IA podem se conectar sem chave ao servidor MCP remoto em gitdiagram.com/mcp para consultar a arquitetura, os componentes, as conexões e o código Mermaid de um repositório público. O app é desenvolvido com Next.js, React, TypeScript e Mermaid, e pode ser executado localmente com Bun.

Recursos principais

  • 01Gera diagramas interativos de arquitetura para repositórios públicos e privados do GitHub
  • 02Conecta os componentes do diagrama aos arquivos e diretórios de origem
  • 03Cria vídeos explicativos narrados de um minuto, com legendas
  • 04Exporta diagramas como PNG ou permite copiar o código Mermaid
  • 05Oferece um servidor MCP remoto para agentes de IA, sem autenticação

Casos de uso

  • Entender rapidamente uma base de código desconhecida
  • Compartilhar uma visão geral do projeto com colegas de equipe
  • Permitir que um agente de programação com IA consulte a estrutura de um repositório
  • Explicar o design de um projeto em um vídeo curto

Início rápido

  1. 1

    Clone o repositório

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

    Instale as dependências com Bun

    bun install
  3. 3

    Copie o arquivo de ambiente de exemplo e preencha as chaves necessárias seguindo o guia de configuração

  4. 4

    Inicie o servidor de desenvolvimento e abra localhost:3000

    bun run dev

Antes de usar

  • Para executar localmente, é necessário ter Cloudflare R2, Upstash Redis e uma chave de API da OpenAI ou da OpenRouter.
  • A criação de novos vídeos explicativos está em acesso antecipado, e os recursos de vídeo vêm desativados por padrão.

Tópicos

#architecture-diagram#code-visualization#mermaid#llm#developer-tools#mcp#ai#code#codebase-visualization#diagram-generator

Perguntas frequentes

O que é gitdiagram?
Transforma qualquer repositório do GitHub em um diagrama interativo de arquitetura ou em um vídeo explicativo narrado de um minuto, com um servidor MCP para agentes de IA. O GitDiagram gera um diagrama de arquitetura de um repositório do GitHub, criado por IA. Você pode abrir qualquer repositório substituindo 'hub' por 'diagram' na URL. O diagrama conecta os componentes aos arquivos e diretórios correspondentes. Repositórios privados também são compatíveis mediante um token do GitHub, e os diagramas podem ser exportados como PNG ou copiados como código Mermaid.
gitdiagram é gratuito? Qual é a licença?
gitdiagram é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
gitdiagram ainda é mantido?
Manutenção ativa. O último commit de gitdiagram foi em 20 de out. de 2026.
Para que posso usar gitdiagram?
Entender rapidamente uma base de código desconhecida Compartilhar uma visão geral do projeto com colegas de equipe Permitir que um agente de programação com IA consulte a estrutura de um repositório Explicar o design de um projeto em um vídeo curto
Como instalar gitdiagram?
Clone o repositório: git clone https://github.com/ahmedkhaleel2004/gitdiagram.git Instale as dependências com Bun: bun install Copie o arquivo de ambiente de exemplo e preencha as chaves necessárias seguindo o guia de configuração Inicie o servidor de desenvolvimento e abra localhost:3000: bun run dev
Onde consigo gitdiagram?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/ahmedkhaleel2004/gitdiagram

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados