Hermes Agent: qué es, cómo instalarlo y configurarlo

Claude Code, Codex, Cursor, OpenClaw: cada uno de estos agentes de IA tiene su propia función. Si necesitas un agente que funcione en tu servidor, te recuerde entre sesiones y te responda por Telegram mientras vas en taxi, Hermes Agent cumple ese papel.

Hermes Agent es un proyecto abierto de Nous Research y es mucho más fácil de instalar de lo que mucha gente cree. A continuación encontrarás qué es, cuánto cuesta, cómo instalarlo en Windows, macOS o Linux y cómo conectarle un modelo y un bot de Telegram. Todo se basa en la documentación oficial.

¿Qué es Hermes Agent explicado de forma sencilla?#

Hermes pertenece a la misma categoría que Claude Code o Codex: es un agente de IA que no se limita a escribir respuestas; también abre archivos, ejecuta comandos en el terminal y utiliza un navegador. La diferencia está en cómo está creado: Claude Code está vinculado a los modelos de Anthropic, mientras que Hermes funciona con cualquier proveedor de modelos, desde Claude y GPT hasta modelos locales que se ejecutan en tu equipo.

El proyecto es reciente: su repositorio de GitHub se creó el 22 de julio de 2025. Aun así, a 22 de agosto de 2026 cuenta con más de 234.000 estrellas y 47.000 forks, lo que lo convierte en uno de los proyectos abiertos de más rápido crecimiento de esta categoría. El código es completamente abierto bajo la licencia MIT: puedes leerlo, modificarlo y utilizarlo en tus productos sin pagar regalías.

Dos mecanismos concretos sustentan esta «mejora propia»: los skills y la memoria. Los skills son procedimientos que el agente documenta después de tareas complejas y aplica la próxima vez. La memoria es un archivo con información sobre ti y tu entorno que se carga en cada conversación nueva. Ambos mecanismos se explican más adelante en una sección aparte.

¿En qué se diferencia Hermes Agent de Claude Code y Codex?#

Las principales diferencias se resumen en esta tabla:

La tabla deja claro el punto principal. Claude Code es adecuado para tareas que requieren el modelo más potente y se realizan en un repositorio; Anthropic sigue teniendo aquí la mejor combinación de modelo y herramientas. Hermes sirve cuando necesitas un agente «siempre activo»: funciona en un servidor, hace algo cada mañana según un horario, te responde por Telegram y recuerda la conversación del día anterior.

Si estás comparando herramientas básicas, hay guías aparte sobre cómo instalar Claude Code, qué es Codex de OpenAI y el panorama de las herramientas de programación con IA en 2026.

Agente de inteligencia artificial gratis: cuánto cuestan Hermes y el modelo#

La opción más sencilla es Nous Portal, la suscripción nativa de los desarrolladores de Hermes. Incluye más de trescientos modelos y también servicios listos para usar: búsqueda web, generación de imágenes, síntesis de voz y un navegador en la nube. A 22 de agosto de 2026, los planes son:

La segunda opción, que mucha gente pasa por alto, es que no hace falta contratar una nueva suscripción. Hermes puede iniciar sesión mediante OAuth, es decir, con una cuenta que ya tienes. Admite las suscripciones de ChatGPT y Codex, Claude Max, SuperGrok de xAI, Qwen, MiniMax y GitHub Copilot. Elige un proveedor durante la configuración, confirma el inicio de sesión en el navegador y seguirás pagando exactamente lo mismo que antes.

La tercera opción es usar tus propias claves API. Anthropic, OpenAI, Google, DeepSeek, Z.AI, Kimi, Alibaba y alrededor de una docena de proveedores más: introduce una clave y el uso se factura directamente en la cuenta correspondiente.

La cuarta opción no cuesta dinero, pero sí requiere hardware: un modelo local mediante Ollama o LM Studio. Funciona si tienes un ordenador potente y no quieres enviar datos fuera de él. Hay una condición: el modelo debe tener una ventana de contexto de al menos 64.000 tokens; de lo contrario, Hermes se negará a iniciarse con él. El agente necesita suficiente memoria de trabajo para tareas largas.

Aquí no se tratan las condiciones de pago de los servicios extranjeros; es un tema aparte, con sus propias reglas, que se aborda en esta guía con Claude Code como ejemplo.

¿Cómo instalar Hermes Agent en Windows?#

Si no estás familiarizado con el terminal, empieza por el instalador. El sitio hermes-agent.nousresearch.com tiene botones de descarga para macOS 12+, Windows 10/11 y Linux. El archivo descargado instala las dos aplicaciones de una vez: la línea de comandos hermes y Hermes Desktop, una ventana normal con chat, archivos y ajustes.

Si estás acostumbrado a usar comandos, instala Hermes desde PowerShell:

1. Abrir PowerShell

   Pulsa Win, escribe PowerShell y ábrelo. No necesitas permisos de administrador.

2. Ejecutar el instalador

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

   El script descarga todo lo que necesita: Python 3.11, Node.js 22, el gestor de paquetes uv, ripgrep y ffmpeg. Si no tienes Git, instala su propia versión aislada de MinGit, que se guarda por separado y no modifica los programas del sistema.

3. Reiniciar el terminal y comprobar la instalación

   hermes doctor
   

   El comando muestra qué está instalado, qué falta y cómo solucionarlo. Si ves marcas de verificación verdes, todo está instalado.

Con este método, los archivos se guardan en %LOCALAPPDATA%\hermes. Si usas WSL2, el comando de Linux de la sección siguiente también funciona allí; elige el método que te resulte más cómodo.

Cómo instalar Hermes Agent en macOS y Linux#

Hermes se instala con un comando, tanto en un portátil como en un servidor. Este es todo el proceso:

1. Comprobar que Git está instalado

   git --version
   

   Si el comando devuelve un número de versión, continúa. En Linux, comprueba también si tienes curl y xz-utils: en Debian y Ubuntu, instálalos con sudo apt install curl xz-utils.

2. Ejecutar el instalador

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

   El script clona el repositorio en ~/.hermes/hermes-agent, crea un entorno virtual e instala el comando hermes en ~/.local/bin. Para un servidor sin interfaz gráfica ni automatización del navegador, hay una opción ligera: añade bash -s -- --skip-browser al final.

3. Recargar el shell e iniciar Hermes

   source ~/.zshrc   # on macOS; on Linux, more often: source ~/.bashrc
   hermes
   

Cuando se instala como root, los archivos se guardan en rutas del sistema: /usr/local/lib/hermes-agent y /usr/local/bin/hermes. Esto es práctico para un servidor utilizado por varias cuentas. Los ajustes, las claves y la memoria siguen en la carpeta personal ~/.hermes de cada usuario.

Una nota sobre Hermes Desktop en Linux: para compilar la aplicación en Debian y Ubuntu, necesitas los compiladores del paquete build-essential (sudo apt install build-essential). Y si instalaste Hermes con el comando, no necesitas un instalador aparte: ejecuta hermes desktop y la aplicación se abrirá con tus ajustes, sesiones y skills existentes.

Cómo conectar un modelo a Hermes Agent#

El modelo es el motor de Hermes: el agente no piensa por su cuenta, sino que se comunica con el modelo que elijas. Por eso, el primer paso después de la instalación es elegir a qué servicio se conectará:

hermes model

El asistente de configuración te preguntará por un proveedor, un método de inicio de sesión y un modelo. Hay muchas opciones; estas son las principales:

Si eliges Nous Portal, un comando lo hace todo de una vez:

hermes setup --portal

Abre una página de inicio de sesión en el navegador. Después de que confirmes, configura Nous como proveedor y habilita Tool Gateway: búsqueda web, generación de imágenes y síntesis de voz, sin claves independientes para cada servicio.

Hermes guarda por separado las claves y los ajustes, algo importante desde el principio. Los secretos —claves API y tokens— se guardan en ~/.hermes/.env. Los ajustes habituales están en ~/.hermes/config.yaml. No hace falta editar esos archivos a mano: hermes config set coloca cada valor automáticamente en el archivo adecuado:

Buscar guías de herramientas en la documentación de Ailoot

El asistente de configuración completo es hermes setup. Tiene tres modos: una configuración rápida mediante Nous Portal, una configuración completa en la que recorres cada proveedor y herramienta por tu cuenta, y Blank Slate: una instalación limpia con todo desactivado salvo lo esencial, para que actives solo lo que necesites.

Cómo comprobar que Hermes Agent funciona#

Después de elegir un modelo, inicia una conversación:

hermes          # classic interface
hermes --tui    # modern interface, with mouse support and pop-up windows

El banner de bienvenida muestra el modelo seleccionado, las herramientas habilitadas y los skills. Después, no le preguntes «Hola, ¿quién eres?»: dale una tarea con un resultado visible, como «muéstrame las cinco carpetas más grandes del disco» o «mira la carpeta actual y dime qué archivo es el archivo principal del proyecto». Si el agente ejecuta un comando en el terminal y devuelve una respuesta útil, la configuración básica funciona.

La última comprobación es la de las sesiones. Sal de la conversación y vuelve:

hermes --continue   # or shorter: hermes -c

Deberías volver a la misma conversación. Esto comprueba que los datos de la sesión se guardan en el disco; más adelante, el bot y las tareas programadas dependerán de ello.

Si algo no funciona, sigue este orden: hermes doctor (diagnóstico general), hermes model (volver a comprobar el modelo y el inicio de sesión), hermes setup (recrear la configuración), hermes sessions list y hermes --continue (comprobar las sesiones), hermes gateway status (estado del gateway). Esta secuencia puede ayudarte a pasar de «todo está roto» a tenerlo claro en un par de minutos.

¿Qué son los skills y la memoria en Hermes Agent?#

Un skill de Hermes es un archivo SKILL.md con un nombre, una descripción y un procedimiento paso a paso: cómo montar un documento, abrir una pull request o preparar un envío de correo. El agente lee las descripciones breves de todos los skills y solo carga el texto completo cuando la tarea coincide; así, tener cien skills instalados no hace que todas las solicitudes sean más largas. El estándar es abierto, agentskills.io, y los mismos archivos funcionan en otros agentes.

Los skills están en la carpeta ~/.hermes/skills/. Se añaden de tres maneras: se instala un conjunto básico junto con la aplicación, se pueden añadir skills ya preparados desde el catálogo con hermes skills install, y el agente escribe nuevos skills para sí mismo después de tareas complejas. Cada skill se convierte automáticamente en un comando slash: instala el skill gif-search y /gif-search funcionará en cualquier chat. La instalación desde el catálogo pasa por una comprobación de seguridad para evitar que un procedimiento de otra persona introduzca comandos maliciosos.

La memoria es aún más sencilla. Son dos archivos en ~/.hermes/memories/: MEMORY.md, las notas del propio agente sobre su entorno y sus conclusiones, de hasta 2.200 caracteres, y USER.md, tu perfil: cómo responderte, qué te gusta y qué no, de hasta 1.375 caracteres. Al comienzo de cada conversación, ambos archivos se añaden al prompt del sistema, así que el agente empieza sabiendo cosas sobre ti. Los límites son deliberadamente estrictos: la memoria no crece sin control y el agente decide qué conservar y qué descartar.

Estos dos componentes —skills y memoria— forman el Second Brain: un agente que recuerda el contexto y acumula procedimientos, y que trabaja notablemente mejor cada semana que el día de su instalación. Para saber cómo elegir estos skills y evitar que tu agente se convierta en un cajón de sastre, consulta esta guía con Claude Code como ejemplo; los principios son los mismos.

Cómo conectar Hermes Agent a Telegram#

Telegram es el canal más popular de Hermes y la integración está muy desarrollada: texto, mensajes de voz con transcripción, imágenes y archivos, y respuestas en grupos. Este es el proceso:

1. Crear un bot con BotFather

   Abre @BotFather en Telegram, envía /newbot, elige un nombre y un nombre de usuario único que termine en bot. Recibirás un token parecido a 123456789:ABCdef...: es la clave de tu bot, así que guárdalo como una contraseña. Si se filtra el token, revócalo enviando /revoke al mismo BotFather.

2. Encontrar tu ID de usuario

   Encuentra tu ID numérico, por ejemplo, 123456789. Este es el número de tu cuenta; no lo confundas con tu nombre de usuario. Lo necesitarás para la lista de acceso.

3. Ejecutar el asistente de configuración del gateway

   hermes gateway setup
   

   Selecciona Telegram y pega tu token y tu ID. El asistente guardará la configuración. También puedes hacerlo manualmente con dos líneas en ~/.hermes/.env: TELEGRAM_BOT_TOKEN=... y TELEGRAM_ALLOWED_USERS=123456789.

4. Iniciar el gateway

   hermes gateway
   

   El bot estará en línea en unos segundos. Escríbele y comprueba la respuesta.

El acceso está cerrado de forma predeterminada: el bot solo responde a los ID incluidos en la lista. Puedes dar un código de vinculación a una persona nueva; funciona durante una hora y luego caduca. Puedes consultar la lista de usuarios pendientes y aprobados con hermes pairing list.

Hay un problema habitual en los chats de grupo que a menudo se pasa por alto. De forma predeterminada, los bots de Telegram tienen activado el modo de privacidad: en un grupo, el bot solo ve los comandos y las respuestas a sus propios mensajes. Para que pueda leerlo todo, desactiva el modo con @BotFather (Bot Settings - Group Privacy) o, de forma más sencilla, convierte al bot en administrador del grupo.

De forma predeterminada, el gateway consulta por sí mismo los servidores de Telegram; esto funciona bien en un ordenador doméstico o un servidor que siempre está encendido. Para plataformas en la nube que ponen la máquina en reposo cuando no hay tráfico entrante, existe el modo webhook, en el que Telegram envía mensajes a tu dirección.

¿Qué más puede hacer Hermes Agent después de instalarlo?#

Esto es lo que puedes habilitar, en orden:

1. Tareas programadas. El gateway tiene un planificador integrado: «Cada mañana a las 8, prepara un resumen de noticias sobre los temas que me interesan y envíamelo por Telegram». Configura el horario con una frase normal y los resultados llegarán al mismo chat.
2. Hermes Desktop. El comando hermes desktop abre la aplicación para macOS, Windows y Linux con el mismo agente: respuestas en tiempo real, vistas previas de archivos junto al chat, arrastrar y soltar documentos y un contador de contexto. Las sesiones se comparten: puedes empezar en el terminal y continuar en la ventana.
3. Panel web. hermes dashboard abre en el navegador un panel para canales, memoria, webhooks y perfiles. Es útil cuando Hermes funciona en un servidor.
4. Subagentes. Puedes delegar una tarea grande a agentes auxiliares aislados; cada uno tiene su propia conversación y terminal, así que no consume tu contexto.
5. Voz. El modo de voz funciona en el terminal, Telegram y Discord: puedes dictar una tarea y recibir una respuesta hablada.
6. Editor de código. Mediante el protocolo ACP, Hermes se conecta a VS Code, Zed y JetBrains como agente directamente en el editor.

Puedes activar y desactivar las herramientas una por una con hermes tools, para que el agente no tenga que cargar con todo. Cuando quieras trasladarlo a otro equipo, hermes backup incluye toda la instalación en un archivo comprimido, y hermes import lo descomprime en la nueva ubicación.

¿Para quién es Hermes Agent y quién debería esperar?#

Tiene sentido instalar Hermes cuando ya sabes qué quieres que haga un agente: ordenar documentos, crear un prototipo, gestionar correspondencia o preparar resúmenes matutinos. La herramienta en sí no es lo importante; lo son las tareas que le asignas. Hay una guía aparte sobre tareas para un agente de IA dedicada a este tema.

Puede que no te convenga en dos casos. Primero, si esperas «registrarte y que funcione»: Hermes tiene que instalarse y conectarse a un modelo. Solo hace falta ejecutar un comando, pero aun así tienes que abrir el terminal. Segundo, si no tienes un modelo adecuado y no quieres informarte sobre suscripciones o claves API.

El resto debería empezar poco a poco: instalarlo, elegir un modelo, mantener una conversación sin problemas, luego añadir un bot de Telegram y solo después los horarios y los subagentes.

¿Qué más suele preguntar la gente sobre Hermes Agent?#

Encontrarás más recursos en Ailoot.