GitDiagram: визуализация репозиториев на GitHub с видео объяснениями
GitDiagram — инструмент для визуализации кода на GitHub с помощью интерактивных архитектурных диаграмм и коротких объясняющих видео. Замена 'hub' на 'diagram' в любом URL репозитория GitHub позволяет быстро превратить его в наглядное представление.
Проект помогает разобраться в структуре публичных и частных репозиториев. Он предлагает уникальный подход к пониманию кода: вместо привычного чтения документации или изучения файловой структуры, ты получаешь визуализацию и минутное видео, которое объясняет основные компоненты и их взаимодействия. Это может быть полезно как разработчикам, так и менеджерам проектов, которые хотят быстро ознакомиться с архитектурой приложения.
GitDiagram поддерживает работу как с публичными, так и с приватными репозиториями, но для доступа к видео на своих репозиториях нужно учитывать, что функция создания новых видео находится на ранней стадии. Запускается через веб-браузер без установки дополнительных инструментов.
GitDiagram — это инструмент, который позволяет превратить любой публичный или приватный репозиторий на GitHub в интерактивную архитектурную диаграмму. Также доступна функция создания краткого видео, в котором поясняется, как работает проект.
Основные возможности
- Создание объясняющего видео для репозитория длительностью около минуты.
- Генерация диаграммы архитектуры с помощью ИИ и потокового объяснения.
- Переход к коду, нажав на любой компонент, чтобы открыть связанный файл или директорию.
- Работа с приватными репозиториями с использованием токена GitHub.
- Экспорт диаграмм в формате PNG или копирование исходного кода Mermaid.
Запуск локально
Для локальной установки GitDiagram необходимо выполнить следующие шаги:
git clone https://github.com/ahmedkhaleel2004/gitdiagram.git
cd gitdiagram
bun install
cp .env.example .env
После этого нужно заполнить файл .env в соответствии с [руководством по настройке](docs/dev-setup.md#configure) и запустить приложение с помощью команды:
bun run dev
Приложение будет доступно по адресу http://localhost:3000.
Ограничения и требования
Для запуска GitDiagram требуется:
- Установленный Bun.
- Доступ к Cloudflare R2 и Upstash Redis.
- API-ключ OpenAI или OpenRouter.
Объясняющие видео по умолчанию отключены, чтобы их активировать, нужно изменить настройки в файле .env.
Разработка
GitDiagram разработан с использованием Next.js, React, TypeScript, Tailwind CSS и Mermaid. Для создания видео используются Claude или GPT для написания сценариев, а также OpenRouter для голосового озвучивания. Проект размещён на Vercel и открыт для вкладов, можно открывать issues или делать pull request.
Радар проекта: 64 из 100 — крепкий проект
- Импульс 65 ≈ 31 звезда в день
- Темп разработки 100 448 коммитов за 12 недель
- Зрелость 44 проекту 23 месяца, релизов нет
- Сообщество 60 5 участников, 1446 форков
- Свежесть 97 последний коммит — 4 дня назад
- Быстрый старт 40 есть: Docker, сайт/демо
- Готовность к продакшену 30 автосборка
- Безопасность и доверие 40 лицензия MIT
- Документация 83 README 4.3 тыс. знаков, 8 разделов, папка docs
- Экосистема 83 56 подписчиков на обновления, 16 тем
Как считаем
Только открытые данные GitHub на 14.11.2026, без оценок нейросети. Каждая ось — от 0 до 100, итог — среднее.
- Импульс — звёзд в день: за время наших замеров, а пока их нет — за всю жизнь проекта; 200 в день — максимум.
- Темп разработки — коммитов за последние 12 недель; 300 — максимум. Пока GitHub не досчитал статистику, ось не учитывается.
- Зрелость — возраст проекта (3 года — максимум) и число релизов (30 — максимум), поровну.
- Сообщество — участников с коммитами (200 — максимум) и форков (5000 — максимум), поровну.
- Свежесть — дней с последнего коммита: сегодня — 100, полгода и больше или архив — 0.
- Быстрый старт — в README есть команда установки, раздел «быстрый старт» или примеры использования, в репозитории — Docker и папка примеров, у проекта есть сайт или демо.
- Готовность к продакшену — релизы, версия 1.0 и выше, автосборка (GitHub Actions), тесты, лицензия, журнал изменений.
- Безопасность и доверие — открытая лицензия (своя — половина балла), политика безопасности (SECURITY.md), проект организации, правила для участников, не в архиве.
- Документация — объём и структура README, папка docs или сайт, оценка «здоровья сообщества» GitHub.
- Экосистема — звёзды (50 тыс. — максимум), подписчики на обновления (1000 — максимум), темы репозитория.
Открыть на GitHub: ahmedkhaleel2004/gitdiagram →
Есть рилс про этот проект
Замени hub на diagram — 30 секунд в Instagram*
▶ Смотреть
RepoRadar