Hermex: controla tu Hermes Agent desde el iPhone

La experiencia de Hermes Agent autoalojado ha estado históricamente atada al navegador de escritorio. O estabas en tu Mac o abrías un panel web de forma remota. Funcionaba, pero la experiencia móvil siempre parecía de segunda categoría: cuadros de entrada pequeños, recargas pesadas e interacciones que parecían forzadas desde una interfaz de escritorio.

Hermex busca cambiar eso. Es un control remoto nativo para iPhone de Hermes Agent, escrito en Swift y SwiftUI, que lleva la experiencia de gestión de IA autoalojada al teléfono.

No es un envoltorio web

El punto más fuerte —y más fácil de pasar por alto— de Hermex es que es una app nativa, no un WebView que envuelve hermes-webui para parecer nativo.

Eso significa:

  • Las respuestas de chat en streaming usan renderizado nativo SSE, no sondeos web
  • La interfaz está rediseñada para iOS 18 con una estética glass-forward
  • Las credenciales de inicio de sesión viven en el Keychain de iOS, gestionado a nivel del sistema
  • La lista de sesiones, Tasks, Skills y el navegador de archivos son vistas nativas independientes
  • La caché sin conexión de solo lectura de sesiones recientes funciona sin red

En resumen, Hermex no es “una página web metida en una app”. Es “las capacidades de Hermes reconstruidas para móvil”.

Requiere un servidor Hermes autoalojado

Hermex no aloja ni ejecuta IA por sí mismo. Es un cliente puro. Necesitas ejecutar el servicio WebUI de Hermes en una computadora, NAS o servidor que controles (el upstream suele ser nesquena/hermes-webui).

Una configuración típica se ve así:

Tu iPhone
    ↓ HTTPS
Cloudflare Tunnel (o Tailscale)
    ↓ HTTP
hermes-webui ejecutándose en 127.0.0.1:8787
    ↓ llamadas locales
Hermes Agent + toolchain

El teléfono es solo el plano de control; la computación y los datos permanecen en tu propia máquina. Este patrón “teléfono como cabina de control, computadora como motor” conserva los beneficios de privacidad del autoalojamiento añadiendo comodidad móvil.

Funciones principales

1. Chat nativo + cadena de razonamiento visible

Hermex admite enviar mensajes, archivos adjuntos e imágenes, y ver la salida del agente en tiempo real. Más importante aún, conserva los detalles de thinking y tool-call: puedes ver qué está razonando Hermes, qué herramientas invocó y por qué eligió ese camino.

Para usuarios acostumbrados a la vista de razonamiento de Claude o Cursor, esta transparencia resulta familiar.

2. Cambio de modelo y perfil

Si tu servidor está configurado con varios modelos o proveedores, Hermex te permite cambiar directamente en la app:

  • Cambiar modelos
  • Cambiar el esfuerzo de razonamiento (reasoning effort)
  • Cambiar perfiles de agente
  • Cambiar workspaces

No es necesario volver al servidor para editar variables de entorno: basta con tocar unas pocas veces en el teléfono.

3. Gestión de sesiones

Crear, renombrar, eliminar, fijar, archivar y mover sesiones a proyectos. La función Proyectos te permite organizar conversaciones por dimensión de trabajo en lugar de amontonarlas en una sola lista.

4. Tasks: consulta cron jobs sobre la marcha

Las Tasks de Hermes son tareas programadas o recurrentes. Hermex proporciona un panel de solo lectura para revisar:

  • Qué tareas están en ejecución
  • La próxima hora de ejecución
  • El estado histórico de ejecución

Cuando estás fuera, una mirada rápida confirma que tu pipeline de automatización sigue funcionando.

5. Skills: explora las skills instaladas del agente

Las Skills de Hermes son plugins de capacidad. Hermex te permite ver qué skills están instaladas en el servidor, buscarlas y explorarlas rápidamente. Aunque aún no puedes instalarlas directamente desde la app, ya es útil para inventario móvil y compartir listas.

6. Navegador de archivos del workspace

Los agentes generan y modifican archivos a medida que trabajan. Hermex incluye un navegador de archivos que te permite:

  • Explorar la estructura del directorio de trabajo
  • Abrir archivos de texto
  • Ver código con resaltado de sintaxis (Splash para Swift, Highlightr para el resto)

No necesitas SSH de vuelta a la máquina ni abrir un editor de escritorio: puedes revisar resultados en el metro.

7. Memory & Insights: paneles de solo lectura

  • Memory: ver el conocimiento que el agente ha recordado
  • Insights: ver consumo de tokens, estadísticas de uso y otros análisis

Para quienes quieren observar el comportamiento a largo plazo del agente y optimizar costos, estos son los dos paneles móviles más útiles.

Despliegue: tres modos de conexión

Hermex admite tres rutas de conexión, ordenadas por nivel de seguridad recomendado:

Método Caso de uso Nota de seguridad
Cloudflare Tunnel Recomendado, dominio público con TLS real Establece una contraseña fuerte HERMES_WEBUI_PASSWORD
Tailscale Sin exposición pública, LAN virtual directa Ideal para usuarios que ya usan Tailscale
Simulador local Pruebas de desarrollo, servidor y app en el mismo Mac Solo para http://localhost:8787

Pasos de configuración (Cloudflare Tunnel)

  1. Inicia hermes-webui en macOS/Linux/Windows:
export HERMES_WEBUI_PASSWORD="tu-contraseña-fuerte"
python server.py
  1. Usa Cloudflare Tunnel para exponer http://127.0.0.1:8787 a un dominio público.
  2. Descarga Hermex en tu iPhone, introduce la URL del servidor y la contraseña, y conéctate.

Stack tecnológico: ¿por qué Swift nativo?

El README y la especificación del proyecto de Hermex son claros sobre el stack:

  • Framework de UI: SwiftUI, iOS 18+
  • Redes: URLSession nativo
  • Streaming SSE: LDSwiftEventSource
  • Renderizado de Markdown: swift-markdown-ui
  • Resaltado de sintaxis: Splash + Highlightr
  • Caché local: SwiftData
  • Almacenamiento de credenciales: Keychain

Esto mantiene la app ligera y evita librerías de UI de terceros pesadas, ajustándose a la filosofía de “equipo pequeño, alto control”.

Relación con el upstream

Hermex es un cliente comunitario independiente, no afiliado a Hermes ni al proyecto hermes-webui. Se comunica con el servidor a través de las APIs HTTP + SSE del upstream y verifica activamente el comportamiento de los endpoints.

La especificación del proyecto dice:

“No inventes endpoints; verifícalos contra el servidor en ejecución.” “El formato de red es la fuente de la verdad.”

Esa actitud pragmática es encomiable: no inventar interfaces, no bifurcar el upstream, solo hacer lo que un cliente debe hacer.

¿Quién debería usar Hermex?

Hermex no es para todos. Es mejor para:

  • Usuarios que ya ejecutan un Hermes Agent autoalojado
  • Personas que quieren ver o intervenir en un agente mientras están fuera del escritorio
  • Usuarios móviles que exigen una experiencia nativa y no aceptan un navegador como solución
  • Gestores técnicos que necesitan que los agentes sigan ejecutándose mientras supervisan el estado desde el teléfono

Si aún no has autoalojado Hermes, Hermex no lo hará por ti. Es más bien una extensión que mueve capacidades existentes del escritorio al bolsillo.

Resumen

  • Hermex es un cliente iOS nativo para Hermes Agent, no un envoltorio web.
  • Tú traes tu propio servidor hermes-webui; se conecta mediante Cloudflare Tunnel o Tailscale.
  • Funciones principales: chat nativo, vista de razonamiento, cambio de modelo/perfil, gestión de sesiones, Tasks, Skills, navegador de archivos del workspace, paneles de Memory e Insights.
  • Las credenciales se almacenan en Keychain; admite caché sin conexión de solo lectura; requiere iOS 18+.
  • Ideal para usuarios que ya ejecutan Hermes y necesitan una superficie de control móvil.

Referencias: