Skip to content
En esta página

Cómo instalar Hermes Agent en tu computadora y en un VPS ​

Portada: instala Hermes Agent en local y en un VPS, con el comando de instalación en una terminal

TL;DR: En tu computadora, Hermes se instala con un solo comando (curl ... | bash en Linux, macOS y WSL2, o irm ... | iex en Windows), luego corres hermes setup para elegir modelo y hermes --tui para chatear. En un VPS lo instalas igual con un usuario sin privilegios, conectas un bot de Telegram con hermes gateway setup y lo dejas como servicio con hermes gateway install. Si prefieres contenedores, hay imagen oficial: nousresearch/hermes-agent.


Qué es Hermes Agent ​

Hermes Agent es un agente de IA de código abierto de Nous Research. Corre en tu máquina, usa la terminal, lee y escribe archivos, navega con un Chromium propio, guarda memoria entre sesiones y puede contestarte por Telegram, Discord, Slack, WhatsApp, Signal o correo a través de su gateway de mensajería.

No trae un modelo propio: lo conectas al que quieras (Nous Portal, OpenRouter, Anthropic, OpenAI, Gemini, DeepSeek o uno local con Ollama).

Esta guía sigue la documentación oficial a noviembre de 2026.

Antes de empezar ​

PlataformaCómo se instalaSoporte
Linux y WSL2 (x86_64 y ARM64)install.shOficial, probado en el Ubuntu más reciente
macOS (Apple Silicon)install.sh o la app de escritorioOficial
Windows 10 y 11install.ps1 o la app de escritorio (MSIX, Windows 11 22H2 o superior)Oficial
Docker (x86_64 y ARM64)docker pull nousresearch/hermes-agentOficial
Nix y Android (Termux)Flake de Nix o pkg install hermes-agentSin garantía

Lo que no tiene soporte: pip install hermes-agent, uv tool install hermes-agent, Homebrew y AUR. Usa el instalador oficial.

Lo que necesitas:

  • Git y curl instalados. El instalador trae lo demás por su cuenta: uv, Python 3.14, Node.js, ripgrep, FFmpeg y un Chromium para que el agente navegue.
  • Un modelo con al menos 64,000 tokens de contexto. Hermes rechaza al arrancar los modelos con menos.
  • Una API key o una cuenta del proveedor que vayas a usar. Para probar, el asistente de instalación ofrece una opción gratis sin key.

Parte 1: instalación local ​

1. Corre el instalador ​

En Linux, macOS o WSL2:

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

En Windows, desde PowerShell:

powershell
iex (irm https://hermes-agent.nousresearch.com/install.ps1)

En Linux, si tu sistema no tiene libatomic, el instalador te pedirá tu contraseña de sudo para instalarla. Node.js la necesita.

Al terminar, recarga tu shell para que encuentre el comando hermes:

bash
source ~/.bashrc   # o source ~/.zshrc si usas zsh

¿Prefieres una app?

En hermes-agent.nousresearch.com hay una app de escritorio para macOS (solo Apple Silicon) y Windows. Si ya instalaste la versión de terminal, hermes desktop instala y abre la app.

Así queda todo en tu disco:

RutaQué guarda
~/.hermes/hermes-agent/El código de Hermes
~/.local/bin/hermesEl comando hermes
~/.hermes/.envTus API keys y tokens
~/.hermes/config.yamlLa configuración que no es secreta
~/.hermes/auth.jsonLas credenciales de los inicios de sesión con OAuth

2. Configúralo con hermes setup ​

bash
hermes setup

El asistente pregunta "How do you want to power Hermes?" y te da cinco caminos:

OpciónQué hace
Free, start nowEmpiezas sin key con el modelo nous/welcome. Sirve para probar
Sign in to Nous PortalInicias sesión en Nous con OAuth
Use my own API key or a subscriptionEliges tu proveedor y pegas tu key
Full SetupConfiguras todo: modelo, herramientas y mensajería
Blank SlateTodo apagado salvo el modelo, los archivos y la terminal

Si ya tienes cuenta en Nous, hermes setup --portal hace todo en un paso: inicia sesión, pone a Nous como proveedor y activa su Tool Gateway.

3. Elige tu modelo y guarda tu key ​

Para cambiar de proveedor o de modelo cuando quieras:

bash
hermes model

También puedes guardar valores sueltos con hermes config set. Los nombres en MAYÚSCULAS van a ~/.hermes/.env y los que llevan punto van a config.yaml:

bash
hermes config set OPENROUTER_API_KEY sk-or-...
hermes config set model anthropic/claude-opus-4.6

Estas son las variables de los proveedores más usados:

ProveedorVariable
OpenRouterOPENROUTER_API_KEY
AnthropicANTHROPIC_API_KEY (o inicio de sesión con hermes model)
OpenAIOPENAI_API_KEY
Google GeminiGEMINI_API_KEY o GOOGLE_API_KEY
DeepSeekDEEPSEEK_API_KEY
xAIXAI_API_KEY
Nous PortalInicio de sesión con hermes model o hermes setup --portal

Con un modelo local. En hermes model elige "Custom endpoint" y apunta a tu servidor, por ejemplo Ollama en http://localhost:11434/v1. Arranca Ollama con el contexto que Hermes exige:

bash
OLLAMA_CONTEXT_LENGTH=64000 ollama serve

Ojo con el costo

Las tareas auxiliares de Hermes (visión, compresión de contexto) usan tu modelo principal si no les asignas otro. Si tu modelo es caro, configura uno más barato para ellas en auxiliary dentro de config.yaml.

4. Pruébalo ​

bash
hermes --tui

--tui abre la interfaz de terminal que recomienda Nous; hermes a secas abre la clásica. Pídele algo concreto, como "Resume este repositorio en 5 puntos". Para retomar la última conversación:

bash
hermes --continue   # o hermes -c

5. Decide qué puede tocar ​

Hermes tiene los mismos permisos que tu usuario: puede leer y borrar cualquier archivo que tú puedas. Tres ajustes para acotarlo:

  • hermes tools para apagar las herramientas que no uses.
  • hermes config set terminal.backend docker para que los comandos del agente corran dentro de un contenedor y no en tu sistema.
  • approvals.mode en config.yaml: con smart (el valor por defecto) o manual, Hermes te pide permiso antes de correr un comando peligroso; con off no pregunta nada. Deja off solo para entornos de prueba.

Algunos comandos están bloqueados siempre, aunque apagues las confirmaciones, como rm -rf / o formatear el disco. Y la herramienta de archivos de Hermes nunca escribe en ~/.ssh/, ~/.aws/ ni en sus propios .env.

Parte 2: instalación en un VPS ​

En un VPS, Hermes trabaja las 24 horas y le hablas por Telegram desde el celular. Por defecto Telegram funciona por polling: el servidor pregunta por mensajes nuevos, así que no necesitas abrir puertos ni tener dominio.

1. Elige el servidor ​

  • Sistema: Ubuntu LTS reciente, que es donde Nous prueba el instalador.
  • Tamaño: 2 vCPU y 4 GB de RAM es un buen punto de partida; es el límite que usa el ejemplo oficial de Docker Compose. El modelo corre en la nube del proveedor, así que no necesitas GPU.
  • Acceso: conéctate por SSH desde tu terminal. La documentación advierte que las consolas web de los proveedores de VPS pueden corromper caracteres como :, @, = y / al pegar comandos.

2. Prepara el servidor ​

Con tu usuario administrador, actualiza, instala las dependencias y crea un usuario sin sudo solo para Hermes:

bash
sudo apt update && sudo apt upgrade -y
sudo apt install -y git curl tar libatomic1
sudo adduser --disabled-password --gecos "" hermes

Instalar libatomic1 desde aquí evita que el instalador pida sudo, que el usuario hermes no tiene. Y como Hermes puede correr comandos, conviene que ese usuario no pueda administrar el servidor.

Activa el firewall dejando pasar solo SSH:

bash
sudo ufw allow OpenSSH
sudo ufw enable

Permite que los servicios del usuario hermes sigan corriendo cuando cierres la sesión:

bash
sudo loginctl enable-linger hermes

Ahora tienes dos caminos: el instalador nativo con systemd (opción A) o Docker (opción B). Elige uno.

3A. Instalación nativa con systemd ​

Entra como el usuario hermes y corre el instalador:

bash
sudo -iu hermes
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
export PATH="$HOME/.local/bin:$PATH"
hermes doctor

Si no quieres que el agente navegue desde el servidor, agrega --skip-browser al final del comando (... | bash -s -- --skip-browser) y te ahorras el Chromium. Lo puedes instalar después con hermes pm install chromium.

Configura el modelo igual que en local:

bash
hermes setup

Si systemctl --user te da error de conexión con el bus, sal de la sesión y vuelve a entrar al servidor por SSH directo como hermes (con tu llave en /home/hermes/.ssh/authorized_keys) en lugar de usar sudo -iu.

4. Conecta Telegram ​

Crea el bot:

  1. En Telegram, abre @BotFather.
  2. Envía /newbot.
  3. Ponle un nombre visible, por ejemplo "Hermes Agent".
  4. Ponle un usuario único que termine en bot, por ejemplo mi_hermes_bot.
  5. BotFather te responde con un token parecido a 123456789:ABCdefGHIjklMNOpqrSTUvwxYZ. Guárdalo; si se filtra, revócalo con /revoke.

Consigue tu ID de usuario: escríbele a @userinfobot. Es un número como 123456789, no tu @usuario.

Configura Hermes:

bash
hermes gateway setup

Elige Telegram y pega el token y tu ID. Si prefieres hacerlo a mano, agrega esto a ~/.hermes/.env:

bash
TELEGRAM_BOT_TOKEN=123456789:ABCdefGHIjklMNOpqrSTUvwxYZ
TELEGRAM_ALLOWED_USERS=123456789

Pruébalo en primer plano con hermes gateway y mándale un mensaje a tu bot. Si contesta, deténlo con Ctrl+C.

Nunca abras el bot a todo mundo

Hermes ignora por defecto a quien no esté en la lista. No uses GATEWAY_ALLOW_ALL_USERS=true: cualquiera que encuentre tu bot podría correr comandos en tu servidor. Para dar acceso a alguien más, agrega su ID a TELEGRAM_ALLOWED_USERS separado por comas, o apruébalo con un código de emparejamiento: hermes pairing approve telegram CODIGO.

5. Déjalo como servicio ​

bash
hermes gateway install
hermes gateway start
hermes gateway status

hermes gateway install crea un servicio de usuario de systemd. Gracias al enable-linger del paso 2, arranca con el servidor y sigue corriendo cuando cierras SSH.

Dos recomendaciones de la documentación para systemd:

  • Reinicia con hermes gateway restart, no con systemctl restart, para no cortar al agente a media tarea.
  • No agregues un ExecStopPost que mate procesos al unit de systemd: provoca un ciclo infinito de reinicios.

3B. Alternativa: Docker ​

Si ya administras tu VPS con contenedores, usa la imagen oficial. Hermes guarda todo su estado (keys, configuración, memoria, sesiones) en /opt/data dentro del contenedor, que montas desde ~/.hermes en el servidor.

Primero, corre el asistente una vez:

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

Después agrega TELEGRAM_BOT_TOKEN y TELEGRAM_ALLOWED_USERS a ~/.hermes/.env (los pasos del bot están en la sección 4) y crea un docker-compose.yml:

yaml
services:
  hermes:
    image: nousresearch/hermes-agent:latest
    container_name: hermes
    restart: unless-stopped
    command: gateway run
    volumes:
      - ~/.hermes:/opt/data
    deploy:
      resources:
        limits:
          memory: 4G
          cpus: "2.0"
bash
docker compose up -d
docker compose logs -f

Este compose no publica puertos porque un bot de Telegram no los necesita. El ejemplo oficial publica el 8642 (una API compatible con OpenAI) y el 9119 (un panel web); si los activas, protégelos con usuario y contraseña o publícalos solo en 127.0.0.1 y entra por un túnel SSH (ssh -L 9119:localhost:9119 tu-servidor).

Dos reglas de la documentación para Docker:

  • Nunca corras dos contenedores del gateway con la misma carpeta de datos.
  • hermes update no funciona en Docker. Para actualizar: docker compose pull && docker compose up -d.

6. Lista de seguridad para el VPS ​

  • Lista de usuarios permitidos en Telegram, nunca acceso abierto.
  • chmod 600 ~/.hermes/.env para que solo tu usuario lea las keys.
  • Hermes con un usuario sin sudo, nunca como root.
  • terminal.backend en docker si quieres que los comandos del agente corran aislados.
  • Mantén Hermes actualizado.

Actualizar y desinstalar ​

Con el instalador nativo:

bash
hermes update           # instala la última versión estable
hermes update --check   # solo revisa si hay una nueva

También puedes mandarle /update a tu bot desde Telegram; se desconecta entre 5 y 15 segundos. Antes de cada actualización, Hermes guarda una copia de tu configuración, .env y credenciales en state-snapshots/.

Después de actualizar, revisa que todo siga bien:

bash
hermes doctor
hermes gateway status
hermes config migrate

Para desinstalar, primero detén el gateway y luego borra Hermes:

bash
hermes gateway stop
systemctl --user disable hermes-gateway   # en Linux
hermes uninstall --dry-run                # muestra qué va a borrar
hermes uninstall

Si algo falla ​

Prueba en este orden, que es el que sugiere la guía oficial:

ComandoPara qué
hermes doctorDiagnostica la instalación y te dice qué falta
hermes modelVuelve a elegir proveedor y modelo, o corrige la key
hermes setupRepite el asistente completo
hermes sessions listEncuentra tus conversaciones anteriores
hermes --continueRetoma la última conversación
hermes gateway statusRevisa si el bot está corriendo

Si te llevas Hermes a otra máquina, hermes backup empaca toda tu configuración y hermes import la restaura.

Fuentes ​