Qu’est-ce que GitDiagram ?
GitDiagram est une application web et un projet Next.js open source d'Ahmed Khaleel qui transforme un dépôt GitHub en diagramme d'architecture interactif. Un modèle d'IA lit l'arborescence du dépôt, son README et jusqu'à 12 fichiers source, rédige une courte présentation, puis renvoie un graphe d'au plus 34 composants regroupés, reliés par des connexions étiquetées. Chaque chemin lié est vérifié par rapport à l'arborescence réelle avant que le graphe soit compilé en Mermaid, et chaque composant ouvre son fichier ou son dossier sur GitHub.
Les diagrammes sont stockés et partagés : un dépôt que quelqu'un a déjà diagrammé s'ouvre donc instantanément. Le site produit aussi des vidéos explicatives commentées d'environ une minute, exporte en PNG ou en source Mermaid, propose une version Markdown de chaque diagramme stocké à gitdiagram.com/owner/repo.md et fait tourner un serveur MCP distant, gratuit et en lecture seule, à gitdiagram.com/mcp. Les dépôts privés fonctionnent avec un token GitHub en lecture seule.
Le dépôt a été créé en décembre 2024, est sous licence MIT et compte environ 18 700 étoiles GitHub et 1 430 forks. Il ne publie aucune release étiquetée ; le dernier commit date du 30 octobre 2026.
GitDiagram vaut-il le coup ?
La valeur de GitDiagram tient à un parcours sans étape : rien à cloner, rien à installer, pas de clé pour la plupart des usages et un lien à partager à la fin. Le pipeline qui se trouve derrière est plus soigné que l'astuce de l'URL ne le laisse croire. Selon la documentation d'architecture, une seule requête à GPT-6 Luna avec un raisonnement faible diffuse en streaming une présentation et un graphe strict ; le serveur vérifie les identifiants, la connexité et chaque chemin lié par rapport au dépôt réel, relance les sorties invalides avec un retour ciblé, et un compilateur déterministe, pas le modèle, écrit le Mermaid. Le navigateur assainit ensuite le SVG et n'autorise que les liens vers GitHub. Les liens sont donc fiables même quand le dessin ne l'est pas.
Le plafond est inscrit dans la conception. Le modèle voit un extrait borné de l'arborescence, le README et au plus 12 fichiers source, et ne dessine pas plus de 34 composants. Pour une petite bibliothèque, c'est largement suffisant ; pour un monorepo de plusieurs dizaines de services, cela donne une image grossière où des paquets entiers se réduisent à une case, et le guide du projet parle lui-même d'une carte des parties importantes, pas d'un graphe de dépendances complet. Les très gros dépôts que GitHub renvoie sous forme d'arborescence tronquée obtiennent quand même un diagramme à partir d'une liste partielle, et un README trop volumineux est refusé d'emblée. Un diagramme stocké fige aussi le dépôt dans l'état où il était ; Regenerate en produit un nouveau.
Le traitement des données par le site hébergé est clairement documenté dans sa politique de confidentialité. Le contenu du dépôt part chez OpenAI, Anthropic et OpenRouter pour produire ce que vous avez demandé. Les dépôts privés demandent un token fine-grained avec Contents en lecture seule, ou une connexion Continue with GitHub limitée aux dépôts que vous choisissez ; le token reste dans un cookie HttpOnly jusqu'à 30 jours et n'est jamais enregistré sur le serveur, et les diagrammes privés vivent dans un espace de noms séparé. Le site enregistre des sessions avec PostHog, la saisie étant masquée. Le README et la version Markdown portent des emplacements sponsorisés payants, CodeRabbit au moment où nous écrivons.
Les vidéos sont la partie coûteuse et sont rationnées en conséquence. Claude Opus écrit le script, Claude Haiku 5.5 conçoit les scènes, Gemini 3.8 Flash TTS via OpenRouter le lit et whisper-1 cale les mots ; les plafonds par défaut sont une nouvelle vidéo par navigateur et 25 sur tout le site par jour UTC, puis $3 pour une vidéo de plus. Face à DeepWiki, qui écrit un wiki de plusieurs pages avec un chat, GitDiagram répond plus vite à une question plus étroite, et un agent de code dans votre propre copie locale dessinera un diagramme plus exact d'un code privé ou non commité.
Là où il fait la différence
Une ingénieure backend qui compare trois bibliothèques open source de files de tâches
Voir comment chacune est construite avant de lire le moindre code
Remplacez 'hub' par 'diagram' dans chaque URL GitHub ; les diagrammes stockés s'ouvrent aussitôt et les nouveaux prennent environ une minute. Un clic sur un composant mène à son dossier. Gratuit dans la limite quotidienne ; au-delà, c'est votre propre clé OpenAI qui paie.
Un développeur qui utilise Claude Code ou Codex sur une tâche touchant une dépendance inconnue
Donner à l'agent la structure de la dépendance sans coller son code source
Ajoutez le serveur MCP distant en une commande et demandez à l'agent comment le projet est structuré ; il lit la présentation stockée, les composants, les connexions et la source Mermaid. Gratuit, limité par défaut à 120 appels d'outils par heure et par réseau, et réservé aux dépôts publics.
Une responsable des relations développeurs dans une entreprise open source de 20 personnes
Mettre un schéma d'architecture et une courte vidéo explicative dans le README du projet
Exportez le diagramme en PNG ou copiez la source Mermaid comme premier jet à retoucher, et téléchargez la vidéo explicative en MP4 paysage ou 9:16 avec sous-titres incrustés. Une vidéo au-delà du quota gratuit quotidien coûte $3.
Avant de vous engager
- Mise en route
- Hébergé : modifiez l'URL ou collez owner/repo sur la page d'accueil ; environ une minute pour un nouveau diagramme. Auto-hébergé : Bun 1.3.14 et Node 22, bun install, puis remplissez .env avec des buckets Cloudflare R2, Upstash Redis, CACHE_KEY_SECRET et une clé OpenAI ou OpenRouter avant bun run dev.
- Intégrations
- Serveur MCP distant (get_repository_diagram, find_repository_diagrams, get_explainer_video) pour Claude, Claude Code, Codex, Cursor, VS Code, Gemini CLI, GitHub Copilot CLI et ChatGPT ; un plugin Claude Code avec une skill /gitdiagram ; Markdown à /owner/repo.md ; export PNG et Mermaid.
- Données et confidentialité
- Les diagrammes et vidéos des dépôts publics sont publiés pour quiconque ouvre le dépôt. Le contenu du dépôt part chez OpenAI, Anthropic et OpenRouter. Les tokens GitHub et les clés OpenAI restent dans un cookie HttpOnly du navigateur jusqu'à 30 jours, jamais sur le serveur ; le token conseillé est fine-grained avec Contents en lecture seule. Le site utilise l'analytique et l'enregistrement de sessions de PostHog. Licence MIT.
- Coût à grande échelle
- Le site hébergé n'a pas d'abonnement. S'auto-héberger, c'est payer R2, Upstash et les tokens du modèle à chaque diagramme ; le projet ne publie pas de coût par diagramme, mais l'application affiche une estimation avant chaque exécution, et une voie Fast optionnelle double le prix du modèle. Les vidéos ajoutent des appels à Anthropic, OpenAI et OpenRouter ainsi que des rendus avec Chromium headless.
- Limites
- Les valeurs par défaut du code autorisent 8 générations financées par le serveur par IP et par heure (les appelants avec leur propre clé en sont exemptés) et 60 appels par heure aux endpoints de génération pour tout le monde. Une génération dispose d'un budget de 300 secondes. La création de nouvelles vidéos est en accès anticipé, avec des plafonds quotidiens. Environ 55 issues et pull requests ouvertes ; aucune release étiquetée.
Les points forts
- Fonctionne en modifiant une URL ; rien à cloner ni à installer
- Chaque chemin lié est validé par rapport au dépôt réel
- Compilateur Mermaid déterministe et liste blanche de liens limitée à GitHub
- Serveur MCP gratuit en lecture seule et version Markdown pour les agents
Les points faibles
- Au plus 12 fichiers source et 34 composants, grossier sur les monorepos
- Les diagrammes stockés vieillissent jusqu'à ce que quelqu'un les régénère
- L'auto-hébergement exige Cloudflare R2, Upstash Redis et une clé de modèle
- Emplacements sponsorisés dans le README et la sortie Markdown
Idéal pour
Les ingénieurs qui jaugent un dépôt GitHub inconnu, et les agents qui ont besoin d'un résumé rapide de la structure d'un dépôt public, avant que quiconque ouvre le code.
Alternatives à GitDiagram
GitDiagram : questions fréquentes
- GitDiagram vaut-il le coup ?
- GitDiagram vous donne une première carte correcte d'un dépôt inconnu le temps de modifier une URL, à condition de la traiter comme une esquisse et non comme un plan. Nous lui donnons 4.0 sur 5.
- Combien coûte GitDiagram ?
- Gratuit à l'usage et open source (MIT). Les nouveaux diagrammes sont gratuits dans une limite quotidienne, puis demandent votre propre clé d'API OpenAI ; les vidéos explicatives au-delà du quota gratuit quotidien coûtent $3 chacune.
- Quels sont les inconvénients de GitDiagram ?
- Au plus 12 fichiers source et 34 composants, grossier sur les monorepos; les diagrammes stockés vieillissent jusqu'à ce que quelqu'un les régénère; l'auto-hébergement exige Cloudflare R2, Upstash Redis et une clé de modèle; emplacements sponsorisés dans le README et la sortie Markdown.
- À qui s’adresse GitDiagram ?
- Les ingénieurs qui jaugent un dépôt GitHub inconnu, et les agents qui ont besoin d'un résumé rapide de la structure d'un dépôt public, avant que quiconque ouvre le code.
- Combien coûte GitDiagram pour une équipe ou en production ?
- Le site hébergé n'a pas d'abonnement. S'auto-héberger, c'est payer R2, Upstash et les tokens du modèle à chaque diagramme ; le projet ne publie pas de coût par diagramme, mais l'application affiche une estimation avant chaque exécution, et une voie Fast optionnelle double le prix du modèle. Les vidéos ajoutent des appels à Anthropic, OpenAI et OpenRouter ainsi que des rendus avec Chromium headless.
- GitDiagram est-il sûr pour les données de l’entreprise ?
- Les diagrammes et vidéos des dépôts publics sont publiés pour quiconque ouvre le dépôt. Le contenu du dépôt part chez OpenAI, Anthropic et OpenRouter. Les tokens GitHub et les clés OpenAI restent dans un cookie HttpOnly du navigateur jusqu'à 30 jours, jamais sur le serveur ; le token conseillé est fine-grained avec Contents en lecture seule. Le site utilise l'analytique et l'enregistrement de sessions de PostHog. Licence MIT.
- Quelles sont les meilleures alternatives à GitDiagram ?
- Les alternatives les plus proches que nous avons testées sont OpenWiki, Archify et Repomix.
Réponses vérifiées le 31 oct. 2026.