La guía completa.

Hermes Console es la app Android. Hermes Agent es tu agente AI self-hosted, corriendo donde tú decidas. Entre medias no hay nube de nadie: la app habla directamente con tu servidor.

En el servidor conviven tres servicios, y conocerlos ayuda a entender todo lo demás:

• Gateway (puerto 8642) — el cerebro: chat, sesiones y streaming.
• Dashboard (puerto 9119) — memoria, cron, skills, modelos y configuración.
• Mobile Bridge (puerto 9131) — el servicio companion de la app: emparejado, aprobaciones y mantenimiento remoto.

El instalador de un comando (siguiente sección) levanta los tres como servicios de usuario de systemd: sobreviven reinicios sin que toques nada.

• Móvil: Android 7.0 o superior. Sin cuentas, sin servicios de Google.
• Servidor: un Linux con systemd — vale un VPS pequeño, un homelab o ese mini-PC que tienes en un cajón. Ahí corre tu Hermes Agent.
• Red: que el móvil alcance el servidor — misma LAN, una red Tailscale (recomendado fuera de casa) o HTTPS directo.

En tu servidor, ejecuta:

curl -fsSL https://raw.githubusercontent.com/xP3ta/hermes-setup/main/hermes-mobile-setup.sh | sh

El script es idempotente (puedes relanzarlo sin miedo) y hace esto, en orden:

1. Instala Hermes Agent si no está.
2. Garantiza una API key (API_SERVER_KEY en ~/.hermes/.env) — si ya existe, no la rota.
3. Levanta Gateway, Dashboard y Mobile Bridge como servicios systemd de usuario con arranque automático.
4. Detecta tu mejor IP (prioriza Tailscale, luego LAN privada) y evita exponerte a internet sin avisarte.
5. Imprime un QR de emparejado en el terminal, listo para escanear.

¿Quieres verificar que todo vive? systemctl --user status hermes-gateway hermes-dashboard hermes-bridge

Camino rápido — QR. Abre Hermes Console, elige «Conectar a mi servidor» y escanea el QR que imprimió el instalador. Fin: host, puerto, token y dashboard se configuran solos. Si estás en el móvil y el QR está en la misma pantalla, también puedes abrir el enlace hermes://pair?… directamente.

Camino manual. En la pantalla de conexión introduce:

• Host — IP de LAN (192.168.x.x), IP de Tailscale (100.x.x.x), MagicDNS o https://tu-dominio
• Puerto — 8642 (si usas HTTPS con proxy, el 443 va implícito)
• API key — el valor de API_SERVER_KEY en ~/.hermes/.env del servidor

¿Perdiste el QR? En el servidor: hermes-pair.sh — lo reimprime sin reinstalar nada.

Varias instancias. Puedes guardar más de un servidor (casa, VPS…) y cambiar entre ellos desde el gestor de instancias de la app.

• Chat — streaming token a token, bloques de razonamiento visibles, adjuntos y generación de imágenes en la propia conversación.
• Sesiones — todas las conversaciones del agente, también las que empezaste en el escritorio.
• Kanban — tablero de tareas del agente: backlog, en curso, revisión, bloqueado; plantillas de bug/feature/research.
• Modelos — cambia el modelo activo, catálogo Ollama, y proveedores externos (LM Studio, OpenAI-compatible).
• MoA — recetas Mixture-of-Agents editables desde la app: varios modelos proponen, uno agrega la respuesta final.
• Terminal SSH — shell real con PTY contra cualquier máquina, y navegador SFTP para subir/bajar archivos.
• Cron — jobs programados: crear, editar, pausar, disparar a mano y ver el informe de cada run.
• Memory — lee y edita la memoria persistente del agente, con borradores locales.
• SOUL — el documento de identidad del agente (su persona), editable con plantillas y autosave.
• Skills — explora las skills instaladas en tu agente.
• Task Center — cada ejecución lanzada desde la app, con seguimiento en vivo.
• Aprobaciones — cuando el agente quiere ejecutar algo delicado, te llega con su nivel de riesgo: apruebas o rechazas, incluso desde la notificación.
• Spark — la mascota de Hermes: refleja el estado del agente (pensando, conectando, celebrando).

• Apariencia — 13 temas oscuros y claros (incluido OLED puro y el tema «Hermes Console»), tamaño de texto y selector de fuente.
• Idioma — español e inglés, o el del sistema.
• Seguridad — bloqueo de app con biometría o PIN; la API key vive cifrada en el Android Keystore.
• Notificaciones — aprobaciones y fin de ejecuciones en segundo plano, con un servicio propio: cero Google, cero push de terceros.
• Servidor — desde la propia app: actualizar Hermes, reiniciar el Gateway y reparar/actualizar el Bridge si queda viejo (la app te avisa con un banner).

• «No se puede conectar». Comprueba que móvil y servidor comparten red (¿Tailscale activo en ambos?), que el puerto es 8642 y que los servicios corren: systemctl --user status hermes-gateway.
• Error de certificado TLS. En red privada conecta por LAN o Tailscale (HTTP interno está bien ahí); para un dominio público usa un certificado válido en el proxy.
• El QR caducó o no aparece. hermes-pair.sh en el servidor lo reimprime al momento.
• «Bridge desactualizado». Toca el banner: la app lo repara o actualiza sola por SSH del propio bridge.
• No llegan notificaciones. Activa la escucha en segundo plano en Ajustes → Notificaciones y concede el permiso de notificaciones (Android 13+).

• Conecta por LAN o Tailscale siempre que puedas; no abras 8642/9119 al internet público.
• Si necesitas acceso desde fuera, Tailscale te da una red privada cifrada sin abrir puertos; HTTPS con certificado válido es la alternativa.
• Tu API key nunca sale del móvil salvo hacia tu servidor, y se guarda cifrada en el Keystore.
• El dashboard queda protegido con contraseña desde el primer arranque (el instalador la fija por ti).
• Y lo de siempre aquí: sin telemetría, sin cuentas, sin nube. Política de privacidad completa →