hupi
Gateway de memoria autoalojado compatible con OpenAI que actúa como capa intermedia entre clientes AI/LLM y proveedores, permitiendo cambiar de proveedor sin migrar datos. Arquitectura Go+React+PostgreSQL con CLI tools, admin UI y soporte Docker/Kubernetes.
Ficha actualizada 25 sept 2026, 9:24 · upstream 25 sept 2026, 9:12 · release sin release detectada
Qué es hupi
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
HUPI es un gateway de memoria autoalojado diseñado para funcionar como capa intermedia entre cualquier cliente existente de IA/LLM y el proveedor de modelos que utilices. Habla la API OpenAI Chat Completions en ambos lados, permitiendo apuntar el base_url del cliente a HUPI en lugar de OpenAI/Anthropic u otros proveedores sin modificar nada.
El sistema se construye alrededor de tres propiedades fundamentales: independencia de proveedor (cambiar de GPT a Claude o modelo local sin migrar memoria), integridad sobre conveniencia (cada 'memoria' se verifica contra su fuente antes de ser confiable) y auditabilidad (cada decisión de recuperación se registra e inspecciona posteriormente). La arquitectura utiliza Go para los binarios principales, React para la interfaz de administración y PostgreSQL como base de datos.
El repositorio incluye herramientas CLI completas para operaciones administrativas, consolidación nocturna, verificación de regresión en recuperación, rotación de claves, re-embedding tras cambios de modelo de embedding, exportación/importación de snapshots de memoria cifrados e inspección de trazas de recuperación. La interfaz de administración combina API JSON en Go con frontend React (Vite+TypeScript+Tailwind) embebido mediante go:embed.
El proyecto está licenciado bajo MIT para Tier 1 (Personal) y Tier 2 (Profesional Individual), mientras que Tier 3 (equipos multiusuario con autenticación externa OpenID Connect) es una extensión comercial en repositorio separado hupi-t3. El despliegue soporta instalación bare-metal, Docker Compose (incluye Postgres) y Kubernetes/Helm.
- Actuar como capa de abstracción para cambiar de proveedor LLM sin migrar datos ni reindexar memoria
- Implementar verificación de integridad en cada entrada de memoria antes de confiar en ella
- Auditar todas las decisiones de recuperación y acceder a trazas completas de episodios
- Exportar snapshots cifrados de memoria para portabilidad entre instancias o proveedores
- Integrar con VS Code mediante extensión oficial usando SDK openai apuntando a HUPI
- Arquitectura Go+React+PostgreSQL con binarios compilables standalone sin dependencias externas
- API compatible OpenAI en ambos lados (cliente y proveedor) para máxima interoperabilidad
- CLI tools completas para operaciones administrativas, consolidación nocturna y verificación de regresión
- Licencia MIT permanente para Tier 1/2 con código completamente funcional sin Tier 3
- Soporte nativo para Docker Compose, Kubernetes/Helm e instalación bare-metal
- Tier 3 (multi-tenant con autenticación externa OpenID Connect) requiere repositorio comercial separado hupi-t3
- Funcionalidades de equipos y workspaces compartidos no están presentes en la versión MIT
- Proyecto en desarrollo activo con plan de cierre de gaps documentado
- Algunas rutas /v1/team/* y subcomandos CLI de equipo no existen sin Tier 3
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.
Recomendaciones: usar Docker Compose para despliegue rápido (incluye Postgres), o bare-metal con ./install.sh. Configurar .env.example con tres secretos requeridos y providers.yaml.example antes de iniciar. Para producción, considerar Kubernetes/Helm en deploy/k8s/ o Helm chart en deploy/helm/hupi/. La interfaz de administración requiere build separado del frontend React (npm run build) antes de embeber en binario Go. Verificar docs/INSTALL.md para walkthrough completo.
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.