Cómo instalar Hermes Agent en Docker y conectarlo con tu suscripción de Antigravity

Entrada especial del blog: Hermes Agent es un agente de inteligencia artificial de código abierto creado por Nous Research, el equipo que está detrás de los modelos Hermes. No es un simple chatbot: puede trabajar de forma autónoma, recuerda lo que ha hecho en tus proyectos y puede seguir funcionando aunque tu ordenador esté apagado. En esta entrada vamos a ver para qué sirve, cómo instalarlo en Docker con docker run y con Docker Compose, y cómo conectarlo con una suscripción de Google Antigravity para aprovechar sus modelos sin pagar nada más.

¿Para qué sirve Hermes Agent?

• Automatizar tareas de forma autónoma: investigar, programar, escribir y ejecutar acciones por ti sin supervisión constante.
• Recordar tus proyectos: guarda una memoria persistente de lo que ha hecho y crea sus propias habilidades con el uso.
• Atenderte por mensajería: lo controlas desde Telegram, Discord, Slack o WhatsApp, y también desde el terminal.
• Trabajar con el proveedor de modelos que tú elijas: la suscripción de Nous Portal, OpenRouter, Anthropic, OpenAI o modelos locales con Ollama.

Instalación con docker run

Para esta instalación necesitas una máquina con Docker, por ejemplo un VPS con Linux. La idea es muy cómoda: el contenedor guarda todos tus datos (configuración, claves, sesiones y la memoria del agente) en una carpeta de tu servidor que se monta dentro del contenedor. Así la imagen de Docker no guarda nada y actualizar Hermes es tan fácil como descargar la imagen nueva sin perder tu configuración.

El primer paso es crear la carpeta de datos y lanzar el asistente de configuración:

mkdir -p ~/.hermes
docker run -it --rm -v ~/.hermes:/opt/data nousresearch/hermes-agent setup

El asistente te pedirá las claves de tu proveedor de modelos y las guardará en esa carpeta. Solo hay que hacerlo una vez. Un consejo de la documentación oficial: ejecuta estos comandos conectado por SSH y no desde la consola web del proveedor de tu VPS, porque esas consolas a veces cambian caracteres como los dos puntos o la arroba y estropean los comandos sin que te des cuenta.

Cuando termine el asistente, arranca Hermes en segundo plano en modo gateway, que es el modo que lo mantiene siempre activo para poder hablarle por mensajería:

docker run -d --name hermes --restart unless-stopped -v ~/.hermes:/opt/data nousresearch/hermes-agent gateway run

Gracias a la opción de reinicio automático, el contenedor vuelve a arrancar solo si se cae o si reinicias el servidor. La imagen oficial existe tanto para procesadores amd64 como arm64, así que vale para casi cualquier VPS y también para una Raspberry Pi.

Instalación con Docker Compose

Si prefieres dejar la instalación descrita en un archivo, como hacemos en el resto de entradas del blog, este es el docker-compose.yml del ejemplo oficial de la documentación de Hermes. Levanta el gateway y también el panel web (dashboard) en el puerto 9119. Guárdalo como docker-compose.yml y ejecútalo con docker compose up -d:

services:
  hermes:
    image: nousresearch/hermes-agent:latest
    container_name: hermes
    restart: unless-stopped
    command: gateway run
    ports:
      - "8642:8642" # API del gateway
      - "9119:9119" # panel web (dashboard)
    volumes:
      - ~/.hermes:/opt/data
    environment:
      - HERMES_DASHBOARD=1
    deploy:
      resources:
        limits:
          memory: 2G
          cpus: "1.0"

Antes de levantarlo, ejecuta una vez el asistente de configuración con docker run como en la sección anterior, para que las claves queden guardadas en ~/.hermes. Después basta con docker compose up -d para arrancar y docker compose logs -f para ver los registros. Los dos puertos son opcionales si solo vas a hablar con Hermes por Telegram u otra mensajería: el 8642 expone la API compatible con OpenAI y el 9119 el panel web. Si publicas alguno de estos puertos en un servidor accesible desde Internet, recuerda que es un riesgo y configura primero la autenticación del panel.

¿Qué recursos necesita Hermes Agent?

Una aclaración importante sobre el docker-compose.yml de arriba: los valores de memory y cpus son límites máximos, no requisitos. Es el techo que Docker deja usar al contenedor, no lo que Hermes necesita para funcionar. El ejemplo oficial de la documentación usa 4 GB y 2 CPU, pero aquí los hemos bajado a 2 GB y 1 CPU para que encaje sin problemas en un VPS económico. Si tu servidor es más grande, puedes subirlos o quitarlos.

Según la documentación oficial, los requisitos reales son modestos:

• Mínimo: 1 GB de RAM, 1 núcleo de CPU y 500 MB de disco.
• Recomendado: entre 2 y 4 GB de RAM y 2 núcleos de CPU.
• Lo que más memoria consume es la automatización de navegador (Playwright/Chromium): si no la necesitas, con 1 GB es suficiente; si la vas a usar, reserva al menos 2 GB.

Ten en cuenta que el sistema operativo del servidor también consume lo suyo: un Linux recién instalado suele usar entre 200 y 500 MB de RAM en reposo. Así que con un VPS de 2 GB vas justito y con uno de 4 GB vas sobrado para el sistema, Docker y Hermes a la vez.

¿Y dónde encuentras un VPS así por unos 5 euros al mes? Estos son tres ejemplos con precios comprobados hoy, octubre de 2026, todos con centros de datos en Europa. Ojo: casi todos los proveedores anuncian el precio sin IVA, así que aquí ponemos las dos cifras, con el IVA español (21 %) ya calculado:

• OVHcloud VPS-1: 2 vCore, 4 GB de RAM y 40 GB NVMe por 3,81 €/mes + IVA, es decir 4,61 €/mes con IVA incluido. Es la única opción de la lista que se queda por debajo de 5 € con impuestos, e incluye tráfico ilimitado y copia de seguridad diaria.
• Contabo Cloud VPS 4: 4 vCPU, 8 GB de RAM y 100 GB SSD por 4,40 €/mes + IVA (5,32 €/mes con IVA) durante los primeros 24 meses; después sube a 5,50 €/mes + IVA (6,66 €/mes con IVA). Es el que más recursos da por euro.
• Hetzner CX23: 2 vCPU, 4 GB de RAM y 40 GB NVMe por 5,99 €/mes + IVA (7,25 €/mes con IVA), con servidores en Alemania y Finlandia.

Si tu presupuesto es de 5 € al mes ya con IVA, la opción que encaja es la de OVHcloud; Contabo se queda muy cerca durante la promoción y con el doble de RAM. Cualquiera de los tres sirve para seguir esta guía tal cual.

Conectar Hermes con tu suscripción de Antigravity

Si tienes una suscripción de Google Antigravity, puedes usar sus modelos (Gemini y Claude) dentro de Hermes gracias a un plugin llamado Antigravity Subscription DirectSDK.

Importante: este plugin no es oficial. No lo desarrolla Nous Research ni Google. Es un proyecto independiente publicado en GitHub por el usuario soyelmismo con licencia MIT, y según su documentación está probado con Hermes. Conviene saberlo antes de instalarlo.

El plugin funciona a través del programa de línea de comandos de Antigravity (llamado agy), que debe estar instalado y con la sesión iniciada en la misma máquina donde corre Hermes. Además necesitas la versión 0.21.0 de Hermes o superior.

La instalación se hace con el gestor de plugins de Hermes, con estos dos comandos:

hermes plugins install https://github.com/soyelmismo/hermes-antigravity-subscription
hermes plugins enable antigravity-subscription-directsdk

Una nota si usas Docker: estos comandos hay que ejecutarlos dentro del contenedor (por ejemplo con docker exec) y el programa agy también tiene que estar disponible dentro del contenedor. La documentación del plugin no detalla este caso, así que si quieres evitar complicaciones, la vía más sencilla hoy para usar este plugin es instalar Hermes directamente sobre el sistema del servidor en lugar de en Docker.

Cuando el plugin esté activado, abre Hermes y escribe el comando /model para elegir el proveedor Antigravity Subscription DirectSDK y el modelo que prefieras. También puedes arrancarlo directamente desde el terminal:

hermes --provider antigravity-subscription-directsdk --model gemini-3.8-flash

Según el repositorio del plugin, los modelos disponibles incluyen gemini-3.8-flash, gemini-3.1-pro, claude-sonnet-4-6, claude-opus-4-6-thinking y gpt-oss-120b, aunque la lista exacta depende de tu cuenta y se detecta de forma automática.

Consejos

• Ejecuta siempre la instalación conectado por SSH; evita la consola web del proveedor del VPS para pegar comandos.
• Si activas el panel web en un servidor público, configura usuario y contraseña con las variables HERMES_DASHBOARD_BASIC_AUTH_USERNAME y HERMES_DASHBOARD_BASIC_AUTH_PASSWORD.
• Empieza con un solo canal de mensajería (por ejemplo un bot de Telegram) para comprobar que todo responde antes de añadir más.

Errores habituales al instalar Hermes Agent

• Pegar los comandos en la consola web del VPS: los caracteres especiales llegan cambiados y los volúmenes o las claves quedan mal guardados.
• Arrancar dos contenedores gateway sobre la misma carpeta ~/.hermes: la documentación oficial avisa de que corrompe las sesiones y la memoria.
• Olvidar el modo gateway: sin él el agente no se queda escuchando en Telegram ni en el resto de canales.

Antes de empezar con Hermes Agent

Necesitas una máquina con Docker (un VPS con Linux es lo más cómodo) y la clave de al menos un proveedor de modelos: Nous Portal, OpenRouter, Anthropic u OpenAI. Si vas a usarlo por mensajería, prepara antes el bot, por ejemplo el token de un bot de Telegram, porque el asistente de configuración te lo pedirá. Reserva unos 4 GB de memoria para el contenedor si vas a activar el panel web, como indica el ejemplo oficial de Docker Compose.

Cómo comprobar que Hermes Agent funciona

Comprueba que el contenedor está activo con docker ps y revisa los registros con docker compose logs -f (o docker logs hermes si usaste docker run). Si activaste el panel web, abre http://IP-de-tu-servidor:9119 y deberías ver la pantalla de acceso. La prueba definitiva es hablarle por el canal que hayas configurado, por ejemplo mandar un mensaje a tu bot de Telegram, y ver que responde.

Dónde se guardan los datos

Todo vive en la carpeta ~/.hermes de tu servidor, montada dentro del contenedor en /opt/data: ahí están el archivo .env con las claves, el config.yaml con la configuración, las sesiones de conversación, la memoria del agente, las habilidades instaladas y los registros. Puedes borrar y recrear el contenedor sin miedo: mientras no toques esa carpeta, Hermes sigue siendo el mismo.

Cómo actualizar Hermes Agent

La imagen es oficial de Nous Research y no guarda datos, así que actualizar es descargar la versión nueva y recrear el contenedor. Con Docker Compose: docker compose pull y después docker compose up -d. Con docker run: docker pull nousresearch/hermes-agent, elimina el contenedor y vuelve a crearlo con el mismo comando de antes. Tu configuración y tu memoria se conservan en ~/.hermes.

Copia de seguridad de Hermes Agent

Copia la carpeta ~/.hermes completa: contiene las claves, la configuración, las sesiones y toda la memoria del agente. Con esa carpeta puedes restaurar tu Hermes en otro servidor en minutos, montándola de nuevo en /opt/data.

Enlaces de interés

• Instalación de Hermes Agent (documentación oficial)
• Hermes Agent en Docker, incluido el ejemplo de Docker Compose (guía oficial)
• Plugin Antigravity Subscription DirectSDK (repositorio de terceros, no oficial)