Skip to content

Latest commit

 

History

History
170 lines (122 loc) · 14.8 KB

File metadata and controls

170 lines (122 loc) · 14.8 KB

Graphify

🇺🇸 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 | 🇹🇭 ภาษาไทย | 🇹🇼 繁體中文

CI PyPI Downloads Sponsor LinkedIn

Навык для AI-ассистента по написанию кода. Введите /graphify в Claude Code, Codex, OpenCode, Cursor, Gemini CLI, GitHub Copilot CLI, VS Code Copilot Chat, Aider, OpenClaw, Factory Droid, Trae, Hermes, Kiro или Google Antigravity — он прочитает ваши файлы, построит граф знаний и вернёт вам структуру, о существовании которой вы не подозревали. Понимайте кодовую базу быстрее. Находите «почему» за архитектурными решениями.

Полностью мультимодальный. Добавляйте код, PDF, markdown, скриншоты, диаграммы, фотографии досок, изображения на других языках, видео и аудиофайлы — graphify извлекает концепции и связи из всего этого и объединяет их в один граф. Видео транскрибируются локально с Whisper, используя доменный промпт из вашего корпуса. Поддерживается 25 языков программирования через tree-sitter AST (Python, JS, TS, Go, Rust, Java, C, C++, Ruby, C#, Kotlin, Scala, PHP, Swift, Lua, Zig, PowerShell, Elixir, Objective-C, Julia, Verilog, SystemVerilog, Vue, Svelte, Dart).

Андрей Карпати ведёт папку /raw, куда складывает статьи, твиты, скриншоты и заметки. graphify — ответ на эту проблему: в 71,5 раза меньше токенов на запрос по сравнению с чтением сырых файлов, сохранение между сессиями, честность относительно того, что найдено, а что выведено.

/graphify .                        # работает с любой папкой — код, заметки, статьи, всё что угодно
graphify-out/
├── graph.html       интерактивный граф — открыть в браузере, кликать по узлам, искать, фильтровать
├── GRAPH_REPORT.md  бог-узлы, неожиданные связи, предлагаемые вопросы
├── graph.json       постоянный граф — запрашивать через недели без повторного чтения
└── cache/           SHA256-кэш — повторные запуски обрабатывают только изменённые файлы

Добавьте файл .graphifyignore для исключения папок:

# .graphifyignore
vendor/
node_modules/
dist/
*.generated.py

Синтаксис аналогичен .gitignore.

Как это работает

graphify работает в три прохода. Сначала детерминированный AST-проход извлекает структуру из файлов кода (классы, функции, импорты, графы вызовов, docstrings, комментарии с обоснованием) — без LLM. Затем видео и аудиофайлы транскрибируются локально с faster-whisper. Наконец, Claude-субагенты запускаются параллельно над документами, статьями, изображениями и транскриптами для извлечения концепций, связей и обоснований дизайна. Результаты объединяются в граф NetworkX, кластеризуются с помощью Leiden-детекции сообществ и экспортируются как интерактивный HTML, запрашиваемый JSON и аудит-отчёт на естественном языке.

Кластеризация основана на топологии графа — без эмбеддингов. Leiden находит сообщества по плотности рёбер. Рёбра семантического сходства, извлечённые Claude (semantically_similar_to, помечены как INFERRED), уже в графе. Структура графа — это сигнал сходства. Отдельный шаг с эмбеддингами или векторная база данных не нужны.

Каждая связь помечена как EXTRACTED (найдена непосредственно в источнике), INFERRED (обоснованный вывод с оценкой уверенности) или AMBIGUOUS (помечена для проверки).

Установка

Требования: Python 3.10+ и одно из: Claude Code, Codex, OpenCode, Cursor, Gemini CLI, GitHub Copilot CLI, VS Code Copilot Chat, Aider, OpenClaw, Factory Droid, Trae, Kiro, Hermes или Google Antigravity

# Рекомендуется — работает на Mac и Linux без настройки PATH
uv tool install graphifyy && graphify install
# или с pipx
pipx install graphifyy && graphify install
# или обычный pip
pip install graphifyy && graphify install

Официальный пакет: Пакет PyPI называется graphifyy (установить через pip install graphifyy). Другие пакеты с именем graphify* на PyPI не связаны с этим проектом. Единственный официальный репозиторий — safishamsi/graphify.

Поддержка платформ

Платформа Команда установки
Claude Code (Linux/Mac) graphify install
Claude Code (Windows) graphify install (авто-определение) или 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
Kiro IDE/CLI graphify kiro install
Cursor graphify cursor install
Google Antigravity graphify antigravity install

Затем откройте AI-ассистент и введите:

/graphify .

Примечание: Codex использует $ вместо / для навыков, поэтому вводите $graphify ..

Заставить ассистента всегда использовать граф (рекомендуется)

После построения графа выполните это один раз в вашем проекте:

Платформа Команда
Claude Code graphify claude install
Codex graphify codex install
OpenCode graphify opencode install
Cursor graphify cursor install
Gemini CLI graphify gemini install
Kiro IDE/CLI graphify kiro install
Google Antigravity graphify antigravity install

Использование

/graphify                          # текущая директория
/graphify ./raw                    # конкретная папка
/graphify ./raw --mode deep        # более агрессивное извлечение INFERRED-рёбер
/graphify ./raw --update           # повторно извлечь только изменённые файлы
/graphify ./raw --directed         # направленный граф
/graphify ./raw --cluster-only     # перезапустить кластеризацию на существующем графе
/graphify ./raw --no-viz           # без HTML, только отчёт + JSON
/graphify ./raw --obsidian         # создать Obsidian vault (opt-in)

/graphify add https://arxiv.org/abs/1706.03762   # получить статью
/graphify add <video-url>                         # скачать аудио, транскрибировать, добавить
/graphify query "что связывает Attention с оптимизатором?"
/graphify path "DigestAuth" "Response"
/graphify explain "SwinTransformer"

graphify hook install              # установить Git-хуки
graphify update ./src              # повторно извлечь файлы кода, без LLM
graphify watch ./src               # автоматическое обновление графа

Что вы получаете

Бог-узлы — концепции с наибольшей степенью (через которые проходит всё)

Неожиданные связи — отсортированы по составному баллу. Рёбра код-статья получают более высокий рейтинг. Каждый результат содержит объяснение «почему» на естественном языке.

Предлагаемые вопросы — 4-5 вопросов, на которые граф уникально способен ответить

«Почему» — docstrings, встроенные комментарии (# NOTE:, # IMPORTANT:, # HACK:, # WHY:), и обоснования дизайна из документов извлекаются как узлы rationale_for.

Оценки уверенности — каждое INFERRED-ребро имеет confidence_score (0,0-1,0).

Бенчмарк токенов — выводится автоматически после каждого запуска. На смешанном корпусе: 71,5-кратное сокращение токенов на запрос vs сырые файлы.

Авто-синхронизация (--watch) — обновляет граф автоматически при изменении кода.

Git-хуки (graphify hook install) — устанавливает post-commit и post-checkout хуки.

Конфиденциальность

graphify отправляет содержимое файлов в API модели вашего AI-ассистента для семантического извлечения из документов, статей и изображений. Файлы кода обрабатываются локально через tree-sitter AST. Видео и аудиофайлы транскрибируются локально с faster-whisper. Никакой телеметрии, никакого отслеживания использования.

Технологический стек

NetworkX + Leiden (graspologic) + tree-sitter + vis.js. Семантическое извлечение через Claude, GPT-4 или модель вашей платформы. Транскрипция видео через faster-whisper + yt-dlp (опционально).

Построено на graphify — Penpax

Penpax — корпоративный слой поверх graphify. Там, где graphify превращает папку с файлами в граф знаний, Penpax применяет тот же граф ко всей вашей рабочей жизни — непрерывно.

Бесплатный пробный период скоро. Вступить в список ожидания →

История звёзд

Star History Chart