SwarmVault

Языки: English | 简体中文 | 日本語

Локальный компилятор знаний для AI-агентов, построенный по паттерну LLM Wiki. Большинство инструментов «чат с документами» отвечают на вопрос и выбрасывают результат. SwarmVault сохраняет постоянную вики между вами и исходными источниками — LLM ведёт учёт, вы занимаетесь мышлением.

Документация на сайте сначала на английском. Если формулировки расходятся между переводами, README.md является каноническим источником.

Попробуйте за 30 секунд

npm install -g @swarmvaultai/cli
swarmvault scan ./your-repo       # укажите на свою кодовую базу или документацию
# → граф знаний откроется в браузере

Нет подходящего репозитория? Попробуйте встроенное демо — создаёт образцовое хранилище с тремя источниками и открывает просмотрщик графа:

Одна команда инициализирует хранилище, загружает источники, компилирует граф знаний и открывает интерактивный просмотрщик. API-ключи не нужны — встроенный эвристический провайдер работает полностью офлайн.

Что вы получаете на диске:

• Граф знаний с типизированными узлами (источники, концепции, сущности, модули кода) и рёбрами с отслеживанием происхождения
• Поисковые страницы вики — сводки источников, страницы концепций, страницы сущностей, перекрёстные ссылки
• Обнаружение противоречий — конфликтующие утверждения из разных источников помечаются автоматически
• Отчёт по графу — оценка неожиданности, «узлы-боги», обнаружение сообществ, объяснения на естественном языке

Трёхуровневая архитектура

SwarmVault использует три уровня по паттерну, описанному Андреем Карпатым:

1. Сырые источники (raw/) — ваша курируемая коллекция исходных документов. Книги, статьи, работы, транскрипты, код, изображения, датасеты. Они неизменяемы: SwarmVault читает их, но никогда не изменяет.
2. Вики (wiki/) — markdown, сгенерированный LLM и написанный вручную. Сводки источников, страницы сущностей, страницы концепций, перекрёстные ссылки, дашборды и результаты. Вики — это постоянный, накапливаемый артефакт.
3. Схема (swarmvault.schema.md) — определяет структуру вики, соглашения и то, что важно в вашей предметной области. Вы и LLM совместно развиваете её со временем.

В традиции Memex Ваннивара Буша (1945) — персонального курируемого хранилища знаний с ассоциативными связями между документами — SwarmVault считает связи между источниками столь же ценными, как и сами источники. Проблему, которую Буш не смог решить — кто занимается обслуживанием — берёт на себя LLM.

Превращайте книги, статьи, заметки, транскрипты, экспорты почты, календари, датасеты, слайды, скриншоты, URL и код в постоянное хранилище знаний с графом, локальным поиском, дашбордами и проверяемыми артефактами, которые остаются на диске. Используйте для персонального управления знаниями, глубоких исследований, книжных компаньонов, документации кода, бизнес-аналитики или любой области, где вы накапливаете знания со временем и хотите их организовать, а не разбросать.

SwarmVault превращает паттерн LLM Wiki в локальный инструментарий с навигацией по графу, поиском, проверкой, автоматизацией и опциональным синтезом на основе модели. Можно также начать с отдельного шаблона схемы — без установки, с любым LLM-агентом — и перейти к полному CLI, когда вырастете из него.

Зачем SwarmVault

Если вам понравился LLM Wiki gist Карпатого, SwarmVault — это его production-версия. Вот как он решает наиболее распространённые вопросы сообщества:

«Разве галлюцинации не будут накапливаться?» — Каждое ребро помечено как extracted, inferred или ambiguous. Обнаружение противоречий помечает конфликтующие утверждения. compile --approve переводит все изменения в проверяемые пакеты одобрения. Новые концепции сначала попадают в wiki/candidates/. lint --conflicts проверяет противоречия по запросу.

«Масштабируется ли это за пределы 100 страниц?» — Да. Гибридный поиск объединяет полнотекстовый поиск SQLite с семантическими эмбеддингами, поэтому запросы работают без загрузки всех страниц в контекст. compile --max-tokens обрезает вывод под ограниченные окна. Навигация по графу (graph query, graph path, graph explain) позволяет обходить граф, а не только искать.

«Это только для личного использования?» — Рабочие процессы на основе Git (--commit), режим наблюдения с git-хуками, запланированная автоматизация и MCP-сервер делают его пригодным для команд. Интеграции с агентами охватывают 16 инструментов — от Claude Code до VS Code Copilot Chat.

«Нужны ли API-ключи?» — Нет. Встроенный провайдер heuristic работает полностью офлайн. Для более точного извлечения подключите бесплатный локальный LLM через Ollama. Облачные провайдеры опциональны.

От Gist до Production