hermes-webui

name	hermes-webui
description	Interfaz web para Hermes Agent — acceso desde navegador o móvil con paridad 1:1 con la CLI. Tres paneles, sesiones, workspace, voz, perfiles, temas, sin build step.
url	https://github.com/nesquena/hermes-webui
category	herramientas
fecha	2026-06-03T00:00:00.000Z

Hermes WebUI — Interfaz web para Hermes Agent

Paridad 1:1 con CLI · Web & móvil · Sin build step · Vanilla JS + Python

¿Qué hace?

Hermes WebUI es una interfaz web ligera y dark-themed para Hermes Agent. Todo lo que puedes hacer desde la terminal, lo puedes hacer desde este UI web. Sin framework, sin bundler, sin build step — solo Python y JavaScript vanilla.

Layout

• Panel izquierdo — sidebar con sesiones y navegación
• Panel central — chat con el agente
• Panel derecho — explorador de archivos del workspace con vista previa inline
• Footer del composer — model, profile, workspace controls siempre visibles
• Context ring — anillo circular que muestra uso de tokens en tiempo real
• Hermes Control Center — configuración completa, sesión tools, lanzador en la parte baja del sidebar

Características

• Chat con sesiones, tags y cards de tool calls
• Explorador de workspace con vista previa inline de archivos
• Soporte para voz (STT/TTS)
• Múltiples perfiles de modelo
• Temas claro/oscuro
• Diseño responsive para móvil
• Seguridad con contraseña configurable
• Acceso vía SSH tunnel desde cualquier dispositivo

Casos de uso

1. Acceso móvil a Hermes — usar el agente desde el teléfono sin terminal
2. Acceso web remoto — acceder desde cualquier navegador con SSH tunnel
3. Exploración visual de workspace — navegar archivos y ver previews inline
4. Gestión de sesiones — organizar, buscar y filtrar sesiones por tags
5. Desarrollo asistido — interactuar con el agente mientras se trabaja en el navegador

Snippets útiles

Instalación

# Clonar el repositorio
git clone https://github.com/nesquena/hermes-webui.git
cd hermes-webui

# Iniciar con bootstrap
python3 bootstrap.py

# O con start.sh
./start.sh

# O con ctl.sh (control script)
./ctl.sh start

Acceso remoto con SSH tunnel

# En el servidor donde corre Hermes
python3 bootstrap.py

# En tu máquina local
ssh -L 8080:localhost:8080 usuario@servidor
# Acceder a http://localhost:8080

Docker

# Deploy con Docker (single container)
docker build -t hermes-webui .
docker run -p 8080:8080 hermes-webui

# Multi-container con compose
docker compose up

Cómo integrarlo en Mastermind

Opción 1: SSH tunnel (recomendado para uso personal)

# Asegurarse de que Hermes está corriendo
# Configurar SSH tunnel desde máquina local
ssh -L 8080:localhost:8080 root@mastermind-server
# Acceder a http://localhost:8080

Opción 2: Docker en el servidor

# Deploy en el mismo servidor que Hermes
docker compose up -d
# Acceder vía Tailscale o IP directa

Opción 3: Tailscale HTTP Proxy

# Configurar Tailscale para acceso seguro desde cualquier dispositivo
# Sin exponer puertos al público

Pitfalls

• Requiere que Hermes Agent esté corriendo en el mismo servidor
• Sin autenticación por defecto — configurar contraseña en el Control Center
• El SSH tunnel es necesario para acceso remoto seguro
• No requiere API key adicional — usa la misma configuración de Hermes
• Para acceso público, usar reverse proxy con HTTPS (nginx/caddy)

Referencias

• Repositorio GitHub
• Documentación del README

Fecha de descubrimiento

2026-06-07 → 2026-06-08: 12.6k⭐ → 13.9k⭐ (+1.3k), trending diario+semanal