knowledge-base
Sistema self-hosted para bases de conocimiento de agentes IA, implementado como binario estático Go que indexa documentos mediante pipelines declarativos y sirve búsqueda híbrida (MCP + REST). Compatible con PostgreSQL/pgvector o SQLite, soporta formatos PDF/DOCX con OCR opcional vía VLMs.
Ficha actualizada 25 sept 2026, 10:55 · upstream 25 sept 2026, 10:33 · release v0.6.0
Qué es knowledge-base
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
andino-kb es una solución self-hosted diseñada específicamente para agentes de IA que requieren acceso a bases de conocimiento en redes privadas o air-gapped. El sistema funciona como un endpoint MCP/REST headless, sin interfaz de chat, donde las descripciones de herramientas están optimizadas para consumo por agentes. Mapea operaciones store/search/get/list/delete 1:1 con el estándar Strands memory tool, permitiendo a agentes intercambiar Bedrock Knowledge Bases por andino-kb sin modificar su comportamiento.
La arquitectura utiliza un binario estático Go (CGO_ENABLED=0) que puede operar con SQLite como almacén predeterminado o pgvector para búsqueda densa y BM25. Los pipelines de indexación son declarativos, soportando fuentes desde directorios locales, repositorios Git, buckets S3/MinIO y escrituras directas por agentes. El sistema incluye herramientas operativas como andino-kb doctor para diagnóstico, endpoints /healthz y /readyz, métricas Prometheus, y comandos eval/parity para evaluar cambios en recall antes de migraciones.
- Agentes Claude Code/Cursor conectados vía MCP HTTP a bases de conocimiento privadas
- Runtimes de agentes Strands que requieren memoria durable y buscable sin dependencias externas
- Implementación on-premise o air-gapped para redes corporativas con requisitos de seguridad estrictos
- Migración desde AWS Bedrock Knowledge Bases manteniendo la misma interfaz semántica para agentes
- Binario estático Go sin dependencias externas, compatible con CGO_ENABLED=0 para despliegues aislados
- Soporte nativo para protocolos MCP (streamable HTTP) y REST en un único endpoint port 8180
- Búsqueda híbrida combinando BM25 + vectores densos con Reciprocal Rank Fusion y reranking opcional
- Herramientas operativas integradas: doctor, eval, parity para diagnóstico y evaluación de recall
- No incluye Dockerfile ni compose, requiriendo gestión manual de contenedores si se desea
- Sin interfaz de usuario gráfica, solo endpoints headless para agentes
- OCR opcional depende de modelos VLM externos configurados por el usuario
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.
Desplegar en VM con 4 núcleos CPU, 8GB RAM y 20GB disco mínimo. Ejecutar go install github.com/andino-agents/knowledge-base/cmd/andino-kb@v0.5.0 para obtener el binario. Configurar archivo YAML antes de indexar. Expone MCP en http://localhost:8180/mcp por defecto (loopback). Consultar docs/deployment.md#security antes de exponer a red externa. Usar ANDINO_KB_API_KEY con scope read o readwrite según necesidad.
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.