Chat en streaming con Markdown
Las respuestas llegan en streaming y se renderizan como Markdown de GitHub saneado, de modo que los bloques de código, las tablas y las listas se mantienen legibles.
KocoUI · Código abierto · MIT
KocoUI: su propia interfaz web para Hermes Agent
Una aplicación PHP autoalojada que pone un agente de Hermes detrás de su propio dominio: chat en streaming, aprobaciones de herramientas, archivos e inicio de sesión con TOTP. El agente se queda en el servidor y la clave de API nunca llega al navegador.
Producto
Qué es KocoUI
KocoUI es una interfaz web propia para Hermes Agent, escrita en PHP. El navegador habla con la aplicación PHP, la aplicación habla con un gateway de Hermes existente en localhost, y la clave de API permanece en config.php fuera del directorio público. El proceso web nunca ejecuta el agente y el navegador nunca se conecta al puerto de Hermes.
PHP es una decisión deliberada: es lo que ya ejecutan la mayoría de los servidores web. El backend no tiene dependencias de Composer, así que la pila es nginx, PHP-FPM y SQLite. El frontend es Preact y se sirve como recursos estáticos. El acceso es una contraseña más un código TOTP, y los usuarios se crean en el servidor, no mediante un formulario de registro.
Funciones
Qué hace la interfaz
Aprobaciones en lugar de sorpresas
Cuando el agente quiere ejecutar un comando, una tarjeta en línea pide una vez, sesión, siempre o denegar. Las aprobaciones siguen siendo manuales en el lado de Hermes.
Corregir o detener un turno
Envíe una corrección a un turno que ya está trabajando, o deténgalo, sin iniciar una conversación nueva.
Modelos, herramientas, skills, tareas
Elija el modelo, vea qué herramientas y skills tiene el agente y gestione las tareas programadas desde la misma interfaz.
Archivos de ida y vuelta
Suba archivos con un botón, arrastrando o pegando. Los documentos e imágenes que el agente devuelve aparecen en un álbum con visor.
Persona, temas, idiomas
Edite el SOUL.md del agente en el mismo lugar, alterne entre claro y oscuro y use la interfaz en inglés, alemán o español.
La interfaz
Capturas del repositorio: el chat en móvil y escritorio, la vista de archivos y el selector de tema. Todo es la misma aplicación que sirve la demo.
Chat, persona, aprobaciones, herramientas y archivos en móvil. 
Subidas y archivos que el agente devuelve, en una sola vista. 
Claro u oscuro, con un color de acento por operador.
Todo a un clic
La demo, el código, los pasos de instalación y las notas de seguridad son públicos.
- DemoPruébelo en el navegadorLa interfaz real con conversaciones de ejemplo. Sin registro, sin instalar nada, sin romper nada.
- CódigoRepositorio en GitHubBackend PHP 8, frontend Preact, pruebas y registro de cambios. Licencia MIT.
- InstalaciónGuía de instalaciónUbuntu 24.04 o 26.04 con Hermes ya en marcha, un nombre DNS y Node 20.19+ en su equipo.
- SeguridadModelo de seguridadArgon2id y TOTP obligatorio, reglas de sesión y CSRF, y a qué puede llegar el acceso una vez dentro.
Preguntas frecuentes
Preguntas antes de instalar
¿KocoUI es el agente?
No. KocoUI es una interfaz. Necesita un Hermes Agent existente en el mismo servidor, con la API del gateway escuchando en 127.0.0.1:8642.
¿Dónde vive la clave de API?
En config.php fuera del directorio público, en el servidor. El navegador nunca la recibe y nunca se conecta al puerto de Hermes.
¿Cómo inician sesión los usuarios?
Con una contraseña y un código TOTP obligatorio. Las cuentas se crean en el servidor con bin/kocoui; no hay registro abierto ni restablecimiento de contraseña en el navegador.
¿Qué necesito para ejecutarlo?
Un VPS con Ubuntu 24.04 o 26.04 y Hermes ya instalado, un nombre DNS para la interfaz y Node 20.19+ o 22.12+ en su equipo para compilar el frontend.
¿Está listo para producción?
Es la versión 0.x, pensada para un solo operador. Las notificaciones push son best effort y el acceso no aísla al agente, así que trate el inicio de sesión como la puerta de entrada de esa máquina.
¿Cuánto cuesta?
Nada. KocoUI es código abierto bajo licencia MIT y se ejecuta en su propio servidor.
Pruébelo
Abra la demo y luego lea el código
La demo es la interfaz real con datos de ejemplo: navegue por chats, archivos, herramientas y la página de persona. Cuando la quiera en su propio dominio, la guía de instalación cubre el lado del servidor.