zvec-ai/zvec-grep

Что это?

Ключевые возможности

• 01Сочетает точный поиск и поиск по регулярным выражениям из ripgrep с ранжированием ключевых слов BM25 и семантическим векторным поиском.
• 02Работает в терминале через CLI zg или в AI-агентах через интеграции в стиле MCP.
• 03Индексирует исходный код, документы и структурированные данные, сохраняя расположение исходных фрагментов.
• 04Работает на macOS, Linux и Windows; для npm-пакета требуется Node.js 22 или новее.
• 05По умолчанию файлы, индексы и локальные модели остаются на вашем компьютере.

Сценарии использования

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

Быстрый старт

1. 1

   Установите zg CLI из npm (требуется Node.js 22 или новее).

   npm install -g @zvec/zvec-grep
2. 2

   Проиндексируйте рабочее пространство с помощью локальной модели эмбеддингов.

   zg index --embedding local/potion-retrieval-32m
3. 3

   Выполните поиск из терминала.

   zg query --human "An unseen creature left a few marks. What did the detective infer?" --limit 3

Что важно знать

• !Требуется Node.js 22 или новее.
• !Пример агента зависит от OpenCode и доступности бесплатных моделей, которая может измениться.

В подборках

Темы

Частые вопросы

Что такое zvec-grep?

Локальный CLI и инструмент для агентов: поиск по рабочей директории с помощью ripgrep, BM25 и векторного поиска. zg (zvec-grep) — инструмент для локального поиска по файлам рабочей директории. Он сочетает точный поиск и поиск по регулярным выражениям из ripgrep, ранжирование ключевых слов с помощью BM25 и семантический векторный поиск. Так запрос может находить фрагменты по смыслу, а при необходимости их можно проверить точным поиском. Инструмент построен на векторной базе данных zvec и доступен как пакет Node.js. В README описана реализация на TypeScript/Node.js, а в репозитории есть отдельная реализация на Rust.

zvec-grep можно использовать бесплатно? Какая у него лицензия?

zvec-grep распространяется с открытым исходным кодом под лицензией Apache-2.0. Перед использованием в коммерческих продуктах проверьте условия лицензии.

zvec-grep всё ещё поддерживается?

Активно поддерживается. Последний коммит в zvec-grep — 6 нояб. 2026 г..

Для чего можно использовать zvec-grep?

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

Как установить zvec-grep?

Установите zg CLI из npm (требуется Node.js 22 или новее).: npm install -g @zvec/zvec-grep Проиндексируйте рабочее пространство с помощью локальной модели эмбеддингов.: zg index --embedding local/potion-retrieval-32m Выполните поиск из терминала.: zg query --human "An unseen creature left a few marks. What did the detective infer?" --limit 3

Где скачать zvec-grep?

Исходный код и инструкции по установке — на GitHub: https://github.com/zvec-ai/zvec-grep