kana-hermes
Kana es una capa de presentación para Hermes Agent que añade un asistente animado Live2D con voz en japonés, sincronización labial y autenticación segura. Funciona como interfaz gráfica sin modificar el agente subyacente.
Ficha actualizada 26 sept 2026, 12:18 · upstream 26 sept 2026, 12:08 · release v0.3.2
Qué es kana-hermes
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Kana transforma la experiencia del Hermes Agent añadiendo una capa de interfaz visual basada en Live2D. No es un agente independiente, sino una presentación que se conecta a una instancia existente de `hermes serve`. Esto garantiza que las herramientas, archivos y memoria del agente original funcionen sin alteraciones.
La arquitectura utiliza Next.js con Node.js 22.13+ y Python para el motor de voz local (Irodori-TTS v4.1 Anime). El sistema maneja la traducción de eventos de Hermes a un modelo interno que controla el guion, el registro de actividad y las emociones del avatar. La sincronización labial sigue el audio generado, y la interfaz soporta temas claros/oscuros con fondos personalizables.
La seguridad está diseñada desde el inicio: el token de sesión de Hermes permanece en el servidor Kana, y el navegador solo se comunica a través de un relay autenticado. No se almacenan contraseñas ni secretos en el cliente. El sistema soporta comandos slash para control del agente, incluyendo `/restart`, `/reload` y gestión de sesiones.
- Visualización interactiva de agentes Hermes con avatares animados y voz sintética local.
- Gestión de sesiones de chat persistente con historial sincronizado entre dispositivos.
- Entornos de desarrollo donde se requiere control visual sobre herramientas MCP y modelos.
- Interfaz segura para usuarios que prefieren no exponer tokens directamente en el navegador.
- Arquitectura local-first: el motor de voz Irodori-TTS v4.1 Anime corre en CPU sin GPU ni Python adicional.
- Integración nativa con Live2D (Haru/Mao) y soporte para importación de modelos personalizados.
- Seguridad reforzada: autenticación por contraseña con bloqueo temporal, sin dependencia de IP.
- Compatibilidad con múltiples proveedores TTS externos vía Pollinations (ElevenLabs, Qwen, etc.).
- Gestión de archivos Hermes: previsualización directa de audio, video y documentos en lugar de rutas.
- Requiere Linux x64 con glibc; no soporta Windows ni macOS nativamente.
- Dependencia obligatoria de una instalación previa de Hermes Agent (`hermes serve`).
- El motor TTS local consume recursos CPU significativos en hardware modesto.
- No incluye contenedores Docker o scripts de orquestación (Compose).
- La interfaz gráfica no es portable entre sistemas sin configuración manual del directorio de datos.
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 despliegue en VPS, usar `kana serve` con autenticación por contraseña establecida previamente. Ejecutar como el mismo usuario que gestiona Hermes para permitir lectura del token de sesión. Configurar Nginx delante con HTTPS, desactivar buffering en `/api/hermes/events` y permitir `client_max_body_size 14m`. Nunca usar `npm run dev` en producción. El directorio de datos debe residir en `$KANA_DATA_DIR` o la ruta por defecto del usuario.
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.