zvec-ai/zvec-grep

¿Qué es?

Funciones clave

• 01Combina la búsqueda exacta y por expresiones regulares de ripgrep con la clasificación de palabras clave de BM25 y la búsqueda semántica vectorial.
• 02Se puede usar desde la terminal mediante la CLI zg o desde agentes de IA a través de integraciones de tipo MCP.
• 03Indexa código fuente, documentos y datos estructurados, y conserva las ubicaciones de origen.
• 04Funciona en macOS, Linux y Windows; el paquete npm requiere Node.js 22 o posterior.
• 05Por defecto, mantiene los archivos, los índices y los modelos locales en tu máquina.

Casos de uso

• Encontrar rutas de código y detalles de arquitectura en un repositorio grande cuando se desconoce el nombre exacto del símbolo.
• Permitir que un agente de programación con IA busque en un proyecto local y obtenga resultados clasificados con enlaces a las fuentes.
• Buscar por significado, en lugar de por palabras clave exactas, en una carpeta con documentos y código variados.
• Realizar búsquedas semánticas privadas sin enviar archivos a un servicio remoto.

Inicio rápido

1. 1

   Instala zg CLI desde npm (requiere Node.js 22 o posterior).

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

   Indexa tu espacio de trabajo con un modelo de embeddings local.

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

   Ejecuta una búsqueda desde la terminal.

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

Antes de usarlo

• !Requiere Node.js 22 o posterior.
• !El ejemplo de agente depende de OpenCode y de la disponibilidad de modelos gratuitos, que puede cambiar.

En colecciones

Temas

Preguntas frecuentes

¿Qué es zvec-grep?

CLI de búsqueda local y herramienta para agentes que combina ripgrep, BM25 y búsqueda vectorial en tu espacio de trabajo. zg (zvec-grep) es una herramienta de búsqueda local que funciona con los archivos de un espacio de trabajo. Combina la búsqueda exacta de texto y por expresiones regulares de ripgrep, la clasificación de palabras clave con BM25 y la búsqueda semántica vectorial. Así, una consulta puede encontrar fragmentos por su significado y luego verificarlos con texto exacto cuando sea necesario. Está basada en la base de datos vectorial zvec y está disponible como paquete de Node.js. El README describe la implementación en TypeScript/Node.js, y el repositorio incluye una implementación independiente en Rust.

¿zvec-grep es gratuito? ¿Qué licencia tiene?

zvec-grep es open source bajo la licencia Apache-2.0. Revisa los términos de la licencia antes de usarlo en productos comerciales.

¿zvec-grep sigue mantenido?

Mantenimiento activo. El último commit de zvec-grep fue el 5 nov 2026.

¿Para qué puedo usar zvec-grep?

Encontrar rutas de código y detalles de arquitectura en un repositorio grande cuando se desconoce el nombre exacto del símbolo. Permitir que un agente de programación con IA busque en un proyecto local y obtenga resultados clasificados con enlaces a las fuentes. Buscar por significado, en lugar de por palabras clave exactas, en una carpeta con documentos y código variados. Realizar búsquedas semánticas privadas sin enviar archivos a un servicio remoto.

¿Cómo se instala zvec-grep?

Instala zg CLI desde npm (requiere Node.js 22 o posterior).: npm install -g @zvec/zvec-grep Indexa tu espacio de trabajo con un modelo de embeddings local.: zg index --embedding local/potion-retrieval-32m Ejecuta una búsqueda desde la terminal.: zg query --human "An unseen creature left a few marks. What did the detective infer?" --limit 3

¿Dónde consigo zvec-grep?

El código fuente y las instrucciones de instalación están en GitHub: https://github.com/zvec-ai/zvec-grep