Cómo instalar el agente IA Hermes en un VPS Linux

Guía completa: instalar el agente IA Hermes en un VPS Linux

En esta guía veremos paso a paso cómo instalar y configurar el agente IA Hermes en un servidor VPS Linux. El objetivo es tener un agente autónomo que funcione 24/7 en tu VPS, capaz de ejecutar comandos, automatizar tareas y responder desde el terminal, Telegram, Discord y otros canales.

Hermes Agent es un agente IA de código abierto creado por Nous Research. Puede planificar acciones, ejecutar código, usar herramientas (web, shell, etc.) y mejorar con el tiempo gracias a su memoria. Instalado en un VPS se convierte en un asistente permanente para tus proyectos. Si te interesan los asistentes autónomos de este tipo, también puedes consultar nuestra guía para instalar OpenClaw en un VPS Linux.

---

1. Requisitos en tu VPS Linux

Antes de empezar, asegúrate de tener:

• Un servidor VPS Linux (se recomienda Ubuntu 22.04 o 24.04, Debian 12 o similar también funciona)
• Acceso SSH con un usuario que tenga permisos de sudo
• Al menos 1 a 2 GB de RAM si usas modelos en la nube mediante API
• Una clave API para tu proveedor de modelos (OpenAI, Anthropic, OpenRouter, etc.) o un servidor local como Ollama si prefieres modelos locales

Actualiza el sistema e instala las herramientas básicas.

Ubuntu / Debian:

sudo apt update && sudo apt upgrade -y
sudo apt install -y curl git

AlmaLinux / Rocky Linux:

sudo dnf update -y
sudo dnf install -y curl git

---

2. Instalar Hermes Agent con el script oficial

Hermes ofrece un instalador «todo en uno» para Linux que gestiona Python, Node.js y las dependencias.

En tu VPS ejecuta:

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

Recarga tu shell para que el comando hermes esté disponible:

source ~/.bashrc

Comprueba la instalación:

hermes --version

Ejemplo de salida:

Hermes Agent v0.16.0 (2026.6.5)
Project: /usr/local/lib/hermes-agent
Python: 3.11.15
OpenAI SDK: 2.24.0
Up to date

Si el comando no se encuentra, asegúrate de que ~/.local/bin está en tu PATH o vuelve a conectar tu sesión SSH.

---

3. Configuración inicial de Hermes con el asistente interactivo

Hermes incluye un asistente de configuración muy completo.

Lánzalo con:

hermes setup

El asistente te guiará en el proceso (o puedes usar la opción rápida “Quick Setup via Nous Portal”):

• Elegir un proveedor de modelo (OpenAI, Anthropic, OpenRouter, Ollama y otros)
• Introducir tu clave API si usas un proveedor en la nube
• Seleccionar el modelo por defecto (con búsqueda difusa en el selector de modelos)
• Confirmar dónde guardar memoria, habilidades y logs (por defecto ~/.hermes)

Podrás cambiar esta configuración más adelante con:

hermes model

---

4. Activar el backend Docker para una ejecución segura

Hermes puede ejecutar comandos de shell y código. En un VPS es muy recomendable hacerlo dentro de un sandbox Docker en lugar de ejecutarlo directamente en el sistema.

Instala Docker según tu distribución. Para más detalles u otras configuraciones, consulta nuestra guía completa para instalar Docker en Linux.

Ubuntu / Debian:

sudo apt-get remove -y docker.io docker-doc docker-compose docker-compose-v2 podman-docker containerd runc
curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh
sudo systemctl enable --now docker
sudo usermod -aG docker $USER

AlmaLinux / Rocky Linux:

sudo dnf install -y dnf-plugins-core
sudo dnf config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo
sudo dnf install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin
sudo systemctl enable --now docker
sudo usermod -aG docker $USER

Vuelve a conectarte a tu sesión (o usa newgrp docker) para que tu usuario pueda usar Docker sin sudo.

Indica a Hermes que use Docker como backend del terminal:

hermes config set terminal.backend docker

Ejemplo de salida:

✓ Set terminal.backend = docker in ~/.hermes/config.yaml

Puedes volver al modo local más adelante con:

hermes config set terminal.backend local

---

5. Administrar e interactuar con tu agente (Desktop, Dashboard o Terminal)

Para gestionar, configurar y chatear con tu agente Hermes en tu VPS, el método recomendado es utilizar la aplicación de escritorio Hermes Desktop. Sirve como tu centro de control gráfico principal. Siguen estando disponibles alternativas basadas en el navegador o directamente a través de la línea de comandos para adaptarse a cualquier flujo de trabajo.

Opción A (Recomendado): La aplicación nativa Hermes Desktop

La aplicación nativa Hermes Desktop se instala en tu ordenador personal (Windows, macOS, Linux) y se conecta a distancia al demonio Hermes que se ejecuta en tu VPS. Te ofrece una interfaz nativa pulida con chat en tiempo real, historial de sesiones, carga de archivos mediante arrastrar y soltar, y un selector de modelos.

Cómo conectar Hermes Desktop a tu VPS:

1. En el VPS, define un token de sesión persistente en el archivo ~/.hermes/.env:
   HERMES_DASHBOARD_SESSION_TOKEN=tu_token_seguro
2. Inicia el demonio en el VPS, activando los WebSockets (mediante la opción --tui) para permitir la conexión de la aplicación Desktop:

   hermes --tui dashboard --host 0.0.0.0 --port 9119 --no-open --insecure
   

3. En la aplicación Desktop de tu ordenador, ve a la pestaña Gateway de la columna izquierda, selecciona Remote gateway, introduce la dirección http://<IP_DE_TU_VPS>:9119 en el campo Remote URL y haz clic en Save and reconnect.

Elegir el entorno de ejecución (Execution Backend):

Desde esta interfaz gráfica, puedes configurar dónde ejecuta Hermes sus tareas de terminal yendo a Settings > Terminal > Execution Backend. Además de Docker (la opción recomendada, que ejecuta los comandos de forma aislada en un contenedor dentro del VPS, como configuramos en el paso 4), puedes elegir Local (para ejecutarlos directamente en el sistema host del VPS sin aislamiento), Ssh (para delegar la ejecución en otra máquina remota), Modal / Daytona (serverless en la nube) o Singularity (cómputo de alto rendimiento HPC).

Opción B: El panel de control web (Web Dashboard)

Si prefieres no instalar la aplicación de escritorio, Hermes incluye un panel de control accesible directamente desde tu navegador. Integra la gestión de tu catálogo MCP, los canales de mensajería, las credenciales, los webhooks, el almacenamiento de memoria y una autenticación segura.

Para iniciar el panel de control web en el VPS:

hermes dashboard --host 0.0.0.0

Por defecto, se ejecuta en el puerto 9119. Puedes acceder a ella desde tu navegador en la dirección http://<IP_DE_TU_VPS>:9119 (asegúrate de abrir el puerto 9119 en tu cortafuegos si deseas usar esta interfaz).

Opción C: Línea de comandos clásica (TUI y CLI)

Para desarrolladores y administradores de sistemas que prefieren trabajar directamente dentro del terminal SSH:

• Interfaz de texto interactiva (TUI): Ejecuta el comando hermes para entrar en una interfaz de chat en tiempo real. Por ejemplo, escribe what can you do as a hermes agent on this server?. Hermes planificará la respuesta, llamará a las herramientas necesarias y guardará el historial en ~/.hermes. Sal de la TUI con Ctrl+D o /quit (también puedes deshacer los últimos turnos del historial con el comando /undo).
• Modo One-Shot (Comando rápido): Para enviar un único comando y obtener el resultado de texto directamente en la terminal sin entrar en el modo interactivo:

  hermes -z "Crea un script en python para ver el clima de París"
  

---

6. Configurar pasarelas de mensajería (Telegram, Discord, etc.)

Una de las grandes ventajas de tener Hermes en un VPS es poder hablar con él desde tu móvil o tus canales de chat.

Tienes dos formas de configurar estas pasarelas:

A través de la interfaz gráfica (Dashboard / Aplicación Desktop):

Ve a la pestaña Messaging en la columna izquierda de la interfaz gráfica. Allí encontrarás todos los canales compatibles (Telegram, Discord, Slack, WhatsApp, Signal, Twilio SMS, etc.).
Por ejemplo, para Telegram:

1. Sigue las instrucciones en pantalla para obtener un Bot Token a través de @BotFather en Telegram.
2. Introduce tu Bot Token y opcionalmente tus identificadores de usuario autorizados en el campo Allowed Telegram user IDs (recomendado para evitar que cualquier persona controle tu agente).
3. Activa el interruptor inferior para ponerlo en Enabled y guarda los cambios.

A través del terminal (SSH):

Si prefieres usar el terminal, inicia el asistente interactivo de configuración:

hermes gateway setup

El asistente te guiará paso a paso para vincular tus cuentas de Telegram, Discord u otros canales.

Luego puedes iniciar la pasarela en primer plano para probar la configuración:

hermes gateway

---

7. Ejecutar Hermes como servicio permanente 24/7

Si solo lanzas hermes gateway en una sesión SSH, el proceso se detendrá en cuanto cierres la conexión.

Para que el agente esté siempre activo, Hermes integra comandos para instalarlo automáticamente como servicio en segundo plano (systemd en Linux).

Para instalarlo como servicio de usuario (recomendado):

hermes gateway install

Ejemplo de salida en la terminal:

Start the gateway now after installing the service? [Y/n]: y
Start the gateway automatically on login/boot with systemd? [Y/n]: y
Installing user systemd service to: ~/.config/systemd/user/hermes-gateway.service

✓ User service installed and enabled!

Next steps:
  hermes gateway start              # Start the service
  hermes gateway status             # Check status
  journalctl --user -u hermes-gateway -f  # View logs

✓ Systemd linger is enabled (service survives logout)
✓ User service started

Si prefieres instalarlo a nivel de sistema global para que se inicie automáticamente al arrancar el servidor:

sudo hermes gateway install --system

Una vez instalado, puedes gestionar fácilmente el ciclo de vida del servicio mediante los comandos integrados de Hermes:

Para verificar el estado y asegurarte de que todo funciona correctamente:

hermes gateway status

Ejemplo de salida:

● hermes-gateway.service - Hermes Agent Gateway - Messaging Platform Integration
     Loaded: loaded (/home/username/.config/systemd/user/hermes-gateway.service; enabled; preset: enabled)
     Active: active (running) since Fri 2026-06-05 15:13:31 UTC; 2s ago
   Main PID: 3449 (hermes)
      Tasks: 4 (limit: 21479)
     Memory: 82.9M (peak: 97.5M)
        CPU: 2.119s
     CGroup: /user.slice/user-1000.slice/[email protected]/app.slice/hermes-gateway.service
             └─3449 /usr/local/lib/hermes-agent/venv/bin/python -m hermes_cli.main gateway run --replace

Jun 05 15:13:31 demo-vps systemd[1228]: Started hermes-gateway.service - Hermes Agent Gateway.
Jun 05 15:13:33 demo-vps python[3449]: WARNING gateway.run: No messaging platforms configured.
✓ User gateway service is running
✓ Systemd linger is enabled (service survives logout)

---

8. Automatizar tareas con hermes cron

Hermes permite programar tareas en lenguaje natural, ideal en un VPS para monitorización y reportes.

Ejemplos:

hermes cron "every weekday at 8 AM, summarize overnight server logs and send to Telegram"
hermes cron "every hour, check if https://example.com returns 200 and alert me if not"
hermes cron "every Friday at 5 PM, list all commits across my Git repos this week"

No necesitas sintaxis de crontab. Hermes interpreta estas frases, crea los jobs y los ejecuta de forma desatendida.

---

9. Asegurar tu VPS y tu agente Hermes

Aunque Hermes simplifica la automatización, sigue siendo un servicio que corre en un servidor VPS. Ten en cuenta estas buenas prácticas:

• Cortafuegos: abre solo los puertos necesarios (SSH por defecto). Ten en cuenta que si utilizas bots de Telegram o Discord, estos se comunican mediante Long Polling (conexiones HTTP salientes), por lo que no necesitas abrir ningún puerto de entrada en el cortafuegos de tu VPS. Solo tendrás que abrir puertos si configuras integraciones mediante webhooks (como Slack), que suelen escuchar en el puerto 443 o en uno personalizado. Utiliza ufw o firewalld.
• Usuario no root: ejecuta Hermes con un usuario normal, añadido al grupo docker si es necesario.
• Solo claves SSH: desactiva la autenticación por contraseña en sshd_config y usa claves SSH.
• Aprobación de comandos: mantén activadas las aprobaciones para operaciones sensibles en Hermes en lugar de aprobar todo automáticamente.
• Copias de seguridad: haz backups periódicos del directorio ~/.hermes (memoria, configuración, logs) hacia un almacenamiento externo.

Con esta configuración, tu agente IA Hermes estará siempre disponible en tu VPS, listo para gestionar tareas técnicas, monitorización o conversaciones a través de tus canales favoritos.

---

Conclusión

Instalando Hermes en un servidor VPS, conviertes tu máquina en un asistente IA totalmente autónomo, perfecto para automatizar tareas, vigilar servicios y centralizar flujos de trabajo. En BoxToPlay apostamos por un alojamiento VPS estable y de alto rendimiento, ideal para este tipo de agente siempre activo. Si quieres probar este enfoque por ti mismo, puedes probar gratis tu servidor VPS.