🇺🇸 English | 🇨🇳 简体中文 | 🇯🇵 日本語 | 🇰🇷 한국어 | 🇩🇪 Deutsch | 🇫🇷 Français | 🇪🇸 Español | 🇮🇳 हिन्दी | 🇧🇷 Português | 🇷🇺 Русский | 🇸🇦 العربية | 🇮🇹 Italiano | 🇵🇱 Polski | 🇳🇱 Nederlands | 🇹🇷 Türkçe | 🇺🇦 Українська | 🇻🇳 Tiếng Việt | 🇮🇩 Bahasa Indonesia | 🇸🇪 Svenska | 🇬🇷 Ελληνικά | 🇷🇴 Română | 🇨🇿 Čeština | 🇫🇮 Suomi | 🇩🇰 Dansk | 🇳🇴 Norsk | 🇭🇺 Magyar | 🇹🇭 ภาษาไทย | 🇺🇿 Oʻzbekcha | 🇹🇼 繁體中文
Введіть /graphify у своєму ШІ-асистенті для кодингу, і він нанесе весь ваш проект — код, документи, PDF, зображення, відео — на граф знань, який можна запитувати замість того, щоб шукати по файлах.
Працює в Claude Code, Codex, OpenCode, Cursor, Gemini CLI, GitHub Copilot CLI, VS Code Copilot Chat, Aider, OpenClaw, Factory Droid, Trae, Hermes, Kimi Code, Kiro, Pi та Google Antigravity.
/graphify .
Це все. Ви отримуєте три файли:
graphify-out/
├── graph.html відкрийте в будь-якому браузері — клікайте по вузлах, фільтруйте, шукайте
├── GRAPH_REPORT.md основне: ключові концепції, неочікувані зв’язки, запропоновані запитання
└── graph.json повний граф — запитуйте його будь-коли без повторного перечитування ваших файлів
Для читабельної сторінки архітектури з діаграмами викликів Mermaid виконайте:
graphify export callflow-html| Вимога | Мінімум | Перевірка | Встановлення |
|---|---|---|---|
| Python | 3.10+ | python --version |
python.org |
| uv (рекомендовано) | будь-яка | uv --version |
curl -LsSf https://astral.sh/uv/install.sh | sh |
| pipx (альтернатива) | будь-яка | pipx --version |
pip install pipx |
Швидке встановлення на macOS (Homebrew):
brew install python@3.12 uvШвидке встановлення на Windows:
winget install astral-sh.uvUbuntu/Debian:
sudo apt install python3.12 python3-pip pipx
# або встановити uv:
curl -LsSf https://astral.sh/uv/install.sh | shОфіційний пакет: Пакет PyPI —
graphifyy(подвійна y). Інші пакетиgraphify*на PyPI не є афілійованими. Команда CLI залишаєтьсяgraphify.
Крок 1 — встановити пакет:
# Рекомендовано (uv автоматично додає graphify до PATH):
uv tool install graphifyy
# Альтернативи:
pipx install graphifyy
pip install graphifyyКрок 2 — зареєструвати навичку у вашому ШІ-асистенті:
graphify installЦе все. Відкрийте асистента і введіть /graphify .
Щоб встановити навичку в поточний репозиторій замість профілю користувача, додайте --project:
graphify install --project
graphify install --project --platform codexВстановлення на рівні проєкту записуються в поточну директорію, наприклад .claude/skills/graphify/SKILL.md або .agents/skills/graphify/SKILL.md, і виводять підказку git add для файлів, які можна закомітити. Команди для окремих платформ, що підтримують інсталяції на рівні проєкту, приймають той самий прапорець, наприклад graphify claude install --project або graphify codex install --project.
Примітка для PowerShell: Використовуйте
graphify .замість/graphify .— ведучий слеш є роздільником шляху в PowerShell.
graphify: command not found? Використовуйтеuv tool install graphifyyабоpipx install graphifyy— обидва автоматично додають CLI до PATH. При використанні звичайногоpipдодайте~/.local/bin(Linux) або~/Library/Python/3.x/bin(Mac) до вашого PATH, або запустітьpython -m graphify.
| Платформа | Команда встановлення |
|---|---|
| Claude Code (Linux/Mac) | graphify install |
| Claude Code (Windows) | graphify install --platform windows |
| Codex | graphify install --platform codex |
| OpenCode | graphify install --platform opencode |
| GitHub Copilot CLI | graphify install --platform copilot |
| VS Code Copilot Chat | graphify vscode install |
| Aider | graphify install --platform aider |
| OpenClaw | graphify install --platform claw |
| Factory Droid | graphify install --platform droid |
| Trae | graphify install --platform trae |
| Trae CN | graphify install --platform trae-cn |
| Gemini CLI | graphify install --platform gemini |
| Hermes | graphify install --platform hermes |
| Kimi Code | graphify install --platform kimi |
| Kiro IDE/CLI | graphify kiro install |
| Pi coding agent | graphify install --platform pi |
| Cursor | graphify cursor install |
| Google Antigravity | graphify antigravity install |
Користувачам Codex: також додайте
multi_agent = trueпід[features]у~/.codex/config.toml. Codex використовує$graphifyзамість/graphify.
Встановіть лише те, що потрібно:
| Пакет | Що додає | Встановлення |
|---|---|---|
pdf |
Вилучення PDF | pip install "graphifyy[pdf]" |
office |
Підтримка .docx та .xlsx |
pip install "graphifyy[office]" |
google |
Рендеринг Google Sheets | pip install "graphifyy[google]" |
video |
Транскрипція відео/аудіо (faster-whisper + yt-dlp) | pip install "graphifyy[video]" |
mcp |
MCP stdio-сервер | pip install "graphifyy[mcp]" |
neo4j |
Підтримка надсилання до Neo4j | pip install "graphifyy[neo4j]" |
svg |
Експорт графу в SVG | pip install "graphifyy[svg]" |
leiden |
Виявлення спільнот Leiden (лише Python < 3.13) | pip install "graphifyy[leiden]" |
ollama |
Локальний вивід Ollama | pip install "graphifyy[ollama]" |
openai |
OpenAI / OpenAI-сумісні API | pip install "graphifyy[openai]" |
gemini |
Google Gemini API | pip install "graphifyy[gemini]" |
bedrock |
AWS Bedrock (використовує IAM, без API-ключа) | pip install "graphifyy[bedrock]" |
sql |
Вилучення SQL схем | pip install "graphifyy[sql]" |
all |
Все вищезазначене | pip install "graphifyy[all]" |
Виконайте один раз у своєму проекті після побудови графу:
| Платформа | Команда |
|---|---|
| Claude Code | graphify claude install |
| Codex | graphify codex install |
| OpenCode | graphify opencode install |
| GitHub Copilot CLI | graphify copilot install |
| VS Code Copilot Chat | graphify vscode install |
| Aider | graphify aider install |
| OpenClaw | graphify claw install |
| Factory Droid | graphify droid install |
| Trae | graphify trae install |
| Trae CN | graphify trae-cn install |
| Cursor | graphify cursor install |
| Gemini CLI | graphify gemini install |
| Hermes | graphify hermes install |
| Kimi Code | graphify install --platform kimi |
| Kiro IDE/CLI | graphify kiro install |
| Pi coding agent | graphify pi install |
| Google Antigravity | graphify antigravity install |
Це записує невеликий конфігураційний файл, який каже асистенту звертатися до графу знань для питань про кодову базу — надаючи перевагу локалізованим запитам на кшталт graphify query "<питання>" замість читання повного звіту або пошуку по сирих файлах. На платформах, що підтримують хуки з корисним навантаженням (Claude Code, Gemini CLI), хук спрацьовує автоматично перед пошуковими викликами інструментів і спрямовує асистента до графу. На інших (Codex, OpenCode, Cursor тощо) постійні файли інструкцій (AGENTS.md, .cursor/rules/ тощо) забезпечують таке саме керівництво. GRAPH_REPORT.md все ще доступний для загального огляду архітектури.
Щоб видалити graphify з усіх платформ одразу: graphify uninstall (додайте --purge, щоб також видалити graphify-out/). Або скористайтеся командою для конкретної платформи (напр. graphify claude uninstall).
- Вузли-боги — найбільш пов'язані концепції у вашому проекті. Через них проходить все.
- Несподівані зв'язки — зв'язки між речами з різних файлів або модулів. Відсортовані за ступенем несподіваності.
- «Чому» — рядкові коментарі (
# NOTE:,# WHY:,# HACK:), рядки документації та обґрунтування дизайну з документів витягуються як окремі вузли, пов'язані з кодом, який вони пояснюють. - Запропоновані питання — 4–5 питань, на які граф унікально здатний відповісти.
- Теги впевненості — кожен виведений зв'язок позначений як
EXTRACTED,INFERREDабоAMBIGUOUS. Ви завжди знаєте, що знайдено, а що виведено.
| Тип | Розширення |
|---|---|
| Код (31 мова) | .py .ts .js .jsx .tsx .mjs .go .rs .java .c .cpp .h .hpp .rb .cs .kt .scala .php .swift .lua .luau .zig .ps1 .ex .exs .m .mm .jl .vue .svelte .astro .groovy .gradle .dart .v .sv .sql .f .f90 .f95 .f03 .f08 .pas .pp .dpr .dpk .lpr .inc .dfm .lfm .lpk .sh .bash .json |
| Документи | .md .mdx .qmd .html .txt .rst .yaml .yml |
| Office | .docx .xlsx (потрібен pip install graphifyy[office]) |
| Google Workspace | .gdoc .gsheet .gslides (опціонально; потрібна автентифікація gws та --google-workspace; Sheets потребує pip install graphifyy[google]) |
.pdf |
|
| Зображення | .png .jpg .webp .gif |
| Відео / Аудіо | .mp4 .mov .mp3 .wav та інші (потрібен pip install graphifyy[video]) |
| YouTube / URL | будь-який URL відео (потрібен pip install graphifyy[video]) |
Код витягується локально без API-викликів (AST через tree-sitter). Все інше обробляється через API моделі вашого ШІ-асистента.
Файли .gdoc, .gsheet та .gslides з Google Drive for desktop — це ярлики-посилання, а не вміст документів. Щоб включити нативні Google Docs, Sheets та Slides у безголове витягування, встановіть та автентифікуйте gws CLI, потім запустіть:
pip install "graphifyy[google]" # потрібен для рендерингу таблиць Google Sheets
gws auth login -s drive
graphify extract ./docs --google-workspaceТакож можна встановити GRAPHIFY_GOOGLE_WORKSPACE=1. Graphify експортує ярлики в graphify-out/converted/ як Markdown-сайдкари, а потім витягує ці файли.
/graphify . # побудувати граф для поточної папки
/graphify ./docs --update # повторно витягнути лише змінені файли
/graphify . --cluster-only # перезапустити кластеризацію без повторного витягування
/graphify . --cluster-only --resolution 1.5 # більш дрібні спільноти
/graphify . --cluster-only --exclude-hubs 99 # виключити утилітарні суперхаби з рейтингів “god-node” вузлів-богів
/graphify . --no-viz # пропустити HTML, лише звіт + JSON
/graphify . --wiki # побудувати markdown-вікі з графу
graphify export callflow-html # Mermaid архітектура/flow-викликів HTML (автоматично регенерується на кожен git-коміт, якщо встановлений hook)
/graphify query "що пов'язує auth з базою даних?"
/graphify path "UserService" "DatabasePool"
/graphify explain "RateLimiter"
/graphify add https://arxiv.org/abs/1706.03762 # завантажити статтю і додати її
/graphify add <youtube-url> # транскрибувати і додати відео
graphify hook install # автоматичне перебудування при git-коміті
graphify merge-graphs a.json b.json # об'єднати два графи
graphify prs # дашборд PR: стан CI, статус рев’ю, мапінг worktree
graphify prs 42 # детальний огляд PR #42 з впливом на граф
graphify prs --triage # ШІ оцінює вашу чергу рев’ю (використовує будь-який налаштований бекенд)
graphify prs --conflicts # PR-и, що ділять спільні графові спільноти — ризик порядку злиттяДивіться повний довідник команд нижче.
Створіть .graphifyignore у кореневій директорії проекту — той самий синтаксис, що й .gitignore, включно з запереченням !:
# .graphifyignore
node_modules/
dist/
*.generated.py
# індексувати лише src/, ігнорувати все інше
*
!src/
!src/**
graphify-out/ призначений для коміту в git, щоб кожен у команді починав із картою.
Рекомендовані доповнення до .gitignore:
graphify-out/manifest.json # базується на mtime, ламається після git clone
graphify-out/cost.json # лише локальний
# graphify-out/cache/ # опціонально: комітьте для швидкості, пропустіть для меншого репо
Робочий процес:
- Одна людина запускає
/graphify .і комітитьgraphify-out/. - Усі виконують pull — їхній асистент одразу читає граф.
- Запустіть
graphify hook installдля автоматичного перебудування після кожного коміту (лише AST, без витрат API). Це також налаштовує git merge driver, щобgraph.jsonніколи не залишався з маркерами конфліктів — два розробники, що комітять одночасно, отримають автоматично об'єднані графи. - Коли документи або статті змінюються, запустіть
/graphify --update, щоб оновити ці вузли.
# запит до графу з терміналу
graphify query "покажи потік автентифікації"
graphify query "що пов'язує DigestAuth з Response?" --graph graphify-out/graph.json
# відкрити граф як MCP-сервер (для повторного доступу через інструменти)
python -m graphify.serve graphify-out/graph.json
# зареєструвати в Kimi Code:
kimi mcp add --transport stdio graphify -- python -m graphify.serve graphify-out/graph.jsonMCP-сервер надає асистенту структурований доступ: query_graph, get_node, get_neighbors, shortest_path, list_prs, get_pr_impact, triage_prs.
Примітка для WSL / Linux: Ubuntu постачає
python3, а неpython. Використовуйте venv, щоб уникнути конфліктів:python3 -m venv .venv && .venv/bin/pip install "graphifyy[mcp]"
Потрібні лише для headless / CI витягування (graphify extract). При запуску через навичку /graphify у вашому IDE API моделі надається сесією IDE — додаткових ключів не потрібно.
| Змінна | Використання | Коли потрібна |
|---|---|---|
ANTHROPIC_API_KEY |
Backend Claude (Anthropic) | --backend claude |
ANTHROPIC_BASE_URL |
URL Anthropic-сумісного endpoint (LiteLLM proxy, шлюзи, ...) | --backend claude (типово: https://api.anthropic.com) |
ANTHROPIC_MODEL |
Назва моделі для backend Claude — для власних endpoint використовуйте назву/псевдонім моделі вашого сервера | --backend claude (типово: claude-sonnet-4-6) |
GEMINI_API_KEY або GOOGLE_API_KEY |
Backend Google Gemini | --backend gemini |
OPENAI_API_KEY |
OpenAI або OpenAI-сумісні API | --backend openai (локальні сервери приймають будь-яке непорожнє значення) |
OPENAI_BASE_URL |
URL OpenAI-сумісного сервера (llama.cpp, vLLM, LM Studio, ...) | --backend openai (типово: https://api.openai.com/v1) |
OPENAI_MODEL |
Назва моделі для backend OpenAI — для self-hosted серверів використовуйте назву/псевдонім моделі, яку надає ваш сервер (див. його endpoint /v1/models), напр. LFM2.5-8B-A1B-UD-Q4_K_XL для llama.cpp |
--backend openai (типово: gpt-4.1-mini) |
DEEPSEEK_API_KEY |
Backend DeepSeek | --backend deepseek |
MOONSHOT_API_KEY |
Backend Kimi Code | --backend kimi |
OLLAMA_BASE_URL |
URL локального виводу Ollama | --backend ollama (типово: http://localhost:11434) |
OLLAMA_MODEL |
Назва моделі Ollama | --backend ollama (типово: автовизначення) |
GRAPHIFY_OLLAMA_NUM_CTX |
Перевизначити розмір KV-кеш вікна Ollama | опціонально — автоматично за замовчуванням |
GRAPHIFY_OLLAMA_KEEP_ALIVE |
Хвилини утримання моделі Ollama завантаженою | опціонально — встановіть 0 для вивантаження після кожного шматка |
AWS_* / ~/.aws/credentials |
AWS Bedrock — стандартний ланцюг облікових даних | --backend bedrock (без API-ключа, використовує IAM) |
GRAPHIFY_MAX_WORKERS |
Кількість потоків паралелізму AST | опціонально — також прапор --max-workers |
GRAPHIFY_MAX_OUTPUT_TOKENS |
Підвищити ліміт виводу для щільних корпусів | опціонально — напр. 32768 для великих файлів |
GRAPHIFY_API_TIMEOUT |
HTTP тайм-аут у секундах (типово: 600) | опціонально — також прапор --api-timeout |
GRAPHIFY_FORCE |
Примусове перебудування графу навіть із меншою кількістю вузлів | опціонально — також прапор --force |
GRAPHIFY_GOOGLE_WORKSPACE |
Автоввімкнення експорту Google Workspace | опціонально — встановіть в 1 |
GRAPHIFY_TRIAGE_BACKEND |
Backend для graphify prs --triage |
опціонально — автовизначення з наявних ключів |
GRAPHIFY_TRIAGE_MODEL |
Перевизначення моделі для triage | опціонально — напр. claude-opus-4-7 |
- Файли коду — обробляються локально через tree-sitter. Нічого не покидає ваш комп'ютер.
- Відео / аудіо — транскрибуються локально за допомогою faster-whisper. Нічого не покидає ваш комп'ютер.
- Документи, PDF, зображення — надсилаються до вашого ШІ-асистента для семантичного витягування (через навичку
/graphify, використовуючи модель, що запущена у вашому IDE). Безголовеgraphify extractпотребуєGEMINI_API_KEY/GOOGLE_API_KEY(Gemini),MOONSHOT_API_KEY(Kimi),ANTHROPIC_API_KEY(Claude),OPENAI_API_KEY(OpenAI),DEEPSEEK_API_KEY(DeepSeek), запущеного екземпляра Ollama (OLLAMA_BASE_URL), AWS-облікових даних через стандартний ланцюг провайдерів (Bedrock — без API-ключа, використовує IAM) або бінарного файлуclaudeCLI (Claude Code — без API-ключа, використовує вашу підписку Claude). Прапор--dedup-llmвикористовує той самий ключ. - Без телеметрії, без відстеження використання, без аналітики.
graphify: command not found після pip install graphifyy
pip встановлює скрипти в директорію bin для користувача, яка може не бути в PATH. Виправлення:
- macOS: додайте
~/Library/Python/3.x/binдо PATH у~/.zshrc - Linux: додайте
~/.local/binдо PATH у~/.bashrc - Або використовуйте
uv tool install graphifyy/pipx install graphifyy— обидва автоматично керують PATH.
python -m graphify працює, але команда graphify — ні
PATH вашої оболонки не включає директорію скриптів Python. Використовуйте uv або pipx замість звичайного pip.
/graphify . викликає "path not recognized" в PowerShell
PowerShell трактує ведучий / як роздільник шляху. Використовуйте graphify . (без слеша) на Windows.
Граф має менше вузлів після --update або перебудови
Якщо рефакторинг видалив файли, старі вузли залишаються. Передайте --force (або встановіть GRAPHIFY_FORCE=1), щоб перезаписати навіть якщо перебудова має менше вузлів.
Граф має дублікати вузлів для однієї сутності (фантомні дублікати) Це трапляється, коли семантичне та AST-витягування не погодилось щодо формату ID вузла. Запустіть повне повторне витягування для очищення:
graphify extract . --forceOllama вичерпує VRAM / перевищено вікно контексту KV-кеш вікно автоматично розраховується, але може бути завеликим для вашого GPU. Зменшіть його:
GRAPHIFY_OLLAMA_NUM_CTX=8192 graphify extract ./docs --backend ollama --token-budget 4000HTML графу занадто великий для відкриття в браузері (>5000 вузлів) Пропустіть генерацію HTML і використовуйте JSON напряму:
graphify cluster-only ./my-project --no-viz
graphify query "..."graph.json має маркери конфліктів після одночасного коміту двох розробників
Запустіть graphify hook install — це налаштовує git merge driver, який автоматично об'єднує graph.json, щоб конфліктів ніколи не виникало.
Вилучення повертає порожні вузли/ребра для документів або PDF Документи та PDF потребують LLM-виклику. Перевірте, що API-ключ встановлено і backend правильний:
ANTHROPIC_API_KEY=sk-... graphify extract ./docs --backend claudeПопередження про невідповідність версій навички у вашому IDE Встановлена версія graphify відрізняється від файлу навички. Оновіть:
uv tool upgrade graphifyy
graphify install # перезаписує файл навички/graphify # запустити в поточному каталозі
/graphify ./raw # запустити у конкретній папці
/graphify ./raw --mode deep # більш агресивне витягування зв'язків
/graphify ./raw --update # повторно витягнути лише змінені файли
/graphify ./raw --directed # зберегти напрямок ребер
/graphify ./raw --cluster-only # повторна кластеризація існуючого графу
/graphify ./raw --no-viz # пропустити HTML-візуалізацію
/graphify ./raw --obsidian # згенерувати сховище Obsidian
/graphify ./raw --wiki # побудувати markdown-вікі для обходу агентами
/graphify ./raw --svg # експортувати graph.svg
/graphify ./raw --graphml # експортувати для Gephi / yEd
/graphify ./raw --neo4j # згенерувати cypher.txt для Neo4j
/graphify ./raw --neo4j-push bolt://localhost:7687
/graphify ./raw --watch # автосинхронізація при зміні файлів
/graphify ./raw --mcp # запустити MCP stdio-сервер
/graphify add https://arxiv.org/abs/1706.03762
/graphify add <video-url>
/graphify add https://... --author "Name" --contributor "Name"
/graphify query "що пов'язує attention з optimizer?"
/graphify query "..." --dfs --budget 1500
/graphify path "DigestAuth" "Response"
/graphify explain "SwinTransformer"
graphify uninstall # видалити з усіх платформ одразу
graphify uninstall --purge # також видалити graphify-out/
graphify uninstall --project --platform codex # видалити лише файли проектного встановлення
graphify hook install # хуки post-commit + post-checkout
graphify hook uninstall
graphify hook status
graphify claude install / uninstall
graphify codex install / uninstall
graphify opencode install
graphify cursor install / uninstall
graphify gemini install / uninstall
graphify copilot install / uninstall
graphify aider install / uninstall
graphify claw install / uninstall
graphify droid install / uninstall
graphify trae install / uninstall
graphify trae-cn install / uninstall
graphify hermes install / uninstall
graphify kiro install / uninstall
graphify antigravity install / uninstall
graphify extract ./docs # headless LLM-витягування для CI (без IDE)
graphify extract ./docs --backend gemini # явний backend: gemini, kimi, claude, openai, deepseek, ollama, bedrock або claude-cli
graphify extract ./docs --backend gemini --model gemini-3.1-pro-preview
graphify extract ./docs --backend ollama # локальний Ollama (встановіть OLLAMA_BASE_URL / OLLAMA_MODEL) — без API-ключа для loopback
OPENAI_BASE_URL=http://localhost:8080/v1 OPENAI_MODEL=my-model graphify extract ./docs --backend openai # будь-який OpenAI-сумісний сервер (llama.cpp, vLLM, LM Studio)
ANTHROPIC_BASE_URL=http://localhost:4000 ANTHROPIC_MODEL=my-model graphify extract ./docs --backend claude # будь-який Anthropic-сумісний endpoint (LiteLLM proxy, шлюзи)
GRAPHIFY_OLLAMA_NUM_CTX=32768 graphify extract ./docs --backend ollama # перевизначити KV-кеш вікно (автоматично за замовчуванням)
GRAPHIFY_OLLAMA_KEEP_ALIVE=0 graphify extract ./docs --backend ollama # вивантажити модель після кожного шматка (економить VRAM на малих GPU)
graphify extract ./docs --backend bedrock # AWS Bedrock через IAM — без API-ключа, використовує ланцюг облікових даних AWS
graphify extract ./docs --backend claude-cli # маршрутизація через Claude Code CLI — без API-ключа, використовує вашу підписку Claude
graphify extract ./docs --max-workers 16 # паралелізм AST (також GRAPHIFY_MAX_WORKERS)
graphify extract ./docs --token-budget 30000 # менші семантичні шматки для локальних/малих моделей
graphify extract ./docs --max-concurrency 2 # менше паралельних LLM-викликів (корисно для локального виводу)
graphify extract ./docs --api-timeout 900 # довший HTTP тайм-аут для повільних локальних моделей (типово 600с)
graphify extract ./docs --google-workspace # експортувати .gdoc/.gsheet/.gslides через gws перед витягуванням
graphify extract ./docs --no-cluster # лише сире витягування, пропустити кластеризацію
graphify extract ./docs --force # перезаписати graph.json навіть якщо новий граф має менше вузлів (використовуйте після рефакторингу або для очищення фантомних дублікатів)
graphify extract ./docs --dedup-llm # LLM-арбітр для неоднозначних пар сутностей (використовує той самий API-ключ)
graphify extract ./docs --global --as myrepo # витягнути і зареєструвати в крос-проектний глобальний граф
GRAPHIFY_MAX_OUTPUT_TOKENS=32768 graphify extract ./docs --backend claude # підвищити ліміт виводу для щільних корпусів
graphify export callflow-html # graphify-out/<project>-callflow.html
graphify export callflow-html --max-sections 8 # обмежити кількість згенерованих секцій архітектури
graphify export callflow-html --output docs/arch.html
graphify export callflow-html ./some-repo/graphify-out
graphify global add graphify-out/graph.json myrepo # зареєструвати граф проекту в ~/.graphify/global.json
graphify global remove myrepo # видалити проект з глобального графу
graphify global list # показати всі зареєстровані репо + кількість вузлів/ребер
graphify global path # вивести шлях до файлу глобального графу
graphify prs # дашборд PR: CI, рев’ю, worktree, вплив на граф
graphify prs 42 # детальний огляд PR #42
graphify prs --triage # AI ранжування пріоритизації (автоматично визначає бекенд з середовища)
graphify prs --worktrees # worktree → гілка → PR зіставлення
graphify prs --conflicts # PR-и, що ділять спільні графові спільноти (ризик порядку злиття)
graphify prs --base main # фільтр PR-ів за цільовою базовою гілкою
graphify prs --repo owner/repo # запустити для іншого GitHub-репо
GRAPHIFY_TRIAGE_BACKEND=kimi graphify prs --triage # використовувати конкретний backend для triage
graphify clone https://github.com/karpathy/nanoGPT
graphify merge-graphs a.json b.json --out merged.json
graphify --version # вивести встановлену версію
graphify watch ./src
graphify check-update ./src
graphify update ./src
graphify update ./src --no-cluster # пропустити рекластеризацію, записати лише сирий AST граф
graphify update ./src --force # перезаписати навіть якщо новий граф має менше вузлів
graphify cluster-only ./my-project
graphify cluster-only ./my-project --graph path/to/graph.json # власне розташування графу
graphify cluster-only ./my-project --resolution 1.5 # більше, менших спільнот
graphify cluster-only ./my-project --exclude-hubs 99 # виключити вузли p99 ступеня з розбиття
- Як це працює — пайплайн витягування, виявлення спільнот, оцінка впевненості, бенчмарки
- ARCHITECTURE.md — опис модулів, як додати мову
- Опціональні інтеграції — Docker MCP Toolkit + SQLite
Penpax — це завжди активний шар поверх graphify, він застосовує той самий графовий підхід до всього робочого життя: зустрічей, історії браузера, email-ів, файлів і коду, постійно оновлюючись у фоновому режимі.
Створений для людей, чия робота розкидана по сотнях розмов і документів, які неможливо повністю відтворити. Без хмари, повністю на пристрої.
Безкоштовна пробна версія незабаром. Приєднайтесь до списку очікування →
Участь у розробці
Клонуйте репо і встановіть у редагованому режимі:
git clone https://github.com/safishamsi/graphify.git
cd graphify
git checkout v8 # гілка активної розробки
# Створіть віртуальне середовище (потрібен Python 3.10+):
python3 -m venv .venv
source .venv/bin/activate # Windows: .venv\Scripts\activate
# Встановіть у редагованому режимі з усіма опціональними пакетами:
pip install -e ".[all]"Перевірте редаговане встановлення:
graphify --version
python -c "import graphify; print(graphify.__file__)"pip install pytest
pytest tests/ -q # запустити весь набір тестів
pytest tests/test_extract.py -q # один модуль
pytest tests/ -q -k "python" # фільтрація за назвоюПримітка для macOS: набір тестів включає обидва файли
sample.f90таsample.F90. Вони конфліктують на файлових системах HFS+ / APFS без урахування регістру. Запускайте на Linux або в Docker-контейнері, якщо потрібно тестувати обидва варіанти Fortran одночасно.
- Активна розробка відбувається в гілці
v8. - Стиль комітів:
fix: <опис>/feat: <опис>/docs: <опис> - Перед відкриттям PR запустіть
pytest tests/ -qі переконайтесь, що він проходить. - Додайте файл-фікстуру до
tests/fixtures/і тести доtests/test_languages.pyдля будь-якого нового екстрактора мови.
Найкорисніший внесок — це опрацьовані приклади. Запустіть /graphify на реальному корпусі, збережіть результат у worked/{slug}/, напишіть чесний review.md про те, що граф зробив правильно і неправильно, і відкрийте PR.
Помилки витягування — відкрийте issue з вхідним файлом, записом кешу (graphify-out/cache/) і тим, що було пропущено або неправильно.
Дивіться ARCHITECTURE.md щодо відповідальностей модулів і того, як додати мову.