Bienvenido a la instalación más fácil que harás en tu vida

Si has estado posponiendo probar Hermes Agent porque te preocupa que la configuración sea complicada, detente ahí mismo. El nuevo instalador hace casi todo por ti — y quiero decir todo. En este tutorial, te pondremos en marcha en menos de dos minutos, sin necesidad de un doctorado en artes oscuras de terminal.

El camino más rápido: Hermes Desktop

Para usuarios de macOS y Windows, la forma más sencilla de todas es descargar el instalador de Hermes Desktop desde nuestro sitio web. Descárgalo, ejecútalo y listo. Instala tanto la herramienta de línea de comandos como la aplicación de escritorio, así que tienes lo mejor de ambos mundos.

¿Solo línea de comandos? No hay problema

¿Prefieres quedarte en la terminal? Tienes dos opciones según tu sistema operativo:

Linux / macOS / WSL2 / Android (Termux):

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

Windows (nativo) — ejecuta en PowerShell:

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

¿Cambiaste de opinión y quieres la aplicación de escritorio más adelante? Solo ejecuta hermes desktop y se encargará del resto.

Lo que el instalador hace realmente (para que tú no tengas que hacerlo)

Aquí está la magia: el instalador maneja todo automáticamente. Se acabó andar buscando dependencias una por una. Configura:

Python 3.11 (mediante uv, sin necesidad de sudo)
Node.js v22 (para automatización de navegador y el puente de WhatsApp)
ripgrep (para búsqueda de archivos ultrarrápida)
ffmpeg (para conversión de audio en TTS)
La clonación del repositorio, el entorno virtual y el comando global hermes

Lo único que necesitas tener instalado por tu cuenta es Git (compruébalo con git --version). En Linux, asegúrate también de que curl y xz-utils estén disponibles. Para la aplicación de escritorio, necesitarás build-essential en Debian/Ubuntu.

Dónde va cada cosa

Según cómo instales, los archivos van a parar a sitios diferentes:

Instalador	El código vive en	Binario `hermes`	Directorio de datos
Por usuario (instalador git)	`~/.hermes/hermes-agent/`	`~/.local/bin/hermes`	`~/.hermes/`
Modo root (`sudo curl … \| sudo bash`)	`/usr/local/lib/hermes-agent/`	`/usr/local/bin/hermes`	`/root/.hermes/`

El diseño de modo root es perfecto para máquinas compartidas donde una sola instalación del sistema sirve para todos. Tu configuración personal (autenticación, habilidades, sesiones) sigue viviendo de forma segura en tu propia carpeta ~/.hermes/.

Después de la instalación: ¡a chatear!

Cuando el instalador termine, recarga tu shell y lánzate:

source ~/.bashrc   # o: source ~/.zshrc
hermes             # ¡Empieza a chatear!

¿Quieres ajustar cosas más adelante? Hay comandos dedicados para eso:

hermes model          # Elige tu proveedor de LLM y modelo
hermes tools          # Configura qué herramientas están habilitadas
hermes gateway setup  # Configura plataformas de mensajería
hermes config set     # Establece valores de configuración individuales
hermes config get     # Inspecciona valores de configuración individuales
hermes setup          # O ejecuta el asistente de configuración completo

El camino más rápido: Nous Portal

Aquí va un consejo de profesional: si quieres saltarte por completo el lío de gestionar claves API por herramienta, usa el Nous Portal. Una sola suscripción cubre más de 300 modelos más el Tool Gateway (búsqueda web, generación de imágenes, TTS, navegador en la nube). Configúralo todo con un solo comando:

hermes setup --portal

Eso te inicia sesión, establece Nous como tu proveedor y activa el Tool Gateway — todo de una vez.

¿Vienes de otra máquina?

No reconstruyas desde cero. Restaura una copia de seguridad completa con hermes import, o transfiere un solo agente con hermes profile import. Solo recuerda: las exportaciones de perfil excluyen credenciales por diseño, así que para una copia de seguridad real, usa hermes backup.

Una nota para usuarios de Nix

Nix ya no es una ruta de instalación explícitamente soportada (solo con el mejor esfuerzo posible). Si ya usas Nix, hay una guía de configuración dedicada con un flake y un módulo de NixOS — consulta la documentación de Nix y NixOS Setup.

¿Ejecutar como servicio del sistema?

¿Quieres ejecutar Hermes como un usuario dedicado sin privilegios (como una cuenta hermes de systemd)? Totalmente soportado. El único paso que requiere root es el --with-deps de Playwright para las bibliotecas de Chromium. El instalador detecta si sudo está disponible y lo maneja con elegancia.

¡Eso es todo! Ya estás listo para empezar tu primera conversación con Hermes. En el siguiente tutorial, exploraremos tu primera sesión de chat y todas las cosas geniales que puedes hacer. ¡Nos vemos allí!