Zum Inhalt springen
Revisado en Hermes Agent v0.22.5 · 25.10.2026

Instalar Hermes Agent: todas las vías, todos los comandos

La instalación en sí tarda unos minutos. Calcula una media hora hasta que el modelo y la primera mensajería funcionen.

¿Qué vía encaja contigo?

Solo quieres empezar, en Windows o Mac App de escritorio Linux, Mac o Windows con WSL2, cómodo en la terminal Instalación por terminal Windows sin WSL Windows nativo (PowerShell) Hermes debe funcionar 24/7, también para Telegram y similares Servidor o VPS Ya trabajas con contenedores Docker

1. App de escritorio (Windows y Mac)

Descarga el paquete en hermes-agent.nousresearch.com. Incluye el agente, Python y todas las dependencias; en el primer arranque no se compila nada.

  • ✓Windows: abre el archivo .appinstaller. Windows instala el paquete firmado y lo mantiene actualizado.
  • ✓Mac: abre el DMG y arrastra Hermes.app a Aplicaciones. Solo Apple Silicon (M1 y posteriores).

¿Ya instalaste Hermes por terminal? Abre la app con:

$ hermes desktop

2. Terminal: Linux, Mac y WSL2

Un solo comando. El instalador descarga el código, trae su propio Python (actualmente 3.14) y crea el comando hermes. Solo necesitas Git, curl y tar.

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

Después recarga la shell y arranca:

$ source ~/.bashrc
$ hermes

Ubuntu, Debian y otras distribuciones funcionan igual. Si a un sistema mínimo le falta la librería libatomic, el instalador la añade y te pide una vez la contraseña de sudo.

3. Windows nativo (PowerShell)

Sin WSL, directamente en PowerShell. Si falta Git, el instalador trae su propia copia.

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

¿Nativo o WSL2? Nativo es más sencillo. WSL2 compensa si ya trabajas con herramientas de Linux.

4. Servidor o VPS: Hermes las 24 horas

Para que Hermes trabaje de noche y responda en Telegram necesita una máquina siempre encendida. La instalación es la misma que en Linux. Tres cosas marcan la diferencia:

  1. Conéctate por SSH, no con la consola web del proveedor. Altera caracteres al pegar y rompe comandos sin avisar.
  2. Instala con un usuario propio con el que Hermes vaya a funcionar, no como root.
  3. Mantén el servicio activo aunque cierres sesión: configura las mensajerías, instala el gateway como servicio en segundo plano y comprueba su estado.
$ sudo loginctl enable-linger TU_USUARIO
$ hermes gateway setup
$ hermes gateway install
$ hermes gateway status

Proxmox: una VM o un contenedor LXC con Debian o Ubuntu y dentro la instalación normal de Linux.

5. Docker

La imagen oficial es nousresearch/hermes-agent. Todos los datos (ajustes, claves, chats, skills) están en una carpeta que montas en /opt/data. Primero configuras y después lo dejas funcionando:

$ mkdir -p ~/.hermes && docker run -it --rm -v ~/.hermes:/opt/data nousresearch/hermes-agent setup
$ docker run -d --name hermes --restart unless-stopped -v ~/.hermes:/opt/data nousresearch/hermes-agent gateway run

El contenedor se actualiza con docker pull nousresearch/hermes-agent:latest y un reinicio, no con hermes update. La app de escritorio no forma parte de la imagen.

Después de instalar: configurar

Estos cinco comandos son todo lo que necesitas al principio. El primero lo hace casi todo de una vez.

$ hermes setup

El asistente de configuración: modelo, herramientas y mensajerías de una vez.

$ hermes model

Elegir modelo y proveedor, o cambiarlo más adelante.

$ hermes config set display.language es

Poner la interfaz en español.

$ hermes gateway setup

Conectar Telegram, WhatsApp, Slack u otras mensajerías.

$ hermes doctor

Revisión de salud: muestra qué falta y cómo solucionarlo.

Atajo: con hermes setup --portal inicias sesión en Nous Portal, donde una suscripción cubre muchos modelos además de búsqueda web, imágenes y voz. Revisa las condiciones de privacidad del portal antes de usarlo con datos de empresa.

Si algo falla

hermes: command not found Recarga la shell con source ~/.bashrc (o ~/.zshrc) o abre una terminal nueva.
API key not set Configura un proveedor con hermes model.
Faltan ajustes tras una actualización Ejecuta hermes config check y después hermes config migrate.
Los comandos llegan dañados al servidor No uses la consola web de tu proveedor; conéctate por SSH. Las consolas web alteran caracteres como : o @ al pegar.

Más adelante actualizas con hermes update. ¿Vienes de OpenClaw? Lee la comparativa con guía de migración.

¿Prefieres que te lo configuren?

Instalamos Hermes como B.R.A.I.N. para tu empresa: en hosting gestionado de Mittwald en Alemania, con tu correo, tu agenda y tu conocimiento. El servidor es tuyo.

Ver B.R.A.I.N.

Preguntas frecuentes

¿Cómo instalo Hermes Agent?

Lo más fácil es la app de escritorio de la web de Hermes (Windows y Mac). En la terminal de Linux, Mac o WSL2 basta un comando: curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash. Después configuras modelo y mensajerías con hermes setup.

¿Hermes Agent funciona en Windows?

Sí, de dos formas: de forma nativa con la app de escritorio o con el comando de PowerShell iex (irm https://hermes-agent.nousresearch.com/install.ps1), o dentro de WSL2 con la instalación de Linux. WSL2 tiene sentido si ya trabajas con herramientas de Linux.

¿Hermes Agent funciona en un Mac con Intel?

No. En macOS, Hermes solo es compatible con Apple Silicon (M1 y posteriores). Según la documentación, los Mac con Intel no son una plataforma soportada.

¿Tengo que instalar Python?

No. El instalador trae su propia versión fija de Python (actualmente 3.14), además de Node.js, ripgrep y FFmpeg. Para la instalación por terminal solo necesitas Git, curl y tar.

¿Cómo pongo Hermes Agent en español?

Con hermes config set display.language es. Así cambian menús, preguntas y avisos. El agente responde en español en cuanto le escribes en español.

¿Puedo instalar Hermes Agent en Proxmox?

Sí, en una VM de Linux o un contenedor LXC con Debian o Ubuntu. Dentro usas la instalación normal por terminal o Docker. No existe una vía específica para Proxmox, ni hace falta.

Actualizado: 25.10.2026, Hermes Agent v0.22.5. Fuente: documentación oficial en hermes-agent.nousresearch.com. No oficial, sin patrocinio de Nous Research. Volver a Hermes Agent en español