ahmedkhaleel2004/gitdiagram

これは何？

主な機能

• 01公開・非公開のGitHubリポジトリのインタラクティブなアーキテクチャ図を生成
• 02図中のコンポーネントを、対応するソースファイルやディレクトリにリンク
• 03字幕付きの約1分のナレーション解説動画を作成
• 04図をPNGとしてエクスポート、またはMermaidソースをコピー
• 05認証不要でAIエージェントが利用できるリモートMCPサーバーを提供

ユースケース

• 不慣れなコードベースの全体像をすばやく把握する
• プロジェクトの概要をチームメイトと共有する
• AIコーディングエージェントにリポジトリの構成を調べさせる
• 短い動画でプロジェクトの設計を説明する

クイックスタート

1. 1

   リポジトリをクローンする

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

   Bunで依存関係をインストールする

   bun install
3. 3

   サンプルの環境変数ファイルをコピーし、設定ガイドに記載されている必須キーを入力する

4. 4

   開発サーバーを起動し、localhost:3000を開く

   bun run dev

使う前に知っておきたいこと

• !ローカルで実行するには、Cloudflare R2、Upstash Redis、OpenAIまたはOpenRouterのAPIキーが必要です。
• !新しい解説動画の作成機能は早期アクセス中で、動画機能はデフォルトで無効になっています。

トピック

よくある質問

gitdiagram とは？

GitHubリポジトリをインタラクティブなアーキテクチャ図や約1分のナレーション付き解説動画に変換し、AIエージェント向けのMCPサーバーも提供します。 GitDiagramは、GitHubリポジトリのアーキテクチャ図をAIで生成します。リポジトリのURLで「hub」を「diagram」に置き換えるだけで図を開けます。図中の各コンポーネントから、対応するファイルやディレクトリにアクセスできます。GitHub tokenを使えばプライベートリポジトリにも対応し、図はPNGとしてエクスポートするか、Mermaidソースをコピーできます。

gitdiagram は無料で使えますか？ライセンスは？

gitdiagram は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。

gitdiagram は今もメンテナンスされていますか？

活発にメンテナンス中。gitdiagram の最終コミットは 2026年10月20日 です。

gitdiagram は何に使えますか？

不慣れなコードベースの全体像をすばやく把握する プロジェクトの概要をチームメイトと共有する AIコーディングエージェントにリポジトリの構成を調べさせる 短い動画でプロジェクトの設計を説明する

gitdiagram のインストール方法は？

リポジトリをクローンする: git clone https://github.com/ahmedkhaleel2004/gitdiagram.git Bunで依存関係をインストールする: bun install サンプルの環境変数ファイルをコピーし、設定ガイドに記載されている必須キーを入力する 開発サーバーを起動し、localhost:3000を開く: bun run dev

gitdiagram はどこで入手できますか？

ソースコードとインストール手順は GitHub にあります：https://github.com/ahmedkhaleel2004/gitdiagram