18.3K ·GitHub
Что это такое?
GitDiagram превращает любой публичный или приватный репозиторий на GitHub в интерактивную диаграмму архитектуры за считанные секунды. Можно также заменить 'hub' на 'diagram' в любом адресе GitHub, и откроется диаграмма этого репозитория.
GitDiagram превращает любой публичный или приватный репозиторий на GitHub в интерактивную диаграмму архитектуры за считанные секунды. Можно также заменить 'hub' на 'diagram' в любом адресе GitHub, и откроется диаграмма этого репозитория.Это сайт, куда я захожу, или что-то, что нужно устанавливать?Это веб-приложение — устанавливать ничего не нужно. Оно берёт дерево файлов репозитория и README и превращает их в схему системы: компоненты и связи между ними, а не нарисованные папки. При этом каждый узел ведёт на настоящий исходный код на GitHub.
Это веб-приложение — устанавливать ничего не нужно. Оно берёт дерево файлов репозитория и README и превращает их в схему системы: компоненты и связи между ними, а не нарисованные папки. При этом каждый узел ведёт на настоящий исходный код на GitHub.Как получить диаграмму репозитория и как это работает внутри?Замените 'hub' на 'diagram' в любом адресе GitHub. Сервис через GitHub API подтягивает дерево файлов и README, выдаёт объяснение архитектуры простым английским языком, а затем рисует проверенный интерактивный граф в формате Mermaid.
Замените 'hub' на 'diagram' в любом адресе GitHub. Сервис через GitHub API подтягивает дерево файлов и README, выдаёт объяснение архитектуры простым английским языком, а затем рисует проверенный интерактивный граф в формате Mermaid.Нужен ли мне свой ключ OpenAI API, чтобы этим пользоваться?На официальном сайте — нет: по умолчанию используется OpenAI (OpenRouter при самостоятельном размещении), и бесплатная квота уже входит. Для локальной разработки нужно больше — как минимум R2, Upstash и хотя бы один AI-провайдер в .env.
На официальном сайте — нет: по умолчанию используется OpenAI (OpenRouter при самостоятельном размещении), и бесплатная квота уже входит. Для локальной разработки нужно больше — как минимум R2, Upstash и хотя бы один AI-провайдер в .env.Он работает с любым репозиторием или есть ограничения?Ограничения есть: репозитории с обрезанным деревом файлов и слишком большие входные данные отклоняются ещё до обращения к модели, а генерация должна уложиться в лимит функции Vercel в 300 секунд.
Ограничения есть: репозитории с обрезанным деревом файлов и слишком большие входные данные отклоняются ещё до обращения к модели, а генерация должна уложиться в лимит функции Vercel в 300 секунд.Могу ли я запустить GitDiagram на своём сервере, а не на официальном сайте?Единственная рабочая площадка — Vercel, но в репозитории есть рецепт восстановления: то же приложение Next.js собирается в минимальный Docker-образ без root для Railway с помощью лежащего в репозитории Dockerfile и railway.json.
Единственная рабочая площадка — Vercel, но в репозитории есть рецепт восстановления: то же приложение Next.js собирается в минимальный Docker-образ без root для Railway с помощью лежащего в репозитории Dockerfile и railway.json.Он умеет строить диаграммы приватных репозиториев и что происходит с моим токеном GitHub?Да — выберите Private Repos и укажите детализированный персональный токен доступа GitHub. Он передаётся только с запросом на тот же домен, никогда не вставляется в публичные ссылки, а приватные артефакты хранятся в отдельном пространстве имён R2.
Да — выберите Private Repos и укажите детализированный персональный токен доступа GitHub. Он передаётся только с запросом на тот же домен, никогда не вставляется в публичные ссылки, а приватные артефакты хранятся в отдельном пространстве имён R2.Как он защищается от того, чтобы ИИ выдал сломанную или неверную диаграмму?Ответ модели проверяется до того, как вы его увидите: сервер сверяет имена, связность графа, лимиты и все указанные пути с реальным репозиторием и при недопустимом результате повторяет генерацию с точечными замечаниями, а браузер отображает очищенный Mermaid в строгом режиме безопасности.
Ответ модели проверяется до того, как вы его увидите: сервер сверяет имена, связность графа, лимиты и все указанные пути с реальным репозиторием и при недопустимом результате повторяет генерацию с точечными замечаниями, а браузер отображает очищенный Mermaid в строгом режиме безопасности.Каждый раз, когда я снова открываю диаграмму, запускается новая генерация через ИИ?Нет. Удачные результаты сохраняются в Cloudflare R2 — с привязкой к репозиторию, а приватные лежат в отдельном пространстве имён, — поэтому при следующих заходах открывается уже готовая диаграмма без нового обращения к модели.
Нет. Удачные результаты сохраняются в Cloudflare R2 — с привязкой к репозиторию, а приватные лежат в отдельном пространстве имён, — поэтому при следующих заходах открывается уже готовая диаграмма без нового обращения к модели.Что я могу сделать с готовой диаграммой?Кликнуть по любому компоненту и открыть его настоящий файл или папку на GitHub, скопировать исходник Mermaid или скачать отрисованную диаграмму в PNG.
Кликнуть по любому компоненту и открыть его настоящий файл или папку на GitHub, скопировать исходник Mermaid или скачать отрисованную диаграмму в PNG.На чём написан GitDiagram?Next.js 16 App Router, React 19, TypeScript, Tailwind CSS и Radix UI, а эндпоинты генерации работают на Bun-окружении Vercel. Артефакты хранятся в Cloudflare R2, Upstash Redis отвечает за квоты и блокировки, а AI-провайдер — OpenAI или OpenRouter.
Next.js 16 App Router, React 19, TypeScript, Tailwind CSS и Radix UI, а эндпоинты генерации работают на Bun-окружении Vercel. Артефакты хранятся в Cloudflare R2, Upstash Redis отвечает за квоты и блокировки, а AI-провайдер — OpenAI или OpenRouter.What are similar projects?next-ai-draw-io, archify, oh-my-mermaid, deepwiki-open, whirl, chatbot, crm, svg-diagram
next-ai-draw-io, archify, oh-my-mermaid, deepwiki-open, whirl, chatbot, crm, svg-diagramWhich topics is it in?gemini-cli-extension, architecture-diagram, mermaid, code, software-architecture, diagrams, system-design, openrouter, vercel, architecture, visualization, tailwindcss
gemini-cli-extension, architecture-diagram, mermaid, code, software-architecture, diagrams, system-design, openrouter, vercel, architecture, visualization, tailwindcss