Graphify: обзор графа знаний по кодовой базе для AI-агентов

01Что такое Graphify и какую задачу он решает

Проблема, из которой вырос Graphify, знакома каждому, кто работает с агентом в большом репозитории. Агент задаёт вопрос «где обрабатывается авторизация», получает в контекст десяток файлов целиком и всё равно промахивается, потому что нужная связь проходит через три сервиса и два уровня абстракции. Векторный поиск по коду помогает частично: он находит похожие фрагменты, но не показывает, кто кого вызывает. Граф показывает именно это — и, что важнее, показывает с пометкой, откуда взялось ребро.

Технически Graphify — это Python-пакет graphifyy (команда называется graphify) и скилл для кодинг-агентов. Локальный парсинг кода идёт через tree-sitter: функции, классы, импорты, вызовы — без обращения к модели. Документация, PDF, изображения и расшифровки обрабатываются семантическим слоем через выбранный бэкенд (Claude, Gemini, OpenAI, DeepSeek, Kimi, Ollama, Bedrock, Azure или Claude CLI). На выходе — graphify-out/graph.json в формате NetworkX node-link, отчёт GRAPH_REPORT.md, интерактивная визуализация graph.html и кэш, по которому повторный прогон обрабатывает только изменённые файлы.

02Архитектура: два независимых пути извлечения

Ключевое архитектурное решение — разделение путей. Разбор кода не отправляет файлы в модель вообще: это чисто локальная операция на tree-sitter. Модель появляется только там, где нужен смысл, — в документации, PDF, на скриншотах диаграмм. Поэтому graphify extract . --code-only работает без единого API-ключа, а для семантического прохода ключ нужен.

Второе решение — метки уверенности на рёбрах. Каждое ребро помечено как EXTRACTED (связь явно есть в исходнике), INFERRED (выведена разрешением имён или семантикой) или AMBIGUOUS (однозначного вывода нет). Это принципиально отличается от «магии RAG», где похожий фрагмент выглядит одинаково уверенно независимо от того, имеет он отношение к делу или нет. Документация отдельно предупреждает: INFERRED не всегда означает «придумала модель» — часть таких рёбер выведена статическим разрешением имён и импортов.

03Цифры: звёзды, загрузки, коммиты

Graphify — не единственный проект, который строит граф по коду, но по публичным метрикам он сейчас крупнее остальных вместе взятых. Для сравнения мы взяли три проекта того же класса, у которых тоже есть открытый код: microsoft/graphrag (графовый RAG по документам), getzep/graphiti (граф знаний для памяти агентов) и vitali87/code-graph-rag (граф по монорепозиторию).

04Открытый CLI и платный Cloud: где граница

Модель распространения двухслойная. Открытый CLI под Apache-2.0 работает локально, не требует аккаунта и умеет всё, что нужно одному разработчику: построить граф, обновить его, спросить, экспортировать, поднять MCP-сервер. Cloud — это хостинговый workspace: графы по нескольким репозиториям сразу, wiki, ревью pull request, формальная верификация, общая память команды и участники с ролями.

05Сравнение с GraphRAG, Graphiti и code-graph-rag

Все четыре проекта строят граф, но отвечают на разные вопросы. graphrag из Microsoft Research — про извлечение сущностей из корпуса документов и ответы по нему; graphiti из Zep — про долговременную память агента с временными метками; code-graph-rag — про понимание монорепозитория; Graphify — про контекст для кодинг-агента в вашей IDE с локальным парсингом и MCP.

06Лицензия, данные и приватность

Лицензия самого CLI — Apache-2.0, без ограничения по выручке и без запрета на коммерческое использование. Это заметно свободнее, чем у многих моделей того же поколения, где открытые веса идут с порогом по доходу. Ограничения начинаются не в лицензии, а в приватности: граф содержит метки и фрагменты исходников, поэтому документация советует обращаться с graph.json так же, как с самим репозиторием, и не публиковать артефакты в открытый доступ.

Отдельно про логи: локальное журналирование запросов по умолчанию выключено. Включается переменными GRAPHIFY_QUERY_LOG_ENABLE=1 (пишет в ~/.cache/graphify-queries.log) или GRAPHIFY_QUERY_LOG=/path, а полные ответы — только с GRAPHIFY_QUERY_LOG_RESPONSES=1. В логах бывают вопросы и пути к корпусу, так что включать их стоит осознанно.

07Плюсы и минусы

08Кому подходит Graphify

Первый сценарий — команда, которая уже работает с кодинг-агентами и устала от «агент не понимает наш проект». Граф с MCP-сервером даёт агенту структурный вход: он идёт от символа к вызывающим, а не листает файлы на удачу. Второй сценарий — большой legacy-репозиторий, куда новый человек приходит надолго: отчёт с god-узлами и сообществами сам по себе читается как карта кодовой базы.

Третий, менее очевидный — закрытый контур. Поскольку разбор кода локальный, Graphify можно ставить на машину без выхода в интернет: --code-only не требует ни ключа, ни сети. Это редкость для инструментов 2026 года, которые почти все предполагают облачный индекс. Пошаговая инструкция по установке, подключению MCP и поддержанию графа в актуальном состоянии — в гайде по Graphify.