Referencia open-source con Nuxt 3 + pgvector para equipos que despliegan RAG — y un track de aprendizaje para devs que empiezan desde cero.
Click to copy
¿Qué es hypar?
RAG (Retrieval-Augmented Generation) permite a una IA responder preguntas desde tus propios documentos — pero RAG en producción es difícil: estrategia de chunking, búsqueda híbrida, ingestión durable, citas, evaluaciones. hypar es una app de referencia en TypeScript completamente funcional. Lee el código como un tutorial, arráncala localmente en minutos y adapta los patrones a tu stack.
Prueba en el demo:
Precargado con los docs de hypar — pregunta lo que quieras.
Ejecutar localmente
git clone https://github.com/albegosu/hypar.git
cd hypar
cp .env.example .env
# Edit .env — set GOOGLE_API_KEY at minimum
docker compose --profile full up -d --build
open http://localhost:3000Arquitectura en un vistazo
Leer la arquitectura completa →Qué incluye
Búsqueda híbrida
Similitud coseno de pgvector combinada con BM25 y diversificación MMR.
Embeddings multi-proveedor
Gemini, OpenAI u Ollama. Cambia en runtime sin re-ingestar.
Ingestión durable
Workflow SDK con reintentos por paso; estado consultado, nunca perdido en reinicios.
Suite Vitest
Chunking, utilidades de texto, comandos de agente y búsqueda cubiertos en CI.
Citas de fuentes
Marcadores [1], [2] persistidos en cada mensaje del asistente y auditados.
Rate limits y APIs de admin
30/min chat, 10/min subida. /api/admin/* acepta sesión iniciada o ADMIN_API_KEY.
Roadmap — 10 etapas
Ver el roadmap completo →01 · Now
Traceability
02 · Next
Measurable quality
03
SOTA retrieval
04
Robustness
05
Pluggable
06
Beyond text
07
Real memory
08
Knowledge graph
09
Self-hosted
10
Live product