hermes-chat-ui
Hermes Chat UI es una interfaz web y PWA moderna para usar el agente Hermes en tu dispositivo o servidor propio.
Ficha actualizada 23 sept 2026, 16:40 · upstream 23 sept 2026, 16:23 · release v0.1.2
Qué es hermes-chat-ui
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Hermes Chat UI es un cliente web y PWA autocontenido que permite interactuar con el agente Hermes directamente desde tu navegador, sin necesidad de instalar la versión oficial. Funciona como alternativa independiente a la interfaz del agente Hermes, permitiendo una experiencia de chat completa en cualquier dispositivo (PC, tablet o móvil). La aplicación se conecta al API oficial de Hermes y no instala un runtime modificado, manteniendo la integridad de las sesiones y los datos originales.
La arquitectura permite ejecutar el cliente junto a una instancia local de Hermes para desarrollo rápido, o mantenerlo online en servidores como NAS, VPS o servidores privados. Se soporta acceso mediante PWA con notificaciones push completas, incluyendo demostraciones de envío de imágenes y respuestas en tiempo real. La interfaz incluye funcionalidades avanzadas como la gestión de sesiones, selección de modelos por sesión, historial paginado y persistencia de datos.
El proyecto está diseñado para ser una alternativa segura a la interfaz oficial, permitiendo que usuarios con acceso restringido o preferencias de privacidad puedan interactuar con el agente Hermes sin depender del servidor centralizado. Se recomienda su uso en entornos donde se requiere control total sobre los datos y la experiencia de usuario.
- Interactuar con el agente Hermes desde un dispositivo móvil sin instalar la aplicación oficial
- Usar la interfaz como alternativa a la web oficial para conversaciones privadas o restringidas
- Desarrollar aplicaciones que integran conversas con agentes de IA en entornos locales o privados
- Mantener sesiones de chat activas mientras se ejecutan procesos del agente en segundo plano
- Recibir notificaciones push completas (Web Push) para respuestas nuevas sin necesidad de refrescar la página
- Gestionar múltiples sesiones con diferentes modelos y preferencias de configuración por sesión
- Soporta PWA nativa con notificaciones push completas, incluyendo demostraciones de envío de imágenes en tiempo real
- Permite ejecutar el cliente junto a una instancia local de Hermes para desarrollo rápido sin necesidad de Docker
- Ofrece acceso completo al historial de sesiones y permite seleccionar modelos por sesión individualmente
- Soporta conexión desde dispositivos móviles con notificaciones push, incluso cuando la app está en segundo plano
- Permite abrir conversaciones antiguas directamente desde el historial paginado del cliente
- No incluye autenticación de usuario ni sistema de login integrado; requiere acceso directo al servidor Hermes
- La persistencia de datos se realiza en volúmenes locales y no en un backend centralizado, lo que puede generar conflictos si múltiples dispositivos comparten el mismo volumen
- El uso de Web Push requiere permisos del dispositivo móvil y HTTPS configurado correctamente para funcionar sin interrupciones
- No incluye autenticación multiusuario ni aislamiento entre usuarios; cualquier persona con acceso al servidor puede leer o borrar sesiones
- La conexión a la API Hermes se realiza mediante un proxy interno (HERMES_PROXY_PORT), lo que puede ser problemático en entornos de producción donde no se permite el uso de proxies
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.
Para desplegar, necesitas Docker Compose v2 y una instancia activa de Hermes con las capacidades de sesión y modelo. Crea un directorio `hermes-chat-ui-deploy`, copia `docker-compose.ui.yml` y `.env.example`. Edita `.env` configurando la clave API del agente existente y el URL de la API. Si Hermes ya está en Docker, conecta ambos contenedores a una red compartida (ej: `docker network create hermes-internal`). Luego ejecuta `docker compose -f docker-compose.ui.yml up -d`. Verifica que el proceso del cliente esté activo con `check-hermes.js`. Para producción, considera usar HTTPS y un proxy externo para evitar problemas de acceso desde redes restringidas. El volumen local se usa para imágenes, claves de push y registros; mantén ambos volúmenes al actualizar.
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.