honcho-dashboard
Dashboard auto-alojado para Honcho desarrollado con Next.js y React. Proporciona monitorización en tiempo real de flotas, gestión de workspaces, sesiones y conclusiones mediante la SDK oficial.
Ficha actualizada 25 sept 2026, 19:33 · upstream 25 sept 2026, 19:10 · release v1.2.1
Qué es honcho-dashboard
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Es un panel de control auto-alojado para la plataforma Honcho. Construido con Next.js 16, Tailwind CSS v4 y Framer Motion, utiliza la SDK oficial @honcho-ai/sdk para interactuar con workspaces, peers, sesiones y conclusiones. Ofrece una interfaz oscura "Memory Console" y permite gestionar flotas, backlogs de tareas y estados de instancias.
La arquitectura se divide en tres capas: SDK nativo para flujos de datos, un cliente raw para brechas verificadas del SDK (como gestión de workspaces o trazas) y módulos de operador. Estos últimos leen la base de datos PostgreSQL de Honcho con permisos de solo lectura para exponer métricas como tamaño de DB, estado pgvector, logs y trazas de llamadas a LLM sin modificar el servidor principal.
Incluye un proxy de mismo origen (/api/honcho/[...path]) que evita problemas de CORS y permite listas blancas de URLs upstream. Ofrece seguridad por defecto con un interruptor maestro para acciones de escritura, validación de conexiones multi-instancia y degradación elegante cuando los módulos de operador no están configurados. Soporta despliegue vía Docker o desarrollo local.
- Monitorización de flota: Visualizar colas de trabajo, backlogs y métricas de throughput en tiempo real para múltiples workspaces.
- Gestión de sesiones y datos: Navegar por sesiones, subir documentos (PDF/JSON), buscar mensajes y gestionar conclusiones derivadas con trazabilidad de origen.
- Diagnóstico y auditoría: Inspeccionar trazas de llamadas a LLM, logs del servidor y estado de la base de datos para depurar fallos o cuellos de botella.
- Integración de agentes: Configurar webhooks para conectar agentes externos (MCP, Claude Code) con el servidor Honcho mediante endpoints registrados.
- Gestión multi-instancia: Conectar el dashboard a varios servidores auto-alojados de Honcho y alternar entre ellos usando tokens de autenticación opcionales.
- Contexto mejorado: Ensamblar contexto LLM listo para uso desde tarjetas de pares, conclusiones y mensajes con control de presupuesto de tokens.
- SDK oficial @honcho-ai/sdk versión 2.5.1+ para consultas nativas a la API de Honcho.
- Capa de operador con lectura segura en PostgreSQL para métricas avanzadas (throughput, heatmap) sin tocar datos operativos.
- Proxy de mismo origen que centraliza las llamadas y permite listas blancas de URLs upstream (HONCHO_PROXY_ALLOWED_BASES).
- Interfaz oscura "Memory Console" con estados de carga y error robustos en todas las rutas de datos.
- Soporte para múltiples instancias de Honcho con autenticación opcional mediante tokens bearer.
- Degradación elegante: Los módulos de operador se desactivan visualmente si no hay variables de entorno configuradas.
- Requiere Honcho 3.1.2+ para métricas de backlog y 3.2+ para evidencia en chat y trazas de derivación.
- Las acciones de escritura (crear/editar/borrar) requieren permisos explícitos en la base de datos o el interruptor maestro desactivado por defecto.
- Los módulos de operador dependen de variables de entorno específicas (HONCHO_DATABASE_URL, HONCHO_LOG_FILE) para funcionar; si no están, se muestran como no disponibles.
- La SDK actual está bloqueada a la versión 2.5.1+, lo que podría limitar funcionalidades futuras hasta actualizar el paquete.
- Los datos mostrados en la vista previa inicial son sintéticos (fixtures de Honcho 3.2) y no reflejan datos reales hasta configurar la conexión.
Capturas del proyecto
Imágenes reales detectadas en la documentación del repositorio.
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.
Se recomienda usar el archivo docker-compose-example.yml como base. Configurar HONCHO_BASE_URL para apuntar al servidor Honcho y HONCHO_PROXY_ALLOWED_BASES en las variables de entorno. Para la capa de operador, montar los logs del servidor (HONCHO_LOG_FILE) y proporcionar una DSN de PostgreSQL de solo lectura (HONCHO_DATABASE_URL). Construir desde fuente es posible descomentando el bloque build: en el archivo Compose.
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.