mesh
Mesh es un repositorio open source que proporciona un sistema de búsqueda y recuperación de conocimiento basado en documentos (FTE) con soporte para vectores y re-ranking.
Ficha actualizada 23 sept 2026, 10:35 · upstream 23 sept 2026, 10:15 · release v0.2.0
Qué es mesh
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Mesh es un software soberano de conocimiento único en formato binario, diseñado específicamente para agentes de programación (como Claude Code o Codex). Su arquitectura central se basa en un motor de búsqueda basado en FTE (Full-Text Search) que indexa documentos Markdown y permite consultas semánticas mediante vectores. El sistema no contiene modelos de IA ni servicios externos; todo corre dentro de un único binario compilado en Go, lo que garantiza una latencia mínima y baja dependencia de recursos computacionales.
La arquitectura se divide en dos componentes principales: el motor Mesh (que realiza indexación, búsqueda y recuperación) y el agente (como Claude Code), quien actúa como bibliotecario. El agente lee las tarjetas de resultado del motor y selecciona manualmente las notas relevantes para consultar. Esto permite que el agente sea mucho más eficiente que un modelo de IA puro, ya que puede leer solo una nota en lugar de toda la base de conocimiento.
Mesh soporta múltiples tecnologías: Next.js para la interfaz web, Node.js como backend, Go como lenguaje principal y PostgreSQL/MongoDB como bases de datos. También incluye un motor de vectores opcional (embeddings) y un re-ranking con cross-encoders o modelos locales.
- Agentes de desarrollo autónomos que consultan documentación técnica sin necesidad de leer archivos enteros
- Sistemas de recuperación de conocimiento para equipos distribuidos que necesitan acceso a notas técnicas compartidas
- Entornos de CI/CD donde el agente debe consultar documentación y resolver problemas basados en conocimiento previo
- Herramientas de productividad que integran búsqueda semántica con agentes de IA para acelerar la investigación técnica
- Sistemas de gestión de proyectos que consulten documentación de requisitos, arquitectura y decisiones pasadas
- Es un único binario compilado en Go sin dependencias externas ni cgo, lo que reduce la complejidad de despliegue
- Soporta consultas vectoriales (embeddings) para búsqueda semántica sobre documentos no relacionados
- Ofrece re-ranking con cross-encoders o modelos locales como alternativa al modelo predeterminado
- Permite indexación determinística y reproducible mediante comandos como `mesh code reindex <vault> --through-owner`
- Incluye un motor de vectores opcional que mejora la recuperación para consultas semánticas complejas
- Soporta múltiples interfaces: CLI, TUI (terminal) y web (browser app)
- No incluye modelos de IA ni servicios externos por defecto; el agente debe ser capaz de interpretar las tarjetas de resultado
- La búsqueda vectorial requiere un backend externo o modelo local que no está incluido en la distribución base
- El re-ranking con cross-encoders puede consumir recursos adicionales y no siempre mejora la precisión
- No tiene soporte nativo para bases de datos NoSQL como MongoDB (aunque el README lo menciona)
- La recuperación de base de datos requiere un backup externo, ya que los datos en `.mesh/mesh.db` son inmutables una vez indexados
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Para desplegar Mesh: 1) Construir con `make build` o usar `go install github.com/bright-interaction/mesh/cmd/mesh@latest`. 2) Instalar en un servidor (Linux/macOS): `brew install go && brew link --overwrite /usr/local/opt/go/bin/go && mesh tui --vault my-vault`. 3) Para Windows, el enlace de binario se genera automáticamente. 4) Conectar a un agente: `mesh install my-vault --client codex` o `claude-code`. 5) Usar `mesh watch` para indexación en tiempo real y `mesh doctor` para verificar integridad del índice. 6) Para producción, implementar backups de `.mesh/mesh.db`, configurar el re-ranking con un modelo local (Ollama) o usar cross-encoders, y asegurar que el agente tenga acceso a los vectores necesarios.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.