lib2027
Русский

Бесплатно · работает на вашем компьютере

Библиотека знаний из ваших файлов — для вас и ваших ИИ-агентов

Положите папку с документами и ищите по ней сразу тремя способами: по смыслу, по словоформам на 15 языках и по точным именам API. Для вас — веб-интерфейс, для Claude Code, pi, Cursor и других агентов — MCP-сервер.

  • Один бинарник на Rust через npx
  • Без Python и без базы данных
  • GPU NVIDIA, DirectML или CPU
# поставить папку на полку
$ npx lib2027 add ./docs
# открыть веб-интерфейс → http://127.0.0.1:2027
$ npx lib2027

Бенчмарки

Помогает ли это модели отвечать?

Свежих и узкоспециальных знаний модели не помнят, а просто добавить больше текста не помогает. Мы измерили, что дают нужные фрагменты.

Как мы измеряли

Та же модель, те же вопросы

В каждом сравнении одна модель отвечает на один и тот же набор вопросов. Меняется только то, что ей дают прочитать.

Группа плацебо

Нерелевантный текст той же длины: контроль для идеи «больше контекста — лучше».

Предрегистрация

Вопросы, правила и пороги успеха зафиксированы до сбора каких-либо данных.

Повторы и проверка

Каждая группа прогонялась 3 раза. Значимость — по парному знаковому критерию на вопросах.

Доля верных ответов

  • Без библиотеки
  • Плацебо
  • С lib2027
  • Без библиотеки — модель отвечает по памяти
  • Плацебо — нерелевантный текст той же длины
  • С lib2027 — фрагменты, найденные поиском lib2027

Свежая веб-документация (devdocs, сентябрь 2026)

150 вопросов · qwen3.8-27b
Без библиотеки17,8 %
Плацебо12,7 %
С lib202785,1 %

Те же вопросы, маленькая модель

150 вопросов · 4B
Без библиотеки9,1 %
Плацебо0,4 %
С lib202783,1 %

Российское право (15 кодексов, pravo.gov.ru)

150 вопросов · qwen3.8-27b
Без библиотеки34,7 %
Плацебо33,8 %
С lib202784,4 %¹

Тест по API three.js r186

90 ответов · Claude Haiku 4.5
Без библиотеки27,8 %
Плацебоне измерялось
С lib202788,9 %

¹ Статья закона возвращается целиком, а не первые 800 символов (прежний результат — 69,1 %). На статьях, изменённых с 2024 года, модель поднимается с 25 % до 81 %.

Показать цифры таблицей
ЗадачаМодельБез библиотекиПлацебоС lib2027
Свежая веб-документация (devdocs, сентябрь 2026)
150 вопросов · qwen3.8-27b
qwen3.8-27b17,8 %12,7 %85,1 %
Те же вопросы, маленькая модель
150 вопросов · 4B
4B9,1 %0,4 %83,1 %
Российское право (15 кодексов, pravo.gov.ru)
150 вопросов · qwen3.8-27b
qwen3.8-27b34,7 %33,8 %84,4 %¹
Тест по API three.js r186
90 ответов · Claude Haiku 4.5
Claude Haiku 4.527,8 %—88,9 %

Не только тест: three.js с Claude Haiku 4.5

Ответы с устаревшим API

24,4 %5,6 %

меньше — лучше

Задача «Напиши игру», баллы из 100

5275

больше — лучше

Ходов до готовой игры

5636

при чуть меньшей стоимости

Библиотека, которую модель никогда не видела

2–5 %84–96 %

Модель 4B решает уже не 2–5 %, а 84–96 % задач, когда lib2027 подаёт к задаче заметки о миграции.

Вывод

Свежих и узкоспециальных знаний модели не помнят, а просто больше контекста не помогает: плацебо ни разу не обошло ответы по памяти. Помогают нужные фрагменты — именно их и подаёт lib2027.

Скорость: Rust против прежней версии на Python

Замеры на Windows с RTX 5090, на одной и той же полке с одними и теми же запросами. Результаты у обеих версий одинаковые: в тесте по праву обе нашли статью для 122 из 150 вопросов.

  • Python + PyTorch
  • lib2027 (Rust)
Меньше — лучше
Гибридный поиск, медиана (GPU)
Python + PyTorch207 ms
lib2027 (Rust)103 ms
Лексический поиск
Python + PyTorch39 ms
lib2027 (Rust)5 ms
Поиск только на CPU
Python + PyTorch4,4 s
lib2027 (Rust)1,7 s
743 тыс. фрагментов (devdocs), на запрос
Python + PyTorch~0,4 s
lib2027 (Rust)0,15 s
MCP-сервер готов к initialize
Python + PyTorch2,6–3,8 s
lib2027 (Rust)< 0,2 s
add ./docs (6 документов, 237 фрагментов)
Python + PyTorch36,6 s
lib2027 (Rust)8,6 s
Сборка 15 кодексов (16 тыс. фрагментов)
Python + PyTorch169 s
lib2027 (Rust)127 s
Разбор 7 170 файлов
Python + PyTorch136 s
lib2027 (Rust)4,1 s
Установка

Python + PyTorch: Python + PyTorch, около 2,5 ГБ

lib2027 (Rust): Node.js и бинарник на 7 МБ; среда выполнения и модели скачиваются при первом запуске

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

Три вида поиска — один ранжированный ответ

Каждый запрос идёт сразу по трём каналам. Результаты объединяются и переранжируются, и вы или ваш агент получаете целые фрагменты, которые можно прочитать и процитировать, а не обрывки.

Смысл

Семантический поиск на эмбеддере Qwen3-Embedding-0.6B находит места, где то же самое сказано другими словами.

Словоформы

Морфология для русского, английского и ещё 13 языков: ищете одну форму слова — находите и остальные.

Точные имена API

Имена функций, классов и опций сравниваются точно: по имени находится именно то, что нужно, а не что-то похожее.

Реранкер

Кросс-энкодер bge-reranker-v2-m3 читает каждого кандидата вместе с запросом и ставит лучших вперёд.

Статьи целиком

Структура сохраняется. Законы делятся по статьям, и статья выдаётся целиком: это подняло результат в тесте по праву с 69,1 % до 84,4 %.

Форматы: md, txt, html, pdf, docx и исходный код (js, ts, json, …). npx lib2027 package <name> добавляет npm-пакет целиком: типы API, документацию, тесты и примеры.

Для агентов

Подключите к Claude Code, pi, Cursor и другим MCP-клиентам

lib2027 работает как MCP-сервер. Подключение — одна команда, дальше агент сам ищет по вашим библиотекам.

Claude Code

npx lib2027 claude

Выполняет claude mcp add за вас. Claude Code получает такие инструменты:

  • search_knowledge
  • read_source
  • list_libraries
  • check_code
  • explore_graph

pi

npx lib2027 pi

Устанавливает MCP-адаптер в pi и подключает lib2027. npx lib2027 pi --remove отключает его.

Cursor, Claude Desktop и другие клиенты

Добавьте это в конфигурацию MCP:

{ "mcpServers": { "lib2027": { "command": "npx", "args": ["-y", "lib2027", "mcp"] } } }

В Windows запускайте npx через cmd:

{ "mcpServers": { "lib2027": { "command": "cmd", "args": ["/c", "npx", "-y", "lib2027", "mcp"] } } }

Удобнее в браузере? npx lib2027 открывает веб-интерфейс на http://127.0.0.1:2027, а рядом — HTTP API.

Команды

Один бинарник, несколько команд.

КомандаЧто делает
add <folder|files…> [--name …] [--lang auto|ru|en|…] [--to slug]Папка становится библиотекой; файлы добавляются в указанную библиотеку. Повторный запуск обновляет изменённые файлы.
listБиблиотеки на полке
search "query" [-l slug] [--top-k 5]Поиск
remove <slug> / restore <slug>Скрыть из поиска / вернуть (файлы остаются на диске)
package <npm-package>[@version]npm-пакет целиком: типы API, документация, тесты и примеры
ui [--port 2027] [--no-open]Веб-интерфейс и HTTP API (то же, что запуск без команды)
mcpMCP-сервер через stdio (его запускает агент)
claude [--scope user|project]Выполняет claude mcp add за вас; без Claude Code выводит конфигурацию для других клиентов
pi [--project] [--remove]Устанавливает MCP-адаптер в pi и подключает lib2027 (или отключает)
ask "question"Ответ с проверенными цитатами (нужен ключ модели: LIB2027_ANSWER_*)
setup [--device cuda|directml|cpu]Заранее устанавливает среду выполнения и модели
doctorПоказывает, что установлено и на чём идут вычисления

Работает там, где работаете вы

Платформы

ПлатформыCUDADirectMLCPU
Windows x64✓✓✓
Windows arm64——✓
Linux x64glibc 2.35+✓—✓
Linux arm64glibc 2.35+——✓
macOS Apple Silicon——✓

Ускорение

NVIDIA CUDA на x64 Windows и Linux, DirectML на x64 Windows. Всё остальное работает на CPU.

Что нужно

Только Node.js 18+. При первом запуске остальное скачивается в ~/.lib2027 — один раз, примерно за 2 минуты: среда ONNX под ваше железо и две модели, Qwen3-Embedding-0.6B и bge-reranker-v2-m3.

Ваши документы остаются у вас

Локально по своей сути

Документы и полка хранятся на вашем устройстве. Поиск выполняется в бинарнике на вашем GPU или CPU.

Ничего не отправляется без вашего решения

Текст уходит третьей стороне, только если вы подключите внешнюю модель для сервиса ответов (LIB2027_ANSWER_*).

По умолчанию — только localhost

Без LIB2027_API_KEY веб-интерфейс и HTTP API работают без ключа и доступны только с localhost.

Обычная папка

Каждая библиотека — это library.sqlite, vectors.f16 и knowledge.json. Скопируйте полку и носите с собой.

Лицензия

Бесплатно, в том числе для коммерческого использования, на любом числе устройств. Исходный код закрыт. Пакеты можно распространять без изменений. Модели и ONNX Runtime скачиваются у их издателей на условиях их собственных лицензий.

Лицензия на npm

Попробуйте на своих документах

Две команды. Нужен только Node.js 18+.

# поставить папку на полку
$ npx lib2027 add ./docs
# открыть веб-интерфейс → http://127.0.0.1:2027
$ npx lib2027