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 — indique un dominio para el Dashboard (p. ej. my-hermes). Opcionalmente, configure ya su proveedor LLM definiendo LLM_API_KEY, LLM_BASE_URL y LLM_MODEL (cualquier proveedor compatible con OpenAI); déjelos en blanco para configurar el modelo más tarde.
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.

¿Prefiere otro proveedor o Telegram? Defina las variables de su proveedor compatible con OpenAI (LLM_API_KEY / LLM_BASE_URL / LLM_MODEL) y añada las variables de entorno de mensajería 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

Esta plantilla funciona con cualquier proveedor compatible con OpenAI que usted aporte. Configure lo siguiente en la pestaña Variables y reinicie:

• Clave API — ponga LLM_API_KEY con la clave de su proveedor.
• Endpoint — ponga LLM_BASE_URL con la URL base compatible con OpenAI del proveedor, p. ej. https://api.openai.com/v1. Si define una clave pero deja el base URL vacío, el agente dará error hasta que lo indique — es intencional para que un error de configuración sea visible.
• Modelo — ponga LLM_MODEL con el id del modelo, p. ej. gpt-4o-mini.
• Otro proveedor (Minimax, Kimi, GLM/Zhipu, Gemini, NVIDIA, xAI, …) — defina LLM_API_KEY / LLM_BASE_URL / LLM_MODEL para ese proveedor, o añada la variable de entorno con la clave API propia del 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.

Cuando LLM_API_KEY está definida, LLM_API_KEY / LLM_BASE_URL / LLM_MODEL se aplican al bloque model de /opt/data/config.yaml en cada arranque (proveedor custom). Deje LLM_API_KEY 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.