Cómo instalar Hermes Agent (Nous Research) en Linux, Windows y Mac (2026)

23 de julio del 20266 minHermes Agent, Nous Research, IA, Agentes, Tutorial

Respuesta corta (60 segundos): Hermes Agent se instala con un comando. En Linux / macOS / WSL2 / Android (Termux): curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash. En Windows nativo (PowerShell): iex (irm https://hermes-agent.nousresearch.com/install.ps1). En macOS/Windows con GUI: bajá el Hermes Desktop installer desde el sitio oficial. El script instala automáticamente uv, Python 3.11, Node v22, ripgrep y ffmpeg — el único prerequisite en Linux es git, curl y xz-utils. Tarda entre 60 segundos (laptop moderna) y 4 minutos (hardware viejo). Después verificás con hermes --version y hermes doctor.

Hermes Agent es un agente AI open source de Nous Research. A diferencia de los chatbots hosted, corre local en tu máquina, se conecta a 300+ modelos vía Nous Portal, y expone skills, sesiones y un gateway de tools extensible.

Este post es la guía que wish hubiera tenido la primera vez que lo probé. Cubre los caminos oficiales (CLI puro, Desktop GUI, install sin sudo), los prerequisites que el script resuelve solo (y los que no), y la verificación posterior. Vamos por partes.

Antes de empezar: qué necesitás

Requisito	Detalle
SO	Linux, macOS, WSL2, Android (Termux), o Windows 10+ nativo
Privilegios	Usuario normal. Funciona sin sudo con degradación graceful
Conexión a internet	El script baja Node, Python, ripgrep, ffmpeg, repo
Tiempo	60–240 segundos según hardware y conexión
Conocimientos	Terminal básico. Nada de venv o configuración manual

Lo único que necesitás preinstalado en Linux: git, curl y xz-utils. En Debian/Ubuntu: sudo apt install curl xz-utils git. Para la desktop app, también build-essential: sudo apt install build-essential.

Camino 1 · Hermes Desktop (macOS / Windows con GUI)

Si querés la GUI con tray icon, sistema de chat integrado y update in-app, bajá el instalador desde hermes-agent.nousresearch.com y corré el .dmg (macOS) o .exe (Windows). El instalador baja CLI + UI + dependencias y deja todo listo.

Después de instalar, abrí Hermes Desktop y corré el wizard de setup, o usá el atajo:

hermes setup --portal   # Nous Portal: 300+ modelos con una sola suscripción

Camino 2 · Solo CLI (Linux, macOS, WSL2, Android, Windows)

Si preferís CLI puro o estás en Linux, este es el camino. Una línea:

En Linux / macOS / WSL2 / Android (Termux)

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

En Windows nativo (PowerShell)

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

Después de instalar, recargá la shell:

source ~/.bashrc   # o: source ~/.zshrc
hermes             # arrancar el agente

Si más adelante querés sumar la GUI desde un install CLI:

hermes desktop

Qué hace exactamente el instalador

Detecta el SO y el user mode (per-user o root).
Verifica prerequisites: git (siempre), curl + xz-utils en Linux.
Instala las deps que falten: uv (Python package manager), Python 3.11, Node.js v22, ripgrep, ffmpeg.
Clona el repo a ~/.hermes/hermes-agent/ (per-user) o /usr/local/lib/hermes-agent/ (root).
Crea el virtualenv de Python.
Symlink ~/.local/bin/hermes → venv launcher (per-user) o /usr/local/bin/hermes (root).
Lanza el wizard hermes setup o el atajo --portal si lo pediste.

Layout final per-user:

# Estructura de archivos después del install per-user
~/.hermes/
  hermes-agent/          # checkout del repo
  config.yaml            # config del agente
  auth.json              # credenciales de providers
  venvs/                 # virtualenvs de Python
~/.local/bin/hermes      # binario symlink

Camino 3 · Install sin sudo (system service users)

Si vas a correr Hermes como service account (sin sudo), el installer detecta la falta de sudo y degrada: salta el paso --with-deps de Playwright (que necesita instalar system libraries via apt) y baja Chromium al cache local del usuario.

Split recomendado (Debian/Ubuntu):

Una vez, como admin con sudo, instalar las system libraries que necesita Chromium:

sudo npx playwright install-deps chromium

Como service user sin sudo, correr el installer normal — detecta la falta de sudo y degrada:

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

Sumar hermes al PATH del service user (los service accounts suelen tener un PATH mínimo):

# Opción A — agregar al profile del service user
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc

# Opción B — symlink system-wide (como admin)
sudo ln -s /home/hermes/.hermes/hermes-agent/venv/bin/hermes /usr/local/bin/hermes

Verificar: hermes doctor debe correr limpio.

Si no necesitás browser automation (corrés Hermes headless), podés saltarte el paso de Playwright:

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

Configurar el provider de LLM

Después de instalar, lo siguiente es decidir cómo conectás el modelo. Hay dos caminos.

Camino rápido · Nous Portal

Una sola suscripción te da acceso a 300+ modelos más el Tool Gateway (web search, image generation, TTS, cloud browser):

hermes setup --portal

Te logueás en el portal, seteamos Nous como provider y activamos el Tool Gateway. Listo, una sola decisión y cubrís el 90% de los casos.

Camino manual · Tu propio provider

Si preferís OpenAI / Anthropic / OpenRouter directo:

hermes model                    # elegí provider y modelo
hermes config set OPENAI_API_KEY sk-...
# o:
hermes config set ANTHROPIC_API_KEY sk-ant-...
# o:
hermes config set OPENROUTER_API_KEY sk-or-...

Después activá las tools que vas a usar:

hermes tools                    # toggle de tools (browser, file ops, etc.)
hermes gateway setup            # configurar canales (Telegram, Discord, etc.)

Verificar que quedó bien instalado

Dos comandos principales, más algunos complementarios.

hermes --version       # versión del binario
hermes doctor          # chequeo completo: config, deps, service health
hermes config check    # config migration status

doctor detecta automáticamente el método de install (git, Docker, NixOS) y muestra el comando de update que corresponde. Si reporta faltantes, los imprime con la fix exacta.

Troubleshooting rápido

Problema	Solución
`hermes: command not found`	`source ~/.bashrc` o `source ~/.zshrc`. Si seguís sin verlo, agregá `~/.local/bin` al PATH.
`API key not set`	`hermes model` o `hermes config set OPENROUTER_API_KEY tu_key`.
Missing config después de update	`hermes config check` y después `hermes config migrate`.
`ModuleNotFoundError: No module named 'dotenv'`	Estás invocando el source file en vez del launcher del venv. Verificá que `~/.local/bin/hermes` apunte a `venv/bin/hermes`.
Falta sudo y Playwright falla	Corré `sudo npx playwright install-deps chromium` una vez como admin, o pasá `--skip-browser` al installer.
Update no termina en Windows	Cerrá Hermes Desktop y los REPLs abiertos, después `hermes update` de nuevo.

Después de instalar: primeros pasos

Una vez que hermes doctor pasa verde, podés empezar a charlar:

hermes               # arrancar el chat
hermes agent "..."   # one-shot: mandarle una tarea y salir
hermes gateway start # dejar el gateway corriendo en background

Si querés que el gateway quede como servicio managed (systemd en Linux, launchd en macOS, Scheduled Task en Windows), hermes setup lo configura o podés hacerlo manual con hermes gateway install.

¿Querés discutir tu caso puntual antes de invertir tiempo en configurarlo? Hay un CTA al final con una llamada gratis de 30 minutos.

Preguntas frecuentes

¿Qué es Hermes Agent en una frase?

Es un agente AI open source de Nous Research con CLI, desktop app y gateway de tools. Un único binario `hermes` que corre en tu máquina, conecta 300+ modelos vía Nous Portal (o el provider que elijas), y expone skills, sesiones y tools extensibles.

¿Necesito instalar Python, Node o ffmpeg manualmente?

No. El instalador de Hermes detecta qué falta y lo baja solo: uv, Python 3.11, Node.js v22, ripgrep y ffmpeg. El único requisito previo en Linux es `git`, `curl` y `xz-utils`. En Windows nativo el instalador PowerShell baja todo igual.

¿Qué diferencia hay entre instalar Hermes Desktop y solo el CLI?

Hermes Desktop (GUI) está disponible como instalador nativo para macOS y Windows — baja el bundle con CLI + UI. En Linux/WSL2/Android solo hay CLI; si después querés la GUI, corrés `hermes desktop` y el propio Hermes la levanta.

¿Funciona en un servidor sin GUI ni acceso sudo?

Sí. Hermes detecta si hay sudo disponible y degrada gracefully — salta el paso `--with-deps` de Playwright (lo único que necesita root de verdad). Si vas a usar browser automation, un admin corre `sudo npx playwright install-deps chromium` una vez y listo.

¿Cuánto tarda la instalación?

Entre 60 y 180 segundos en una laptop moderna — más lento si el instalador tiene que bajar Node y Python. En hardware viejo puede llegar a 4 minutos. Incluye bajar deps, clonar el repo, crear el venv y dejar `hermes` en el PATH.

¿Cómo verifico que quedó bien instalado?

Dos comandos: `hermes --version` (devuelve la versión) y `hermes doctor` (chequeo completo de config, deps y salud del gateway). `hermes doctor` también detecta el método de install (git, Docker, NixOS) y muestra el comando de update que corresponde.