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 — genere una clave de Zeabur AI Hub e indique un dominio para el Dashboard (p. ej. my-hermes). Eso es todo; el agente y el Dashboard funcionan de inmediato.
2. Abra el Dashboard — vaya a su dominio (vinculado al Dashboard automáticamente). Puede añadir un dominio personalizado más tarde en la pestaña Redes.
3. Inicie sesión — usuario admin, contraseña = el PASSWORD de su servicio (mostrado en las instrucciones del servicio). Chatee en el navegador — sin necesidad de Telegram.

¿Quiere usar OpenRouter, otro proveedor (Minimax, Kimi, …) o Telegram en su lugar? Añada las variables de entorno correspondientes tras el despliegue — consulte Modelos y proveedores y Plataformas de mensajería más abajo.

Puertos y dominios

Este servicio expone dos puertos HTTP:

Puerto	Id	Propósito	Dominio
9119	web	Dashboard web (activo por defecto, protegido con login)	El dominio principal del servicio — ábralo e inicie sesión
5000	api	Servidor API compatible con OpenAI	Vincule un dominio solo si necesita acceso externo a la API

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

Usar el Dashboard web

El Dashboard está activado por defecto y protegido con login. Abra el dominio de su servicio (puerto web) e inicie sesión:

• Usuario: admin
• Contraseña: el valor PASSWORD de su servicio (mostrado en las instrucciones del servicio)

Para desactivarlo, ponga HERMES_DASHBOARD=false en la pestaña Variables. Para cambiar las credenciales, configure HERMES_DASHBOARD_BASIC_AUTH_USERNAME / HERMES_DASHBOARD_BASIC_AUTH_PASSWORD.

Nota de seguridad: La autenticación básica es ideal para un backend en una red de confianza; para una exposición pública reforzada use OAuth (HERMES_DASHBOARD_OAUTH_CLIENT_ID) u OIDC autoalojado (HERMES_DASHBOARD_OIDC_*) — consulte la referencia de variables de entorno.

Usar la API compatible con OpenAI

Vincule un dominio al puerto api (5000) en la pestaña Redes y envíe solicitudes con su clave API generada automáticamente:

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

Plataformas de mensajería

La mensajería es opcional — por defecto interactúa a través del Dashboard web (sin necesidad de ninguna plataforma). Para conectar Telegram, añada TELEGRAM_BOT_TOKEN (de @BotFather) y TELEGRAM_ALLOWED_USERS (su ID de usuario de Telegram, de @userinfobot) en la pestaña Variables y reinicie. Hermes admite más de 14 plataformas (Discord, Slack, WhatsApp, Signal, Matrix, Email, WeChat, WeCom, Feishu, DingTalk, QQ Bot, Mattermost, BlueBubbles/iMessage, SMS, Home Assistant, webhooks genéricos) — cada una se activa configurando sus variables de entorno después del despliegue.

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

Modelos y proveedores

De fábrica, esta plantilla usa Zeabur AI Hub (clave de la variable Clave de Zeabur AI Hub), el modelo claude-sonnet-4-5 y la región sfo1. Para cambiarlo, añada lo siguiente en la pestaña Variables y reinicie:

• Modelo — ponga LLM_MODEL en cualquier modelo de AI Hub.
• Región — ponga LLM_BASE_URL en https://hnd1.aihub.zeabur.ai/v1 para Tokio (por defecto es sfo1).
• OpenRouter en su lugar — configure OPENROUTER_API_KEY (deje vacía la clave de AI Hub); Hermes lo detecta automáticamente.
• Otro proveedor (Minimax, Kimi, GLM/Zhipu, Gemini, NVIDIA, xAI, …) — añada la variable de entorno con la clave API de ese proveedor (p. ej. KIMI_API_KEY, MINIMAX_API_KEY) y elija el modelo con hermes model en la pestaña Exec. Consulte la guía de Configuration y la referencia de variables de entorno.

LLM_MODEL / LLM_BASE_URL y la clave de AI Hub se aplican al bloque model de /opt/data/config.yaml en cada arranque. Déjelas sin configurar para gestionar config.yaml a mano.

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 ~1.3 GB (descarga). El primer despliegue suele descargarse en menos de un minuto; los despliegues posteriores reutilizan la imagen en caché.
• 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.