Instala y domina Hermes, el agente de IA que aprende contigo

Qué es Hermes y por qué importa#

Hermes Agent es un agente de IA de código abierto, con licencia MIT, que Nous Research publicó en febrero de 2026. Se instala en tu ordenador, en un servidor de cinco dólares al mes o en un móvil Android, y trabaja con el modelo que tú elijas: Claude, GPT, Gemini, los modelos de Nous o uno que corras en tu casa.

Herramientas tiene más de cuarenta, pero eso hoy lo tiene cualquiera. Lo que no tiene nadie más es el bucle de aprendizaje.

Cuando Hermes resuelve algo que huele a repetible, guarda el procedimiento como una skill y la va afinando cada vez que vuelve a usarla. Mantiene notas sobre tu entorno y un perfil sobre ti que sobreviven al cierre de la terminal. Y un solo proceso, el gateway, lo conecta a Telegram, Discord, Slack, WhatsApp, Signal, email y Home Assistant a la vez.

Y es un proyecto joven que publica versiones cada pocas semanas. Si un comando de esta guía no aparece en tu instalación, primero hermes update y luego la documentación oficialopen_in_new(se abre en una pestaña nueva).

Si vienes de OpenClaw o de Claude Code#

No hace falta que empieces de cero. hermes claw migrate trae la configuración de OpenClaw, y --dry-run te enseña qué haría antes de tocar nada. hermes import-agent lee la de Claude Code o la de Codex.

Antes de instalar#

Cuatro cosas, y ninguna es complicada.

Sistema. Linux, macOS, Windows por PowerShell o por WSL2, y Android con Termux. Un VPS Linux barato sirve para tenerlo encendido siempre. Ojo con el Mac: la documentación oficial soporta solo Apple Silicon. En un Intel no cuentes con ello.

Requisitos previos. Git. En Linux, además, curl y xz-utils. Y ya. El instalador se trae su propio Python 3.11 por uv, Node, ripgrep y ffmpeg, así que no tienes que instalar nada de eso a mano ni tocar el Python del sistema. Si además quieres la aplicación de escritorio, hace falta build-essential (o g++).

Permisos. Sin sudo. El código va a ~/.hermes/hermes-agent/, el comando a ~/.local/bin/hermes y tus datos a ~/.hermes/. Todo dentro de tu carpeta. Hay un modo root que instala en /usr/local para máquinas compartidas, pero no es lo que quieres en tu portátil.

Modelo. Cualquiera con 64.000 tokens de contexto o más. Esto no es una recomendación de rendimiento: Hermes comprueba el contexto al arrancar y rechaza los que no lleguen. Con menos no hay sitio para el trabajo de varios pasos con herramientas.

Quién pone el modelo#

Hermes no cobra nada; el modelo sí. Tres caminos, y se cambian después con un comando, así que esta decisión no te ata.

Nous Portal, para empezar. La suscripción de Nous Research: un solo inicio de sesión da acceso a más de 300 modelos (Claude, GPT, Gemini, DeepSeek, los Hermes de Nous) y al Tool Gateway, que pone búsqueda web, generación de imágenes, voz y navegador sin más claves. Hay un nivel gratuito. Plus son 20 $ al mes con 22 $ de crédito, Super 100 $ con 110 $ y Ultra 200 $ con 220 $. El crédito sin gastar se arrastra hasta un tope (10 $, 50 $ y 100 $), y hay bonus al darte de alta y al renovar. Se configura con un comando y no gestionas ninguna clave.

Tus propias claves. Una clave de Anthropic, OpenAI, Google u OpenRouter, que reúne cientos de modelos bajo una sola. Pagas por uso y la clave se guarda en ~/.hermes/.env. Es la vía si ya tienes claves o quieres control fino del gasto; las herramientas que necesitan servicios externos te pedirán la suya.

Un modelo local. Ollama, vLLM o llama.cpp, en tu máquina o en una GPU alquilada. Gratis por token, privado y exigente: necesitas un modelo con 64k de contexto que corra decentemente. En hermes model eliges «Custom endpoint» y pones la dirección (con Ollama, http://localhost:11434/v1).

Instalar#

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

En Windows nativo, el mismo instalador por PowerShell:

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

Cuando termine, recarga la terminal. Este es el bloque que dice si ha ido bien:

source ~/.bashrc      # en Mac con zsh: source ~/.zshrc
hermes --version
hermes doctor

Si algo falla#

Configurar#

hermes setup            # asistente completo
hermes setup --portal   # directo a Nous Portal, en un solo paso
hermes model            # menú de proveedor y modelo
hermes tools            # encender y apagar herramientas

Dónde vive todo#

~/.hermes/config.yamlmodel: [PROVEEDOR]/[MODELO]
provider: nous          # o anthropic, openrouter, openai…terminal:
backend: local        # en un servidor, docker
timeout: 180approvals:
mode: smart           # smart | manual | offcompression:
enabled: truememory:
memory_enabled: true
user_profile_enabled: true

Si algo se define en dos sitios, manda la línea de comandos sobre config.yaml, que manda sobre .env, que manda sobre los valores por defecto.

Primer uso#

Métete en la carpeta de un proyecto de verdad y pídele algo pequeño. hermes abre la interfaz clásica; hermes --tui la moderna, con paneles.

Mira la carpeta en la que estamos y dime, en cinco líneas, qué es este
proyecto y cuál parece el archivo principal. No modifiques nada.

Verás el bucle entero: lista archivos, lee alguno, resume. Para escribir varias líneas, Alt+Intro (también Ctrl+J o Mayús+Intro). Para interrumpirlo, escribe el mensaje nuevo y pulsa Intro; Ctrl+C también vale.

Los comandos de barra que vas a usar#

hermes -c                                    # retomar la última
hermes --resume id-o-titulo                  # retomar una concreta
hermes sessions list                         # ver las anteriores
hermes journey                               # qué ha ido aprendiendo, y cuándo
hermes chat -q "Resume este repo en 5 puntos"
hermes -z "¿Qué hora es en Tokio?"           # una respuesta y fuera; para scripts
hermes chat --image foto.png -q "¿Qué pone aquí?"

Una sesión por tarea. Lo que quieras que sobreviva va a la memoria, no al chat.

Cuando pide permiso#

Antes de ejecutar algo que pueda hacer daño, Hermes se para y pregunta. En el modo smart, un modelo auxiliar decide qué es inocuo, qué es claramente peligroso y qué es dudoso, y solo lo dudoso llega a ti. Respondes una de cuatro:

• once, solo esta vez
• session, durante esta conversación
• always, siempre: añade el patrón a command_allowlist
• deny, no. Es lo que pasa si no contestas

Empieza respondiendo once. Pasa a always solo con comandos que veas repetirse y que entiendas.

Skills#

El formato sigue el estándar abierto de agentskills.io, así que las skills de Claude Code, de OpenAI o de la comunidad funcionan aquí sin tocarlas.

# ~/.hermes/skills/contenido/informe-semanal/SKILL.md
---
name: informe-semanal
description: Informe semanal de métricas de contenido en Notion
version: 1.0.0
metadata:
  hermes:
    tags: [contenido, notion]
    requires_toolsets: [terminal, web]
---

## When to Use
Cuando pidan el informe semanal, el resumen de la semana o las métricas.

## Procedure
1. Leer las publicaciones de los últimos 7 días de la base de Notion.
2. Calcular alcance, retención media y guardados por pieza.
3. Escribir el informe con la plantilla de templates/informe.md.

## Verification
Las cifras coinciden con las de Notion. Si una falta, se marca como
[SIN DATO], no se estima.

Se cargan solas cuando tu petición encaja con su descripción, o a mano: /informe-semanal hazme el de esta semana. Puedes encadenar hasta cinco en un mensaje.

hermes skills browse                       # ver el catálogo
hermes skills search notion                # buscar en todas las fuentes
hermes skills inspect fuente/ruta/skill    # leerla ANTES de instalar
hermes skills install fuente/ruta/skill
hermes skills list
hermes skills check                        # ¿hay cambios arriba?
hermes skills update
hermes skills uninstall [NOMBRE]

Las fuentes tienen niveles de confianza. official/ y los repositorios de openai/, anthropics/, huggingface/ y NVIDIA/ son de confianza; skills-sh/ y las URLs sueltas son comunidad. Todas pasan por un escáner que busca exfiltración de datos, inyección de prompt y comandos destructivos. Lo dudoso se puede forzar con --force después de leerlo. Lo peligroso se bloquea siempre.

Dejar que las cree él#

Esta es la parte que no tiene nadie más. Puedes provocarla:

Lo que acabamos de hacer lo voy a necesitar cada semana. Conviértelo en
una skill llamada [NOMBRE], con los pasos exactos que has seguido y la
comprobación final de que las cifras coinciden.

Si prefieres revisar antes de que escriba nada en disco:

# en config.yaml
skills:
  write_approval: true

# en el chat
/skills pending      # qué quiere escribir
/skills diff id      # ver el cambio
/skills approve id   # o /skills reject id

¿Tienes skills en otras carpetas, las de Claude Code o las de tu equipo? No las copies: skills.external_dirs en config.yaml con la lista de rutas. Las que vienen dentro de un repositorio clonado exigen confianza explícita con hermes skills trust antes de cargarse.

Memoria#

Dos archivos de texto en ~/.hermes/memories/, que el agente mantiene y tú puedes editar a mano:

• MEMORY.md — sus notas sobre tu entorno, tus convenciones, lo que ha aprendido. Tope de 2.200 caracteres, unos 800 tokens.
• USER.md — tu perfil: preferencias, cómo te comunicas, qué esperas de él. Tope de 1.375 caracteres, unos 500.

Los topes son a propósito, no una limitación técnica: la memoria se carga entera al arrancar cada sesión, y una memoria corta que se cumple vale más que una larga que diluye. Cuando se llena, la herramienta devuelve un error y el agente tiene que consolidar antes de añadir. No se trunca nada en silencio. Si de verdad los necesitas más grandes, memory_char_limit y user_char_limit los mueven, pero piénsatelo: estás gastando contexto en cada arranque.

Hay un detalle que confunde a todo el mundo: lo que se guarda durante una sesión queda en disco al momento, pero se ve en la siguiente. El arranque es una foto fija.

Además de esos dos archivos, Hermes puede buscar en todas tus conversaciones anteriores con búsqueda de texto completo sobre state.db, así que encuentra cosas que no están en la memoria activa sin gastar contexto en cargarlas.

Recuerda que mis vídeos van siempre en español de España, que mi
audiencia no es técnica y que odio las frases de relleno.¿Qué sabes de mí? Enséñame tu USER.md.Busca en nuestras conversaciones anteriores cuándo hablamos del formato
de los guiones y resume lo que decidimos.

hermes journey te enseña cómo ha ido creciendo. Y hermes memory conecta proveedores externos de memoria semántica como Honcho, Mem0 o Supermemory, que para empezar no necesitas.

Al móvil#

El gateway es un único proceso que conecta Hermes a todas las plataformas a la vez y ejecuta las tareas programadas. Lo configuras una vez por plataforma y lo dejas encendido. Telegram es el más sencillo y el más estable: empieza por ahí.

hermes gateway setup                    # asistente: plataforma y tokens
hermes gateway                          # en primer plano, para probar
hermes gateway install                  # como servicio de usuario
sudo hermes gateway install --system    # Linux: que arranque con la máquina
hermes gateway status
hermes gateway stop

En WSL2 los servicios del sistema no siempre funcionan: usa tmux o nohup hermes gateway run.

Telegram#

TELEGRAM_BOT_TOKEN=[TU_TOKEN]
TELEGRAM_ALLOWED_USERS=[TU_ID]        # varios, separados por comas
TELEGRAM_HOME_CHANNEL=[TU_ID]         # a dónde llegan las tareas programadas
TELEGRAM_HOME_CHANNEL_NAME="Mis avisos"

En grupos, los bots de Telegram solo ven los comandos. Para que lea todos los mensajes: en @BotFather, /mybots → tu bot → Bot Settings → Group Privacy → Turn off, y saca y vuelve a meter al bot en el grupo. Autoriza el grupo con TELEGRAM_GROUP_ALLOWED_CHATS (los IDs de grupo son negativos) y, si solo quieres que responda cuando le mencionan, telegram: { require_mention: true }.

El canal «casa» es a dónde van los resultados de las tareas programadas. Desde el propio chat, /sethome lo fija.

Discord#

En discord.com/developers/applications, New Application. En la pestaña Bot, activa los Privileged Gateway Intents Server Members y Message Content: sin el segundo, el bot no lee nada. Reset Token y cópialo, que solo se muestra una vez.

En Installation, genera el enlace de invitación con los ámbitos bot y applications.commands, y permisos para ver canales, enviar mensajes, insertar enlaces, adjuntar archivos y leer el historial.

Tu ID de usuario: Ajustes → Avanzado → Modo desarrollador, y luego clic derecho sobre tu nombre → Copiar ID.

DISCORD_BOT_TOKEN=[TU_TOKEN]
DISCORD_ALLOWED_USERS=[TU_ID]
DISCORD_REQUIRE_MENTION=true          # en canales, solo si le mencionas
DISCORD_FREE_RESPONSE_CHANNELS=[IDS]  # canales donde responde sin mención

WhatsApp#

hermes whatsapp te pregunta el modo (bot, con un número dedicado, o self-chat, hablando contigo mismo) y muestra un QR. En el móvil: WhatsApp → Ajustes → Dispositivos vinculados → Vincular un dispositivo.

WHATSAPP_ENABLED=true
WHATSAPP_MODE=bot                     # bot | self-chat
WHATSAPP_ALLOWED_USERS=[34600000000]  # con prefijo de país, sin el +

Quién puede hablar con tu agente#

Por defecto, nadie. Sin listas de permitidos el gateway rechaza a todo el mundo y te lo avisa al arrancar. Dos formas de abrir la puerta: las listas por plataforma (o la global GATEWAY_ALLOWED_USERS), o el emparejamiento, donde un desconocido que escribe recibe un código de ocho caracteres que caduca en una hora y tú lo apruebas desde la terminal.

hermes pairing approve telegram [CÓDIGO]
hermes pairing list
hermes pairing revoke telegram [ID_USUARIO]

Slack, Signal, email y Home Assistant se configuran con el mismo hermes gateway setup. Para Slack, hermes slack genera el manifiesto de la app.

Tareas programadas#

Con el gateway encendido, Hermes ejecuta tareas a la hora que le digas, en una sesión nueva cada vez, y te manda el resultado a donde quieras. Se pide en lenguaje normal.

Cada día laborable a las 8, revisa las novedades de los tres canales
de YouTube de mi lista canales.txt, resume en cinco líneas lo que han
publicado y mándamelo por Telegram. Si no hay nada nuevo, no me escribas.

Eso ya crea la tarea. Si prefieres verla y tocarla desde la terminal:

hermes cron create "every 2h" "Comprueba que la web responde"
hermes cron list
hermes cron run [ID]                       # ejecutarla ahora
hermes cron pause [ID]                     # y resume
hermes cron edit [ID] --schedule "weekdays at 9am"
hermes cron remove [ID]

El resultado va a origin (donde se creó la tarea), a local (se guarda en ~/.hermes/cron/output/), a una plataforma concreta o a all. El gateway mira el reloj cada minuto.

Seguridad#

approvals:
  mode: smart      # smart (recomendado) | manual (pregunta siempre) | off
  timeout: 300     # segundos esperando tu respuesta
  cron_mode: deny  # qué hacer sin nadie delante
  deny:            # tus propias prohibiciones, siempre
    - "git push --force*"
    - "*curl*|*sh*"

Hay una lista negra que no se salta ni con --yolo ni con mode: off: borrar la raíz del disco, bombas de procesos, formatear discos montados, descargar y ejecutar desde una tubería. Y hay archivos que el agente no puede escribir aunque quiera: ~/.ssh, ~/.aws, sus propios auth.json y .env, y los .env de tus proyectos. HERMES_WRITE_SAFE_ROOT restringe además todas las escrituras a las carpetas que digas.

Dónde ejecuta los comandos#

terminal:
  backend: docker
  docker_image: "nikolaik/python-nodejs:python3.11-nodejs20"
  container_persistent: true
  container_memory: 4096   # MB
  container_cpu: 2
  cwd: "/opt/data"

Si lo montas en un VPS#

• Listas de permitidos explícitas o emparejamiento. Jamás «permitir a todos».
• Backend docker con límites de CPU, memoria y disco, y usuario sin privilegios.
• Secretos en ~/.hermes/.env con permisos 600, y nada más ahí.
• Revisar de vez en cuando command_allowlist y los registros de ~/.hermes/logs/.
• Actualizar con hermes update. hermes doctor avisa además de paquetes de Python comprometidos.
• Cinturón y tirantes: gateway en una máquina y ejecución en otra por ssh, y security.allow_lazy_installs: false para que ninguna configuración instale dependencias por su cuenta.

Mantener#

hermes update                  # última versión; sincroniza skills de todos los perfiles
hermes backup                  # zip con configuración, memoria, skills y sesiones
hermes import archivo.zip      # restaurar en otra máquina
hermes profile create trabajo  # un Hermes aparte, con su memoria y sus skills
hermes profile list
hermes -p trabajo              # usarlo
hermes status                  # agente, autenticación y plataformas
hermes logs                    # registros del agente y del gateway
hermes insights                # tokens, coste y actividad
hermes dashboard               # panel web de configuración y sesiones
hermes mcp                     # conectar servidores MCP
hermes uninstall

Los perfiles exportados no llevan credenciales; para una copia completa, hermes backup. Y si te pasas al ordenador nuevo: backup en el viejo, instalador en el nuevo, import. Diez minutos.

Cuando algo no va#

Antes de nada, la secuencia oficial de recuperación. Casi todo se arregla en los dos primeros pasos:

hermes doctor → hermes model → hermes setup → hermes sessions list → hermes -c → hermes gateway status

Para pedir ayuda: hermes dump genera un resumen de tu instalación sin secretos, listo para pegar. hermes debug share sube un informe con los registros.

Verificado contra la documentación oficial de Hermes Agent y la página de planes de Nous Portal en septiembre de 2026. El proyecto publica versiones cada pocas semanas: si un comando no coincide, hermes update primero y la documentación después.