Hermes Agent

Hermes Agent es un agente de IA autónomo desarrollado por Nous Research. Cuenta con memoria persistente, más de 40 herramientas integradas, programación de tareas y soporte de mensajería multiplataforma.

Inicio rápido

1. Despliegue esta plantilla — introduzca su clave API de OpenRouter (obligatoria) y opcionalmente un token de bot de Telegram.
2. Vincule un dominio — vaya a la pestaña Redes y vincule un dominio al puerto que necesite (consulte «Puertos y dominios» más abajo).
3. Comience a usar — a través del Dashboard web, Telegram o la API compatible con OpenAI.

Puertos y dominios

Este servicio expone dos puertos HTTP independientes. Vincule un dominio solo a los puertos que realmente necesite:

Puerto	Propósito	Cuándo vincular un dominio
5000	Servidor API compatible con OpenAI	Solo si necesita acceso externo a la API (curl, SDK, etc.)
9119	Dashboard web (requiere HERMES_DASHBOARD=true)	Solo si quiere la interfaz de navegador

Las plataformas de mensajería (Telegram, Discord, Slack, etc.) usan conexiones salientes — no requieren URL pública ni puertos abiertos.

Usar la API compatible con OpenAI

Vincule un dominio al puerto 5000 y envíe solicitudes con su clave API generada automáticamente:

curl https://YOUR_DOMAIN/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_SERVER_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "default", "messages": [{"role": "user", "content": "Hello!"}]}'

Usar el Dashboard web

1. Configure HERMES_DASHBOARD=true en la pestaña Variables y reinicie el servicio.
2. Vincule un dominio al puerto 9119 en la pestaña Redes.
3. Acceda al Dashboard mediante ese dominio.

Nota de seguridad: El Dashboard será públicamente accesible desde internet. No lo active sin entender los riesgos — cualquier persona con la URL puede acceder y controlar su agente. Puede configurar autenticación OAuth mediante HERMES_DASHBOARD_OAUTH_CLIENT_ID (consulte la referencia de variables de entorno).

Plataformas de mensajería

Telegram se configura durante el despliegue como ejemplo. Puede activar cualquiera de las más de 14 plataformas compatibles (Discord, Slack, WhatsApp, Signal, Matrix, Email, WeChat, WeCom, Feishu, DingTalk, QQ Bot, Mattermost, BlueBubbles/iMessage, SMS, Home Assistant, webhooks genéricos) configurando las variables de entorno correspondientes después del despliegue.

Consulte la guía oficial de Messaging Gateway para instrucciones de configuración de cada plataforma.

Usando Zeabur AI Hub (alternativa a OpenRouter)

En lugar de una clave de OpenRouter, puede usar Zeabur AI Hub — un agregador compatible con OpenAI. Tras el despliegue:

1. Ponga su clave de AI Hub en OPENROUTER_API_KEY (reutilice la misma variable).
2. Edite /opt/data/config.yaml desde la pestaña «Archivos» de Zeabur:
   • model.base_url: "https://sfo1.aihub.zeabur.ai/v1" (use hnd1 para Tokio)
   • model.default: "claude-sonnet-4-5" (o cualquier modelo de AI Hub)
3. Reinicie el servicio.

Nota: la variable de entorno OPENROUTER_BASE_URL no sobrescribe config.yaml; debe editar el archivo.

Configuración

• Proveedores de LLM, herramientas y demás ajustes — consulte la guía oficial de Configuration y la referencia de variables de entorno.
• Edite los archivos de configuración en /opt/data/ a través de la pestaña «Archivos» de Zeabur:
  • config.yaml — selección de modelo, backend de terminal, configuración de plataformas
  • SOUL.md — personalidad del agente y prompt del sistema
  • .env — todas las variables de entorno
• Después de editar, reinicie el servicio para aplicar los cambios.

Acceso CLI

Puede usar la CLI de Hermes directamente desde la pestaña Exec de Zeabur (o zeabur service exec):

Comando	Descripción
hermes	Chat interactivo (REPL)
hermes --tui	Interfaz de terminal moderna
hermes -z "prompt"	Consulta única (para scripts)
hermes status	Estado de todos los componentes
hermes model	Cambiar modelo / proveedor
hermes config	Ver o editar configuración
hermes sessions list	Listar conversaciones
hermes -c	Reanudar última conversación
hermes cron	Gestionar tareas programadas
hermes skills	Explorar e instalar habilidades

Ejecute hermes --help para ver la lista completa de comandos.

Notas

• La imagen Docker es de ~4.5 GB (incluye Playwright + Chromium para automatización del navegador). El primer despliegue puede tardar varios minutos en descargar la imagen.
• El primer arranque tarda 30-60 segundos en inicializar los archivos de configuración y sincronizar las habilidades.
• El uso de herramientas del navegador puede causar un alto consumo de memoria — si encuentra errores OOM (memoria insuficiente), considere actualizar a una instancia mayor (recomendado 4 vCPU / 8 GB RAM).

Licencia

Hermes Agent está licenciado bajo la Licencia MIT por Nous Research.