Hermes Agent: referencia para profesionales (2026)

TL;DR: Hermes Agent es un agente de IA de código abierto y mejora continua creado por Nous Research. Funciona como una CLI y como un gateway de mensajería multiplataforma, almacena en disco una identidad duradera y memoria persistente, reúne skills que mejoran con el uso y es compatible con cualquier proveedor de LLM compatible con OpenAI: Nous Portal, OpenRouter, Anthropic, GitHub Copilot, z.ai, Kimi, MiniMax, DeepSeek, Qwen Cloud, Hugging Face, Google, xAI/SuperGrok o tu propio endpoint autoalojado.¹²¹⁹ La versión actual es la v0.21.5 (etiqueta v2026.9.24, 24 de septiembre de 2026), un parche acumulativo de la línea v0.21; Novedades de la versión v0.21.5 explica qué cambió, y las secciones de versiones posteriores están ordenadas de la más reciente a la más antigua.⁵² Para la mayoría de los usuarios nuevos, la parte más difícil es la autenticación con proveedores: Hermes incluye 39 proveedores en su lista estática de selección en la etiqueta v2026.9.24 y amplía automáticamente esa lista mediante 38 plugins de proveedores incluidos, además de endpoints personalizados y tres rutas de autenticación distintas (clave de API en .env, OAuth mediante hermes model o un endpoint personalizado en config.yaml).⁵³ El modelo de autenticación es lo primero que debes aprender: todo lo demás depende del proveedor que se resuelva.

Hermes Agent funciona como un entorno de ejecución de agentes completo, no como una capa de chat. Lee tu sistema de archivos, ejecuta comandos en backends aislados, extrae contenido de la web, crea subagentes, ejecuta tareas cron programadas, se comunica con Telegram/Discord/Slack/WhatsApp/Signal/Email desde un único proceso de gateway y crea sus propios skills a partir de la experiencia.¹ La CLI es una interfaz de terminal construida sobre un bucle de conversación en run_agent.py; el gateway es un proceso de larga duración que canaliza los mensajes de las plataformas de mensajería a través del mismo bucle de conversación.³

La diferencia entre un uso ocasional y uno experto de Hermes se reduce a cinco sistemas. Domínalos y Hermes se convertirá en un multiplicador de capacidades:

1. Resolución de proveedores: cómo se asignan los flujos de autenticación a las llamadas de API
2. Jerarquía de configuración: config.yaml + .env + auth.json + SOUL.md + AGENTS.md
3. Sistema de herramientas y toolsets: qué puede hacer el agente, con permisos específicos para cada plataforma
4. Sistema de skills: memoria procedimental que el agente crea y perfecciona
5. Gateway + cron + profiles: ejecutar Hermes donde desarrollas tu actividad, no solo donde te encuentras

Puntos clave

• La autenticación con proveedores tiene tres rutas, no una. Clave de API en .env, OAuth mediante hermes model/hermes auth o un endpoint personalizado en config.yaml. Elige la ruta adecuada para tu proveedor, no la que te resulte más familiar.
• Cambiar de proveedor requiere un solo comando. hermes model te guía de forma interactiva por todos los proveedores compatibles, incluidos los inicios de sesión con OAuth, mientras que /model provider:model permite cambiar durante una sesión sin perder el historial.²
• Dos archivos conforman la superficie de configuración que puede editar el usuario. ~/.hermes/config.yaml contiene la configuración y ~/.hermes/.env, los secretos. Hermes administra directamente auth.json, SOUL.md, MEMORY.md y skills/: puedes editar SOUL.md manualmente, pero el propio agente modifica los demás.⁴
• Hermes es el sucesor de OpenClaw. Si estás migrando, hermes claw migrate importa automáticamente más de 30 categorías de estado.⁵
• De forma predeterminada, las tareas auxiliares utilizan tu modelo principal. La visión, la clasificación de aprobaciones, la compresión y los títulos de sesión se ejecutan como llamadas «auxiliares» independientes de LLM, y en esta etiqueta auto dirige todas ellas a tu modelo de chat principal: no hay nada que configurar, pero, con modelos de razonamiento costosos, estas tareas secundarias aumentan el costo de manera considerable. Cuando esto sea importante, asigna modelos rápidos y económicos a cada espacio auxiliary.<task>.⁴³⁴

Todas las secciones siguientes se basan en la documentación original disponible en hermes-agent.nousresearch.com/docs y en el árbol de código fuente de github.com/NousResearch/hermes-agent. Cada afirmación factual incluye una nota al pie que remite a la página original específica de la que procede.

Elige tu ruta

Cómo funciona Hermes: el modelo mental

Hermes está estructurado en torno a un único ciclo de conversación que puede invocarse desde cualquier punto de entrada. Los puntos de entrada son la CLI (cli.py), el gateway de mensajería (gateway/run.py), el adaptador ACP para la integración con editores, el ejecutor por lotes y un servidor API.³ En última instancia, todos llaman a AIAgent.run_conversation() en run_agent.py, que:

1. Construye el prompt del sistema a partir de SOUL.md, MEMORY.md, USER.md, las skills, los archivos de contexto y las instrucciones para las herramientas mediante agent/prompt_builder.py (la reorganización de septiembre de 2026 lo trasladó al nuevo paquete agent/)³
2. Resuelve el proveedor en tiempo de ejecución mediante runtime_provider.py; en este paso se seleccionan la autenticación, la URL base y el modo API³
3. Llama al proveedor mediante uno de tres modos API: chat_completions, codex_responses o anthropic_messages³
4. Procesa las llamadas a herramientas devueltas mediante model_tools.py y el registro central de herramientas (tools/registry.py)³
5. Repite el ciclo hasta que el modelo produce una respuesta final y, después, guarda la sesión en SQLite con FTS5³

Entender este ciclo es importante porque todas las funciones —personalidades, memoria, skills, compresión y mecanismos de respaldo— se conectan a una de estas etapas. Cuando leas una clave de configuración y te preguntes qué hace, la respuesta suele ser: «es un ajuste de las etapas 1, 2, 3 o 4 del ciclo anterior».

Núcleo independiente de la plataforma. Una sola clase AIAgent sirve a la CLI, el gateway, ACP, el procesamiento por lotes y el servidor API. Las diferencias entre plataformas se encuentran en el punto de entrada, no en el agente.³ Por eso, los mismos comandos con barra funcionan tanto en la terminal como en Telegram: se procesan desde un COMMAND_REGISTRY compartido en hermes_cli/commands.py.⁶

La estructura de directorios es el sistema. Hermes almacena todo en ~/.hermes/ (o en $HERMES_HOME para los profiles que no sean el predeterminado):⁴

~/.hermes/
├── config.yaml        # Settings (model, terminal, TTS, compression, etc.)
├── .env               # API keys and secrets
├── auth.json          # OAuth provider credentials (Nous Portal, Codex, Anthropic)
├── SOUL.md            # Primary agent identity (slot #1 in system prompt)
├── memories/          # Persistent memory (MEMORY.md, USER.md)
├── skills/            # Bundled + agent-created + hub-installed skills
├── cron/              # Scheduled jobs
├── sessions/          # Gateway session state
└── logs/              # agent.log, gateway.log, errors.log (secrets auto-redacted)

Cada archivo anterior tiene una función específica; ninguno se superpone con otro. Si quieres saber «dónde almacena Hermes X», la respuesta está entre estos archivos.

Novedades de v0.21.5 (el paquete acumulativo del 24 de septiembre)

Hermes Agent v0.21.5 (etiqueta v2026.9.24, 24 de septiembre de 2026) es la versión actual y el tercer paquete acumulativo menor de la línea v0.21.x: «Esta etiqueta reúne en una versión estable las cerca de 460 solicitudes de cambio incorporadas desde v0.21.4 para los consumidores posteriores». Las notas seleccionadas vuelven a posponerse hasta v0.22.0. Estos son los cambios relevantes para quienes operan el sistema, verificados en el código fuente correspondiente a la etiqueta:⁵²⁵³

• La memoria Hindsight sale del árbol principal. El proveedor Hindsight incluido y el complemento de pip hermes-agent[hindsight] se eliminaron; Hindsight ahora se instala desde el catálogo de plugins y su mantenimiento está a cargo de Vectorize; las notas de la versión no lo mencionan. Si tu configuración establece memory.provider: hindsight, hermes update instala el plugin del catálogo en el directorio de inicio de cada profile que lo especifique. Si aún falta, también se instala al iniciar el agente por primera vez, salvo que security.allow_lazy_installs sea false (en ese caso, ejecuta hermes plugins install hindsight). La configuración, las claves de .env y los datos de memoria no se modifican. Consulta Proveedores de memoria externos.
• gateway.multiplex_profiles: false deja de estar disponible. El gateway lo cambia directamente a true y muestra una sola vez un aviso enmarcado. Si un profile con nombre debe conservar su propio gateway, establece gateway.standalone: true en su propio config.yaml; para desconectar uno de los profiles atendidos, hermes -p <name> gateway stop ahora lo pone en espera sin detener el host. Consulta Gateway de mensajería.
• Nuevos modelos en los selectores de Nous y OpenRouter: GPT-6 Sol y GPT-6 Luna (cada uno con una variante -pro), además de Claude Opus 5.5.
• La compatibilidad de los plugins no cambia: plugins.allow_deprecated_imports: true sigue funcionando.

Para actualizar: hermes update o el comando de instalación de una sola línea; las imágenes de Docker y Hermes Cloud se generan a partir de nousresearch/hermes-agent:v2026.9.24.⁵²

Novedades de v0.21.4 (El segundo parche acumulativo)

Hermes Agent v0.21.4 (etiqueta v2026.9.21, 21 de septiembre de 2026) es la segunda versión acumulativa deliberadamente acotada de la línea v0.21.x. Según su propia descripción: «Versión de parche. Esta etiqueta reúne los cerca de 1.800 PR fusionados desde v0.21.3 en una versión estable con etiqueta para consumidores posteriores (imágenes de Docker, Hermes Cloud e implementaciones alojadas)». El periodo desde v0.21.3 abarca «5.071 commits sin fusiones» en «5.169 archivos modificados», «1.812 PR fusionados» y «2.116 incidencias cerradas». Por cantidad de commits, es el segundo mayor intervalo entre etiquetas en la historia del proyecto, solo por detrás de los 5.139 de v0.21.1; por cantidad de PR fusionados, es el mayor. La narración seleccionada vuelve a aplazarse, textualmente: «Las notas completas y seleccionadas de esta versión se publicarán con v0.22.0 y documentarán todo a partir de v0.21.0» y «No se omite nada de este periodo». La nota sí enumera lo que deja sin documentar, y cada elemento incluido a continuación se verificó en el código fuente de la etiqueta; cuando uno modifica una sección permanente de esta guía, el enlace aparece en la misma línea.⁵⁰⁵¹

• Un gateway por host, y Desktop se conecta en lugar de crear otra instancia. La regla es un hermes serve y un hermes gateway run por host y por usuario del sistema operativo, cada uno multiplexando todos los profile. Esto se aplica mediante una nueva capa singleton que abarca todo el host: un bloqueo del host que se mantiene durante toda la vida del proceso que lo obtiene, además de un registro de encuentro que contiene (pid, createTime), de modo que una segunda invocación puede comprobar que el propietario es el mismo proceso activo y conectarse a él en lugar de enlazar un segundo puerto. La obsolescencia se demuestra, nunca se presupone, y la aplicación Desktop aplica la misma idea desde su lado, conectándose al backend activo del host en vez de iniciar otro. Gateway de mensajería explica el funcionamiento.⁵¹
• Los conectores se convierten en una única operación controlada por el backend, con una sola tarjeta de configuración. Una llamada a la herramienta manage_connections controla en el backend una máquina de estados de conexión basada únicamente en datos, y Desktop, TUI y CLI la representan mediante la misma tarjeta de configuración: un campo por cada credencial faltante, cuyo verbo permanece deshabilitado hasta que todos los campos obligatorios contienen texto. Consulta la subsección del nivel gratuito de Nous.⁵¹
• --format stream-json: ejecuciones únicas legibles por máquinas. hermes chat -q ... --format stream-json emite un objeto JSON por cada línea de stdout para ejecutores de CI y orquestadores: un evento system/init, seguido de incrementos de text y eventos tool_use / tool_result, y finalmente un sobre result terminal que contiene el código de salida, el texto final y las estadísticas de tokens. Los diagnósticos y el ID de sesión permanecen en stderr, la salida de las herramientas se limita a 5.000 caracteres por evento, la opción implica --quiet, requiere -q o --query-file (termina con el código 2 si no se proporciona ninguno) y no puede combinarse con --tui. La tabla de opciones de hermes chat incluye esta opción.⁵¹
• skills.auto_load fija skills en todas las sesiones. Los nombres incluidos en skills.auto_load dentro de config.yaml se cargan por completo en cada sesión nueva —tanto en CLI como en TUI, gateway, cron y API— y se resuelven una sola vez cuando se construye el prompt por primera vez. Sistema de skills incorpora una subsección sobre skills fijados.⁵¹
• Una opción decline para mensajes directos no autorizados. unauthorized_dm_behavior incorpora un tercer valor junto a pair e ignore: decline envía una negativa cortés y después permanece en silencio ante ese remitente durante 24 horas. Consulta Autorización y vinculación de usuarios.⁵¹
• mcp.discovery_concurrency limita las conexiones de detección de MCP. El valor predeterminado es 4 y 0 significa ilimitadas; todos los servidores configurados siguen conectándose, pero ya no lo hacen simultáneamente. Consulta Integración con MCP.⁵¹
• session_search incorpora límites temporales y un nuevo intento para mejorar la recuperación. La forma de detección admite límites after/before (en formato ISO o como duraciones relativas, por ejemplo 7d), y una consulta de varias palabras sin resultados vuelve a intentarse buscando CUALQUIER término, en lugar del AND implícito entre todos los términos de FTS5. Consulta Búsqueda de sesiones.⁵¹
• hermes sessions set-journal-mode delete|wal: el conversor sin conexión del journal. Es la vía de autoservicio para un state.db atascado en el modo incorrecto del journal de SQLite, algo que antes exigía ejecutar manualmente PRAGMA journal_mode=DELETE. Primero, detén el gateway, el dashboard y todas las instancias de CLI: el comando se niega a continuar mientras algún proceso externo mantenga abierta la base de datos, cambia el modo sin esperar a que se cierren otros procesos y después verifica los bytes del encabezado de SQLite. Windows no permite detectar qué procesos mantienen abierto el archivo, por lo que allí se negará a continuar hasta que uses --force, después de detener manualmente todos los procesos de Hermes. Ahora hermes doctor indica que debes usar este comando. La fila de hermes sessions en Comandos de nivel superior lo incluye.⁵¹
• Desktop: configuración de fuente, actualizaciones del motor con un clic y desinstalación de plugins. Configuración incorpora un campo de familia tipográfica que se conserva por profile en desktop.font_family: sustituye la fuente sans del tema en el chat y la interfaz, la lista de sugerencias comienza con fuentes de accesibilidad (OpenDyslexic, Atkinson Hyperlegible y Lexend), y dejarlo vacío permite que el tema decida. El entorno administrado de ejecución de modelos locales muestra un botón «Actualizar motor» cuando hay una actualización disponible; si falla, el botón permanece visible para volver a intentarlo directamente. Además, el centro de Plugins permite desinstalar un plugin mediante un cuadro de confirmación.⁵¹
• Catálogos de video: LTX 2.5 y Kling O3. El plugin de video de FAL incorpora ltx-2.5 (el modelo de audio y video de código abierto de Lightricks: audio nativo, conversión de imagen a video de hasta 20 s / 4K, preajustes de movimiento de cámara y nivel económico; fal rechaza clips de más de 10 s a 1440p/2160p) y kling-o3 (la familia de vanguardia de Kuaishou, de nivel premium: narración nativa con varias tomas, audio opcional y duración de 3 a 15 s).⁵¹
• El catálogo de plugins se convierte en un directorio incluido y en un sitio web. El directorio plugin-catalog/ del repositorio creció de 9 entradas en v2026.9.14 a 228 en esta etiqueta: un YAML revisado por plugin, fijado a un SHA de commit exacto. Además, el sitio de documentación ahora genera una página por plugin y otra por autor, cada una de las cuales muestra el README del plugin desde el commit fijado. Los diez plugins de la comunidad mencionados en la versión aparecen como entradas del catálogo en esta etiqueta. Sistema de plugins contiene los detalles.⁵¹
• Y una gran serie de correcciones en el aislamiento de profile y multiplexación, cron, kanban, Desktop y state.db, que la versión solo menciona como categoría; corresponderá a v0.22.0 redactar el registro seleccionado de esas correcciones.⁵⁰

La reversión de compatibilidad de plugins todavía no se incorporó en este periodo. COMPAT_MANIFEST.md, compat_manifest.json y las capas de compatibilidad están presentes en v2026.9.21; los únicos cambios realizados en hermes_cli/plugin_compat.py durante este periodo son una caché de análisis para todo el proceso (un gateway multiplexado detecta los plugins una vez por cada profile atendido, y volver a analizar el código fuente de cada plugin costaba cerca de 0,4 s por profile durante el arranque) y rutas de coincidencia con formato POSIX en Windows (#112576). La restricción por fecha y la vía de escape mediante un booleano literal no cambiaron, por lo que plugins.allow_deprecated_imports: true todavía permite cargar los plugins afectados. El recuadro de compatibilidad de Sistema de plugins muestra el estado actual.⁴²

El proceso de actualización no cambia: hermes update (para instalaciones mediante git) o el instalador de shell para instalaciones nuevas; las imágenes de Docker y Hermes Cloud se generan a partir de esta etiqueta (nousresearch/hermes-agent:v2026.9.21).⁵⁰

Novedades de v0.21.3 (El parche del 14 de septiembre)

Hermes Agent v0.21.3 (etiqueta v2026.9.14, 14 de septiembre de 2026) reúne tres días más de main en una nota de dos puntos, publicada porque los agentes de Cloud se actualizan automáticamente a la etiqueta de versión más reciente y las correcciones de inicio de sesión del gateway remoto debían llegar hasta ellos. (1) Las sesiones remotas del dashboard ya no se revocan debido a ráfagas de actualización: ambas rutas de actualización del gateway (la protección mediante cookies y la ruta bearer nativa de Desktop) ahora agrupan las solicitudes simultáneas que contienen el mismo token de actualización rotatorio en una sola operación, por lo que una ráfaga producida al reactivarse Desktop ya no puede reproducir ante la detección de reutilización de Portal un token que ya había rotado y revocar toda la sesión. Además, la actualización se ejecuta fuera del bucle de eventos, por lo que un proveedor de identidad lento ya no bloquea /api/status. (2) Los procesos de larga duración dejan de crear identificadores de escritura duplicados para state.db: los lectores del gateway, del backend de dashboard/desktop, de ACP y de CLI se conectan en modo de solo lectura, mientras que los escritores del mismo proceso comparten el identificador del registro. Estadísticas del periodo: «1.036 commits sin fusiones» en «2.642 archivos modificados» y «338 PR fusionados». Todo lo demás se aplaza intencionalmente: la versión enumera lo que no documenta (selectores del nivel de razonamiento en cada selector de modelos, PKCE de OAuth de OpenRouter, decodificación HEIF/HEIC/AVIF, una oleada del catálogo de FAL, tablas pegadas en Slack y el API de Agent Sessions, el rechazo del modo WAL de state.db en sistemas de archivos entre máquinas virtuales y más) y se compromete con el registro seleccionado, textualmente: «Las notas completas y seleccionadas de esta versión se publicarán con v0.22.0 y documentarán todo a partir de v0.21.0» y «No se omite nada de este periodo».⁴⁹

Y el plazo de compatibilidad de plugins llegó según lo previsto. La eliminación del 14 de septiembre de 2026 anunciada en v0.21.1 entró en vigor como una restricción por fecha dentro del código distribuido, no como una reversión del código: en la etiqueta v2026.9.14, hermes_cli/plugin_compat.py contiene COMPAT_REMOVAL_DATE = 2026-09-14, y removal_in_effect() devuelve true desde esa fecha (o en cuanto desaparece el archivo de manifiesto), por lo que un plugin externo afectado queda deshabilitado durante la carga y muestra el aviso rojo. Lo que todavía NO ocurrió es la reversión que elimina realmente las rutas de importación antiguas. COMPAT_MANIFEST.md, compat_manifest.json y las capas de compatibilidad siguen presentes en la etiqueta —y también en v2026.9.21 y en main al 22 de septiembre—, razón por la cual plugins.allow_deprecated_imports: true todavía funciona como vía de escape: las rutas antiguas siguen resolviéndose una vez que se permite continuar al cargador. Hay dos detalles importantes: la clave debe ser un booleano YAML literal (el código solo acepta el booleano True; una cadena entre comillas como "true" o "false" se trata como si no estuviera configurada, según el comentario del código «Solo booleanos literales»), y la vía de escape deja de funcionar en cuanto se incorpore la reversión, porque las propias rutas desaparecerán. El recuadro de compatibilidad de Sistema de plugins muestra el estado actual.⁴²⁴⁹

Novedades de v0.21.2 (la versión de parche para state.db)

Hermes Agent v0.21.2 (etiqueta v2026.9.11, 11 de septiembre de 2026) existe, ante todo, para corregir lo que v0.21.0 rompió. La versión lo dice claramente: «v0.21.0 incluyó una amplia reescritura de la gestión de conexiones del almacén de sesiones y, en algunas instalaciones, volvió frágil a state.db: los escritores secundarios cancelaban mutuamente sus bloqueos, las bases de datos en buen estado se marcaban como dañadas y una sola fila defectuosa hacía fallar sessions list. Esta versión soluciona esa clase de problemas e incorpora todo lo demás que llegó a main durante los cuatro días posteriores a v0.21.1». A diferencia de la nota deliberadamente escueta de v0.21.1, esta versión documenta sus propios aspectos destacados; las estadísticas del periodo son «947 commits sin fusión» en «1.869 archivos modificados» y «312 PR fusionados» de «140 colaboradores», mientras que el registro seleccionado de todo el ciclo v0.21.x sigue siendo responsabilidad de v0.22.0.⁴⁸

• La campaña de confiabilidad de state.db: seis PR y 44 problemas cerrados. Las recomendaciones para operadores aparecen primero en las notas de la versión, y también deberían ser tu punto de partida: si tu state.db se dañó con 0.21.0 o 0.21.1, ejecuta hermes doctor; ahora distingue entre daños estructurales y daños en el índice de búsqueda de texto completo, en lugar de llamar a todo «daño de escritura en FTS», y te dirige a hermes sessions recover --inspect-only (sin conexión, no destructivo y vinculado al profile; informa si se pueden leer las tablas canónicas sin crear una base de datos de salida) cuando una reconstrucción no basta. El trabajo sobre la causa raíz elimina todos los escritores secundarios del almacén: los gateways de los profiles escribían el estado de las salas alojadas en el state.db raíz cada 5 segundos, y esa coordinación ahora reside en un archivo shared-state.db dedicado, de modo que los gateways de los profiles nunca abren el almacén maestro de sesiones con permisos de escritura; el panel lo abre primero en modo de solo lectura; la protección del ciclo de vida de cron pasa por el registro de conexiones supervisadas en vez de usar un open() directo sobre una base de datos activa (lo que cancela los bloqueos POSIX del gateway: la receta clásica para dañar SQLite); y doctor --fix rechaza cualquier checkpoint cuya seguridad no pueda demostrar. Más allá de los escritores: los daños en el índice FTS ahora degradan la búsqueda y hacen que el índice se reconstruya posteriormente, en vez de cerrar con error todo el turno; una fila dañada ya no hace fallar sessions list, la exportación ni las estadísticas (las filas defectuosas se muestran como ?, junto con una advertencia que identifica la sesión); las sesiones nunca se vinculan con la base de datos de otro profile ni la consultan; y abrir en modo de solo lectura ya no adquiere el bloqueo de escritura, por lo que una ejecución puntual de hermes detrás de un gateway ocupado pasó de bloquearse y fallar tras 4-20 s a tardar 0,01 s.⁴⁸
• Refuerzo del aislamiento entre múltiples profiles. Desde v0.19.0, esta guía ha reiterado la afirmación del proyecto de que el enrutamiento por profile proporciona a cada uno «configuración, skills, memoria y secretos completamente aislados». En v0.21.2, esa promesa tenía brechas que ahora se han cerrado: los bots de profiles secundarios heredaban las listas de permitidos del profile predeterminado, los adaptadores podían enviar credenciales al host del profile predeterminado, los servidores stdio MCP recibían los secretos de la bóveda del profile predeterminado, la entrega mediante MEDIA: podía adjuntar el .env/auth.json/state.db de otro profile, los callbacks de webhooks y Feishu podían desviarse del profile al que habían sido dirigidos, y los profiles secundarios podían obtener el token de portador de Nous de otro profile mediante memorias por proceso (#107609-#107630). Si ejecutas varios profiles bajo un único gateway multiplexado, esta es la versión en la que la promesa de aislamiento realmente se cumple.⁴⁸
• La bóveda de credenciales que oculta las contraseñas. El agente ahora puede iniciar sesión, pagar y completar direcciones en el navegador mediante 1Password, Bitwarden o la bóveda local de Hermes sin ver jamás ningún secreto; además, los códigos de autenticación de dos factores provienen de una clave de autenticación guardada (TOTP: una semilla base32 o un URI otpauth://totp; se rechaza el HOTP basado en contador) o se solicitan en tu interfaz. Cada backend entrega al agente la misma estructura: metadatos de inicio de sesión y un identificador opaco con espacio de nombres (vault_ para la bóveda local, op:, bw:), mientras que la contraseña solo se obtiene al momento de completar el campo; los gestores externos permanecen bloqueados hasta que los desbloqueas durante la sesión, y la contraseña maestra «nunca se proporciona como argumento de una herramienta, nunca aparece en argv y nunca se conserva». Esto amplía el trabajo de SecretSource realizado en v0.19.0, que eliminó las claves API de proveedores del archivo .env de texto sin formato; ahora la bóveda hace lo mismo con las credenciales de navegación del agente.⁴⁸
• Un catálogo seleccionado de plugins fijados mediante SHA. hermes plugins browse muestra «todas las entradas del catálogo seleccionado de plugins», hermes plugins search consulta el catálogo y hermes plugins install admite nombres del catálogo, además de URL de Git y referencias owner/repo. hermes plugins pack completa el conjunto con «colecciones declarativas y compartibles de plugins»: un archivo hermes-pack.yaml que fija un conjunto de plugins a commits SHA exactos, pack install que distribuye la tarea entre instalaciones fijadas normales mientras el consentimiento de capacidades se mantiene por plugin, pack export que genera un pack de la instalación actual y pack show que funciona como simulación. El bloque de comandos de Sistema de plugins incluye los nuevos subcomandos.⁴⁸
• Nivel gratuito de Nous y primer inicio guiado. Las instalaciones nuevas incluyen inferencia y conectores gratuitos desde el primer momento, con un solo comando para iniciar sesión; /login funciona desde un chat y las herramientas de los conectores (Gmail, Linear, Notion y las demás) se pueden buscar mediante tool_search. El primer inicio guiado de la aplicación de escritorio se controla con HERMES_GUEST_ONBOARDING=1, y solo el valor literal 1 lo habilita: la propia prueba de la aplicación verifica que 'true', '0' y un valor vacío lo mantengan desactivado, y la decisión de inicio se registra en el entorno del backend generado para impedir que se filtre un valor heredado. Consulta Nous Tool Gateway.⁴⁸
• Se acabaron las avalanchas de creación de backends en la aplicación de escritorio. Bot Mode solía crear un backend o conectarse a uno por cada profile al iniciar y en cada actualización de la lista; pasar el cursor sobre la lista de Bots generaba un backend por fila, y cambiar de profile podía crear un backend principal duplicado. Todo esto se corrigió en esta versión.⁴⁸

El proceso de actualización no ha cambiado: ejecuta hermes update desde una instalación existente o usa el instalador de shell para una instalación nueva.⁴⁸

Novedades de v0.21.1 (el parche acumulativo)

Hermes Agent v0.21.1 (etiqueta v2026.9.7, 7 de septiembre de 2026) es deliberadamente escueta: una «versión de parche» que «agrupa el estado actual de main desde v0.21.0 para las implementaciones etiquetadas y los consumidores posteriores». El texto presenta las estadísticas del periodo —«5.139 confirmaciones sin fusión en 4.364 archivos modificados (+601.014 / -768.419)» y «632 PR fusionados»— y luego aplaza el relato: «Las notas de la versión completas y seleccionadas para este periodo se publicarán con v0.22.0». Esto convierte al periodo entre etiquetas en el mayor de la historia del proyecto (ningún periodo anterior entre etiquetas adyacentes supera las 2.790 confirmaciones sin fusión de v2026.7.20..v2026.7.30), publicado con las notas de versión más breves. Hasta que v0.22.0 presente el registro seleccionado, los seis grupos siguientes recogen los cambios que afectan la forma en que utilizas Hermes con esta etiqueta, cada uno verificado en el código fuente.⁴¹

• La base de código se descompuso y el plazo de compatibilidad de los plugins vence el 14 de septiembre. La descomposición de septiembre de 2026 (PR #102117) dividió los grandes módulos del repositorio en archivos específicos: un nuevo paquete agent/ contiene los componentes internos del bucle de conversación (214 módulos de nivel superior más siete subpaquetes; prompt_builder.py ahora se encuentra en agent/prompt_builder.py, mientras que run_agent.py sigue albergando AIAgent), los analizadores de subcomandos de la CLI se trasladaron a un paquete hermes_cli/subcommands/ (61 módulos), la lista estática CANONICAL_PROVIDERS pasó de hermes_cli/models.py a hermes_cli/models_catalog_static.py (la lista no cambió: 39 entradas estáticas, que siguen ampliándose automáticamente a partir de 39 directorios de plugins de proveedores incluidos) y delegate_task se dividió entre aproximadamente una docena de módulos tools/delegate_tool_*. Las rutas de importación internas no son una API estable, por lo que un nuevo COMPAT_MANIFEST.md en la raíz del repositorio reexporta 1.148 nombres públicos «moved-lazy» desde sus antiguas rutas de módulo; cada uno emite una HermesPluginCompatWarning una vez por nombre y proceso cuando se resuelve. La capa de compatibilidad era temporal y su eliminación entró en vigor según lo previsto el 2026-09-14, seis días después de la etiqueta: no mediante una reversión del código, sino a través de una condición de fecha ya incluida en el código publicado. Desde esa fecha, un plugin de terceros afectado no se carga: el aviso de la CLI, hermes doctor y hermes update muestran una notificación roja que identifica el plugin deshabilitado; la aplicación de escritorio muestra un cuadro de diálogo una sola vez; y hermes plugins list indica el motivo. Si utilizas plugins externos, revísalos: hermes plugins compat <path> muestra cada file:line con la ruta antigua -> ruta nueva y devuelve el código de salida 1 mientras quede alguna referencia (--json genera una salida procesable por máquinas; ejecútalo sin argumentos para analizar todo el conjunto instalado). La solución temporal para un plugin cuyo autor aún no se haya puesto al día es plugins.allow_deprecated_imports: true en config.yaml, y sigue funcionando: la reversión que elimina realmente las rutas de importación antiguas aún no se había incorporado al 22 de septiembre (verificado hasta la etiqueta v2026.9.21 y en main), por lo que las rutas antiguas todavía se resuelven cuando se permite que el cargador continúe. Los detalles posteriores se encuentran en Novedades de v0.21.2, más arriba; la sección Sistema de plugins contiene el recuadro con el estado actual.⁴²
• Las conversaciones del gateway ya no rotan por temporizadores, en absoluto. La documentación del ciclo de vida de las sesiones ahora establece el contrato de forma explícita: «La inactividad y el tiempo transcurrido nunca provocan la rotación de una conversación. /new y /reset crean un límite explícito; la compresión de contexto sigue gestionando los historiales extensos. La configuración heredada de temporizadores se ignora. El tipo de datos SessionResetPolicy existente constituye información inerte de compatibilidad, no una política de ejecución». Los límites son explícitos y los establece el usuario; si conservaste temporizadores de reinicio de sesión de la época de OpenClaw mediante hermes claw migrate, ahora son datos inertes. Consulta Gateway de mensajería.⁴³
• La autorización de MCP incorpora un flujo de código de dispositivo. hermes mcp login <name> incorpora --flow {browser,device}: browser es el flujo PKCE existente, device es un inicio de sesión mediante código de dispositivo conforme a RFC 8628 para computadoras donde una devolución de llamada del navegador resulta poco práctica, y la opción prevalece sobre la configuración oauth.flow del servidor. Durante este periodo también se reforzó el resto de la superficie de autenticación de MCP: la propiedad del profile se aplica en todas las sesiones de OAuth, las cachés de metadatos de OAuth con formato incorrecto se ignoran en vez de bloquear un servidor, y la aplicación de escritorio retransmite el OAuth de MCP mediante devoluciones de llamada locales del cliente. Otro cambio relacionado: -t/--toolsets ahora también filtra qué servidores de MCP configurados llegan a iniciarse, por lo que una ejecución puntual de hermes -z -t <toolsets> evita el arranque en frío de los servidores que no necesita. El bloque de comandos de Integración de MCP ahora incluye login y reauth [--all]; ambos son anteriores a este periodo, pero todavía no se habían documentado aquí.⁴⁴
• La delegación ahora refleja con transparencia el trabajo en segundo plano. Se incorporaron seis mejoras de fiabilidad en delegate_task, todas comprobadas en el código fuente de la herramienta de delegación correspondiente a esta etiqueta. (1) De forma predeterminada, un lote en segundo plano devuelve UNA sola finalización; al activar delegation.independent_completions, la llamada se divide en unidades de finalización: las tareas que comparten un valor group se agrupan y notifican juntas, mientras que cada tarea sin grupo se notifica por separado al terminar. El comportamiento predeterminado es deliberado: el código señala que una avalancha de finalizaciones por tarea «fragmentaba a los orquestadores que no estaban preparados para ello». (2) Los procesos en segundo plano de un hijo se terminan al desmontarlo, salvo que este los entregue al padre mediante process_manage(action="handoff"); los procesos restantes que no se hayan entregado aparecen identificados en el resultado como orphaned_processes, mientras que los procesos hijo que terminaron sin que nadie llegara a leerlos aparecen como unread_completions junto con la parte final de su salida. Según el docstring del código fuente, el criterio de diseño es que el padre «debe enterarse por el entorno de ejecución», en lugar de confiar en que un hijo afirme que hay un «watcher running». (3) delegation.fallback_providers se convierte en una superficie de configuración real: null hace que los hijos no fijados hereden la cadena del padre, [] desactiva las alternativas y un hijo fijado por proveedor, endpoint o modelo no dispone de ninguna alternativa salvo que esta configuración declare una. (4) La cadena de alternativas del hijo se resuelve mediante el normalizador canónico, de modo que las entradas con formato incorrecto se descartan en vez de impedir la creación de un proceso. (5) Un fallo en mitad de una unidad ya no hace que se pierdan los hijos terminados: cada hijo completado de una unidad con varios hijos queda registrado de forma duradera en la propia fila de la unidad y se conserva como resultado parcial al recuperarla. (6) Los subagentes nunca heredan el nivel de caché de prompts de 1 hora: un hijo delegado se reduce al nivel de 5 minutos, porque el nivel de 1h tiene un precio pensado para una persona que se ausenta, no para una ráfaga de hijos paralelos.⁴⁵
• Proveedores y modelos. Los catálogos incorporan GPT-6 Astra y Astra Pro de OpenAI con variantes de nivel de velocidad -fast/-flex («precio 2x, nivel prioritario» / «precio 0,5x, nivel flexible») en los catálogos de Nous Portal y OpenRouter. En la ruta de OAuth de ChatGPT/Codex, Astra está restringido según la cuenta (solo el descubrimiento activo dentro del ámbito de la cuenta puede anunciarlo) e incorpora una variante opcional -900k en el selector, que eleva la ventana anunciada de 272K a aproximadamente 900K, verificados en vivo; el sufijo nunca se envía por la red. También se añaden anthropic/claude-fable-5.1, google/gemini-3.7-flash y gemini-3.8-flash, qwen/qwen3.8-max-0902 y qwen3.8-flash, además de la familia Muse Spark 1.3 de Meta (contexto de 1M, incluidas las variantes para colaboradores) y un plugin de proveedor de generación de imágenes muse-image de Meta. Tavily se incorpora como backend de búsqueda y extracción web (TAVILY_API_KEY; puede funcionar sin clave cuando Tavily se selecciona mediante hermes tools). Un entorno de ejecución administrado de llama.cpp convierte los modelos locales en una opción de primera clase (binarios oficiales, un único llama-server supervisado e instalación con un clic desde la aplicación de escritorio), mientras que los proveedores de procesos externos ajenos al repositorio disponen de su propia rama de resolución. En términos operativos, los catálogos remotos del selector ahora se actualizan cada 20 minutos (model_catalog.ttl_minutes, valor predeterminado de 20; la clave heredada ttl_hours solo se respeta cuando el usuario la ha configurado expresamente).⁴⁶
• Aplicación de escritorio: anota la página y controla la sesión. El navegador integrado incorpora un modo de comentarios: haz clic en Annotate y después en cualquier elemento de la página activa (o arrastra para dibujar un recuadro) y escribe una nota; los comentarios guardados permanecen como marcadores numerados y nunca envían un turno por sí solos. Cuando termines, «Add N comments» transfiere el lote al editor con una captura recortada por cada marcador; además, cada comentario sobre un elemento incluye su selector CSS, su marcado y los estilos calculados pertinentes para el diseño, de modo que el agente encuentre el elemento en tu código fuente en vez de deducirlo a partir de una imagen (las contraseñas, los valores ocultos y los atributos con aspecto de clave se ocultan antes de que el marcado salga de la página). Los lotes más grandes llegan agrupados por región de la página, por lo que una veintena de comentarios se convierte en un puñado de tareas que suelen afectar archivos separados, lo que permite distribuirlas de forma segura entre trabajadores paralelos. A su alrededor se incorporan controles de sesión estructurados y controles de automatización de sesiones, la creación de sesiones mediante arrastre, una vista de importación de sesiones para transcripciones de otros agentes de programación, display.resume_last_session (valor predeterminado true: un inicio en frío vuelve a abrir el último chat o página), un aviso de consentimiento en la primera apertura que ofrece browser.use_real_profile cuando se abre un panel Browser con esa opción desactivada, un catálogo integrado de skills opcionales en Capabilities -> Skills con instalación mediante un clic y una nueva configuración regional en ruso para la interfaz de escritorio (los 17 catálogos de configuraciones regionales de la CLI no cambiaron).⁴⁷

La actualización no cambia: utiliza hermes update desde una instalación existente o el instalador de shell para una instalación nueva. Corresponde a v0.22.0 presentar el registro seleccionado de este periodo; los grupos anteriores recogen lo que cambia en esta etiqueta.⁴¹

Novedades de v0.21.0 (The Pantheon Release)

Hermes Agent v0.21.0 (etiqueta v2026.8.31, 31 de agosto de 2026) es la versión actual con nuevas funciones y constituye el registro depurado al que se había remitido todo el ciclo acumulativo de v0.20.x: «Esta versión reúne todo lo incluido en las etiquetas de parches de infraestructura v0.20.1-v0.20.6; esos periodos están documentados aquí en su totalidad». El planteamiento continúa lo iniciado en Herald: «v0.20.0 convirtió a Hermes en el heraldo: habló y llevó la palabra a otros agentes. En v0.21.0, los dioses se reúnen». La línea de estadísticas, textualmente: «Desde v0.20.0: ~5.800 commits · ~2.475 PRs fusionadas · ~5.680 archivos modificados · ~869.000 inserciones · ~135.000 eliminaciones · ~2.100 incidencias cerradas · más de 760 colaboradores».³⁵

La versión está organizada por áreas funcionales, al igual que este resumen. Cuando una función modifica una sección permanente de esta guía, se incluye el enlace correspondiente.

• Bot Mode: tus agentes se convierten en una sociedad integrada. Bot Mode deja de ser el plugin hermes-bots incluido en el periodo de v0.20.3 y pasa a formar parte de la aplicación de escritorio, activado de forma predeterminada. Cada profile de agente recibe un nombre, un rostro de avatar determinista con controles para aleatorizarlo o bloquearlo y un lugar en una lista compartida; puedes crear chats grupales al estilo de Discord donde varios bots y tú conversan en una misma sala, mencionar con @ a cualquier bot desde el editor y asignar nombres e imágenes a las salas. El subcatálogo incluye tarjetas de mensajes entre agentes con atribución, avisos de entrega para el remitente, hidratación con renderizado anticipado para reactivaciones instantáneas, un panel de rutinas y una reconstrucción basada en el sistema de diseño de la aplicación. En palabras de la propia versión: «Antes, “multi-agent” significaba infraestructura; ahora parece una aplicación de chat llena de compañeros de trabajo».³⁵
• hermes peer: mensajes directos entre bots de tus agentes. Cualquier agente de Hermes puede enviar mensajes a cualquier otro mediante su identificador, entre distintos profiles y gateways, desde la CLI o desde una conversación: pídele a tu bot de investigación que entregue sus hallazgos a tu bot de programación y lee la respuesta donde ya te encuentras. «Las respuestas llegan al Bot Chat canónico de cada agente, por lo que las conversaciones entre agentes son duraderas e inspeccionables, no simples mensajes que se envían y se olvidan». El comando hermes peer (agregar, enumerar o eliminar peers, y dm) aparece en la tabla de comandos de nivel superior.³⁵
• Trabajos cron que recuerdan. Los trabajos programados dejan de tener memoria de pez: los agentes cron cargan y actualizan la memoria persistente como cualquier otro agente; continuity=true incorpora la salida de cada ejecución en la siguiente para que un monitor pueda evitar duplicar lo que ya informó; cada trabajo recibe un bloc de notas duradero; los trabajos en modo monitor omiten por completo la LLM cuando nada ha cambiado; el esfuerzo de razonamiento puede fijarse para cada trabajo; y la salida de cron puede llegar al Bot Chat canónico de un bot, donde este realmente responde. La sección Tareas programadas (Cron) ahora documenta el funcionamiento de las etiquetas at en cada caso.³⁵³⁷
• Orquestación de subagentes en tiempo real. delegate_task incorpora acciones de control: enumerar los agentes secundarios en ejecución, redirigir uno sobre la marcha mediante una corrección de rumbo o detenerlo antes de tiempo y conservar el resultado parcial. Las salidas de los agentes secundarios pueden validarse con un esquema JSON, los resultados muestran el costo de cada delegación y los valores predeterminados aumentan a 250 iteraciones por subagente y 10 agentes secundarios simultáneos (los límites unificados que sustituyeron a max_async_children en v0.19.0).³⁵³⁸
• El centro de control de MCP. Los servidores MCP y el catálogo se combinan en una sola página de escritorio con una función de importación mediante arrastrar y soltar que permite «pegar cualquier cosa», comprobaciones de estado en segundo plano que te avisan para que vuelvas a autenticarte antes de que falle una llamada a una herramienta, una capa de costos y uso de toda la flota (estimaciones de tokens del esquema y uso de 30 días por servidor) y enlaces profundos hermes:// que instalan un servidor MCP con confirmación explícita. Consulta Integración con MCP.³⁵
• Una oleada de potencia para la CLI. Ctrl+P abre una paleta de comandos con búsqueda aproximada (también accesible mediante /palette), el selector de /model filtra a medida que escribes, /status muestra el modo de razonamiento, las aprobaciones pendientes y el uso del contexto, y la barra de estado puede mostrar en tiempo real el porcentaje de aciertos de caché, la latencia y los tokens por segundo, con controles independientes para cada campo. También se incorporan una detención de emergencia global, la opción de fijar o desfijar sesiones, textos de ejemplo rotativos en el editor y mascotas para la terminal. Una observación sobre el nombre: la versión presenta un comprobador de aprobaciones de prueba como hermes approval-check; en esa etiqueta, la interfaz disponible es hermes approvals test, ya que no existe ningún subcomando approval-check.³⁵⁴⁰
• El agente controla el navegador de la aplicación de escritorio. El navegador integrado deja de ser una ventana que el agente solo puede observar: Hermes puede navegar, hacer clic y leer directamente, mientras que las páginas pueden abrirse por separado en el navegador del sistema con menús contextuales completos para los enlaces.³⁵
• Seis proveedores nuevos y una oleada de novedades en el catálogo de modelos. Meta Model API (Muse Spark), CommandCode, Tencent TokenPlan, Nebius Token Factory, Ramp Router y Actual Computer. Tres de ellos (Meta AI, CommandCode y Actual Computer) se incorporaron durante periodos acumulativos anteriores y ya figuraban en la matriz de proveedores; ahora la matriz añade Tencent TokenPlan, Nebius Token Factory y Ramp Router, además del nuevo SKU Alibaba Token Plan de la documentación. Los catálogos incorporan GLM-5.3-Flash, qwen3.8-max/flash, Gemini 3.7 Flash, MiniMax M3 free, Nemotron 3.5 Lightning y Muse Spark 1.2. También llegan dos cambios estructurales: model_overrides en config.yaml te permite modificar la ventana de contexto o los precios de cualquier modelo sin esperar una nueva versión, y ahora los proveedores pueden distribuirse como paquetes instalados mediante pip que se detectan a través de puntos de entrada; además, un registro unificado de protecciones de selección muestra advertencias en todas las interfaces de selección cuando un modelo se entrena con tus datos.³⁵³⁶
• Refuerzo general de la seguridad. Las escrituras en archivos protegidos de instrucciones del agente (AGENTS.md, skills y almacenes de memoria) ahora siempre requieren aprobación, de modo que un agente afectado por una inyección de instrucciones no pueda reescribir discretamente sus propias órdenes permanentes; una revisión exhaustiva de la censura de datos corrige filtraciones de secretos en errores de terminal, lecturas de .env, checkpoints y registros de ACP; el sistema de aprobación aprende a reconocer los comandos destructivos de Windows; los permisos concedidos en macOS sobreviven a las actualizaciones gracias a una identidad estable de firma de TCC (hermes desktop --setup-tcc-identity); y la entrada de Blender en el catálogo de MCP, junto con su skill, se eliminó tras un incidente de seguridad en el proyecto de origen. Consulta Refuerzo de la seguridad para conocer los detalles correspondientes a esta etiqueta.³⁵³⁹
• Maduración del gateway. Slack incorpora tarjetas dinámicas nativas (respuestas transmitidas en tiempo real, además de tarjetas opcionales de planes y tareas) y la supresión de vistas previas de enlaces salientes; Telegram añade un selector integrado que permite buscar cualquier comando y skill mediante @botname, eludiendo el límite del menú de comandos de Telegram; el canal de retransmisión madura (inicialización nativa de plugins, operaciones de tarjetas dinámicas con transmisión de borradores, segmentación por intervalos de sesión y restauración de la conversión de notas de voz a texto); un socket de control del gateway permite que los consumidores de la flota consulten el gateway y que los procesos de actualización lo pausen de forma ordenada en lugar de finalizar todo el árbol de procesos; además, el recolector de turnos captura las pilas de los procesos de trabajo atascados cuando se activa el mecanismo de vigilancia.³⁵
• Una oleada de skills. Ocho skills de productividad recuperados (document-to-action-items, meeting-action-items, email-inbox-triage, github-issue-to-pr, weekly-review-planning, competitor-news-monitor, product-price-monitor y social-media-content-calendar), clientes API derivados de HAR («observa un sitio web una vez y luego llama directamente a su API oculta sin navegador»), publish-site, session-librarian, blocked-page-recovery, merge-reconciler, plan-interrogation y un analizador consultivo de SKILL.md durante la creación.³⁵

Revertido durante este periodo (no se incluye): tanto el modo Model Council (/council) como el context engine DCP se incorporaron y luego se revirtieron; el servidor de gateway exclusivo para WS (#94245) se fusionó y después se revirtió (#96118), por lo que FastAPI permanece en la ruta de arranque de la aplicación de escritorio. No obstante, la reproducción de eventos con marcas de secuencia (#94219) y la reconexión sin pérdidas de la aplicación de escritorio mediante WebSocket sí se incluyeron. Electron volvió a la versión 40.10.2. Si la cobertura de la comunidad sobre los periodos de v0.20.x mencionó alguna de estas funciones, no forman parte de esta versión.³⁵

El proceso de actualización no cambia: hermes update desde una instalación existente o el instalador de shell para instalaciones nuevas. La subsección acumulativa que aparece más adelante, bajo la versión Herald, sigue siendo el registro por etiqueta de lo que se incorporó en cada periodo.³⁵

Novedades de v0.20.0 (la versión Herald)

Hermes Agent v0.20.0 (etiqueta v2026.8.3, 3 de agosto de 2026) fue la versión con nuevas funciones antes de que v0.21.0 consolidara todo el conjunto; v0.20.1 (13 de agosto) y v0.20.2 (16 de agosto) son etiquetas de estabilización creadas sobre esta versión, y v0.20.3 (etiqueta v2026.8.16.2, publicada el 17 de agosto), v0.20.4 (etiqueta v2026.8.18, 18 de agosto), v0.20.5 (etiqueta v2026.8.19, publicada el 21 de agosto) y v0.20.6 (etiqueta v2026.8.27, 27 de agosto) mantienen en marcha la serie de consolidaciones, cada una con su propio conjunto de funciones — consulta la subsección siguiente. El periodo transcurrido desde v0.19.0 abarca aproximadamente 3.650 commits, 1.400 PR fusionadas y 1.200 incidencias cerradas, con la participación de más de 650 colaboradores.⁵⁵

Tres cambios contradicen las instrucciones que ofrecían las versiones anteriores de esta guía. Léelos antes que cualquier otra cosa:

• Ahora se requiere Node 26. El instalador fija NODE_VERSION="26" y rechaza entornos de ejecución anteriores con el mensaje “Node.js … is too old (Hermes requires Node >=26).” Tanto los instaladores como heal y upgrade hacen cumplir este requisito. Ten en cuenta que la página de instalación del sitio de documentación todavía indica Node v22; el script del instalador y las notas de la versión son las fuentes más recientes y autorizadas.⁵⁵
• pip y Homebrew se retiraron, no están simplemente obsoletos. Textualmente: “brew + pip/PyPI wheel channels retired (shell installer / Docker / Nix are the supported channels).” Si todavía utilizas una instalación mediante pip o brew, esa vía ya no recibe nuevas versiones.⁵⁵
• El límite predeterminado de iteraciones para llamadas a herramientas aumentó de 90 a 500. Las ejecuciones autónomas prolongadas dejaron de toparse con un límite artificial, y todos los umbrales de presión presupuestaria que aparecen más adelante se calculan respecto del nuevo límite máximo. read_file también utiliza ahora 2.000 líneas de forma predeterminada, en lugar de 500.⁵⁵

El resto de la versión:

• Voz conversacional. TTS por streaming con interrupción de voz y palabras de activación procesadas en el dispositivo.⁵⁵
• A2A v1.0. Un plugin de protocolo entre agentes que resuelve la solicitud de larga data de la incidencia #514.⁵⁵
• Webhooks salientes firmados. Antes, hermes webhook solo admitía comunicaciones entrantes; v0.20.0 agrega webhooks salientes del ciclo de vida, firmados con HMAC, para eventos de sesión, turno y herramientas.⁵⁵
• Citas fundamentadas. Un nuevo skill con un modo de verificación de datos.⁵⁵
• Oleada de mejoras para usuarios avanzados de CLI. !command ejecuta un comando de shell al instante sin consumir un turno del modelo; /init analiza el proyecto y crea o actualiza un AGENTS.md; /diff muestra los cambios preparados, todos los cambios o los de la sesión desde cualquier interfaz; /context desglosa qué está ocupando la ventana de contexto; /focus ofrece una vista con menos información y permite recuperar las líneas ocultas; Ctrl+S guarda temporalmente una instrucción escrita a medias. hermes import-agent migra una configuración de Claude Code o Codex CLI con un solo comando.⁵⁵
• Nuevas funciones para gestionar secretos. Una fuente de secretos basada en un comando auxiliar que se combina con cualquier bóveda, rotación de tokens mediante un solo comando con errores de inicio que indican cómo proceder, una caché cifrada opcional de emergencia para Bitwarden, claves inyectadas desde la bóveda con alcance limitado al directorio principal de cada profile y compatibilidad uniforme con SecretRef ${env:VAR} entre config.yaml y la configuración de MCP. El modelo de autenticación de tres vías descrito más adelante no cambia.⁵⁵
• Inicio en caliente más rápido. El arranque en frío de hermes -w pasó de unos 14 s a 1,8 s.⁵⁵
• La aplicación de escritorio se convirtió en una plataforma. Artefactos con tarjetas versionadas y vista previa interactiva en un entorno aislado, un Plugin SDK con Kanban como plugin fundacional para escritorio, un atajo de teclado global para ingreso rápido, varias ventanas de la interfaz gráfica, modo de backend remoto SSH e inicio de sesión nativo conforme a RFC 8252.⁵⁵

Las consolidaciones v0.20.3, v0.20.4, v0.20.5 y v0.20.6 (17-27 de agosto)

Después de v0.20.0, el proyecto adoptó una cadencia de consolidaciones etiquetadas de alta frecuencia, y estas fueron más que simples versiones de estabilización. Las cuatro pospusieron sus notas seleccionadas de la misma manera: cada una indicó que “full curated release notes for this window will ship with v0.21.0”; v0.21.0 ya las ha publicado: Novedades de v0.21.0, más arriba, es el registro seleccionado de todo este periodo (la versión confirma que estos intervalos “are fully documented here”). Los bloques siguientes se conservan como el registro contemporáneo de cada etiqueta: permiten identificar qué incorporó cada una, algo que las notas seleccionadas presentan de forma conjunta.^54233035

v0.20.3 (aprox. 250 commits y 125 PR desde v0.20.2):

• Migración a MCP 2.x SDK, con compatibilidad con el protocolo sin estado del 28 de julio de 2026. Hermes adopta la generación actual de MCP SDK y se comunica mediante la revisión sin estado del protocolo.⁵⁴
• Bot Mode se distribuye como un plugin incluido (hermes-bots) que incorpora el protocolo principal para compañeros de equipo.⁵⁴
• Un plugin del proveedor CommandCode se incorpora al catálogo de proveedores.⁵⁴
• Contratos de entorno de ejecución de Cua Driver 0.20 para el uso de computadoras, además del refuerzo del control del entorno de ejecución de Python en subprocesos (aislamiento de PYTHONHOME/PYTHONPATH).⁵⁴
• Confiabilidad: autorreparación del programador de cron (recuperación de EMFILE, conciliación de asignaciones obsoletas y reactivación de tareas bloqueadas), correcciones para evitar la pérdida de datos durante la transferencia de sesiones, autorreparación de la conexión de la aplicación de escritorio con el gateway remoto y una oleada de incorporaciones del ecosistema (análisis de seguridad al instalar plugins, /worktree, preservación de ediciones manuales con /rollback y lectura de archivos UTF-16).⁵⁴

v0.20.4 (aprox. 146 commits y 74 PR desde v0.20.3):

• La superficie de vidrio de la aplicación de escritorio: mejoras de vidrio mate y translucidez, con un selector de escarcha y preselección de macOS.⁵⁴
• Una barra lateral con pestañas SESSIONS|BOTS, con opciones para ocultar o mostrar cada bot, además de correcciones para los chats grupales de Bot Mode (turnos prolongados de los miembros, representación de Markdown y enrutamiento entre computadoras).⁵⁴
• Análisis preventivo de nivel 1 con NVIDIA SkillEvaluator al instalar skills: las verificaciones de licencia y seguridad se ejecutan cuando instalas un skill.⁵⁴
• Refuerzo del envío de contenido multimedia mediante cron (tiempo de espera configurable, archivos adjuntos en ejecuciones manuales y visualización de activaciones omitidas), correcciones de SessionDB relacionadas con el hilo del bucle de eventos y la contención, mensajes transparentes de hermes update para ramas en espera y notificaciones nativas del sistema operativo para Kanban.⁵⁴

v0.20.5 (aprox. 746 commits y 323 PR desde v0.20.4):

• La capa web sin claves: la búsqueda web funciona en instalaciones nuevas sin ninguna clave de API, mediante una rotación gratuita de 5 proveedores con conmutación por error en anillo.²³
• Una oleada de mejoras para CLI: selector difuso de /model, una paleta de comandos con Ctrl+P y un /status más completo.²³
• Bot Mode madura: hilos en salas grupales, resúmenes de conversaciones contraíbles, avatares con rostros abstractos y archivos adjuntos PDF o de otros tipos mediante arrastrar y soltar.²³
• Herramientas para flotas y worktrees: comprobantes de hermes update, hermes update --plan (las notas de la versión lo denominan “fleet --plan verification”; la opción pertenece a hermes update, no a un comando fleet, y la ayuda de su analizador indica que permite “Show the update plan and exit without changing anything”) y hermes worktree list/prune.²³²⁷
• Las tareas cron incorporan memoria persistente y nivel de razonamiento por tarea, además de medidas de disciplina de ejecución y protecciones contra bloqueos del entorno de ejecución impulsadas por los hallazgos de evaluación de Composio, aclaración mediante varias preguntas, el proveedor sin autenticación y sin opencode, y mejoras de rendimiento para la aplicación de escritorio (hidratación de Bot Mode priorizando el primer renderizado y React Compiler en ambos renderizadores).²³

v0.20.6 (etiqueta v2026.8.27, 27 de agosto; aprox. 1.313 commits y 525 PR desde v0.20.5):

La versión se describe explícitamente como una “Patch release. This tag rolls up the ~525 PRs merged since v0.20.5 into a stable tagged release for downstream consumers”, y su propia descripción cifra el periodo en unos 1.313 commits distribuidos en aproximadamente 1.557 archivos (+177.113 / −21.682), con cerca de 525 PR fusionadas.³⁰ Estos son los elementos principales de esa descripción:

• Navegación con perfiles reales sujeta a consentimiento: la navegación local puede utilizar tu profile predeterminado de Chromium, con un flujo de cierre sujeto a aprobación en Windows.³⁰
• El navegador de la aplicación de escritorio obtiene su propia ventana del sistema operativo, además de un motor administrado de actualizaciones remotas SSH y una barra de profiles de flota.³⁰
• Ampliación del catálogo remoto de MCP: más de 50 servidores alojados por proveedores y verificados en funcionamiento, incluidos Cloudflare, Grafana Cloud, Better Stack y Railway.³⁰
• Cifrado opcional mediante el llavero del sistema operativo para los secretos almacenados: se eliminan las solicitudes del Llavero de macOS en cada inicio.³⁰
• Nuevos modelos en los selectores: GLM-5.3-Flash, MiniMax M3 gratuito y MiniMax H3 Max para video.³⁰
• Almacenamiento en caché de resultados con TTL para web_search/web_extract y tool_search con varias consultas y derivación morfológica.³⁰
• La compresión de cola reducida es ahora la opción predeterminada: la sección Compresión de contexto que aparece más adelante documenta la configuración correspondiente a esta etiqueta.³⁰³¹
• Los backends de terminal ahora son modulares: consulta Backends de terminal.³⁰³²
• Transparencia del actualizador y las flotas: los actualizadores pausan los gateways a través del socket de control, en lugar de finalizar sus árboles de procesos, y las instalaciones administradas mediante imágenes o paquetes rechazan las actualizaciones locales que no sean seguras.³⁰
• Confirmaciones duraderas de incidentes de cron con errores más claros ante diferencias de código, controles para las vistas previas de enlaces en Slack e identidades compartidas de contenedores Docker.³⁰

El proceso de actualización no cambia: hermes update desde una instalación existente o el instalador de shell para instalaciones nuevas.⁵⁴²³³⁰

Novedades de v0.19.0 (la versión Quicksilver)

Hermes Agent v0.19.0 (etiqueta v2026.7.20, 20 de julio de 2026) recibe su nombre por la velocidad propia del dios mensajero: el eje central de esta versión es la capacidad de respuesta pura, con una reducción de aproximadamente un 80 % en el tiempo hasta el primer token del primer turno en todas las plataformas. Alrededor de ese eje se incorporan la gestión de facturación desde la terminal, fuentes de secretos provenientes de gestores de contraseñas, aprobaciones inteligentes de forma predeterminada, subagentes observables y una entrega de respuestas resistente a fallos. El periodo transcurrido desde v0.18.0 es el más activo del proyecto hasta ahora: aproximadamente 2.245 commits, 1.065 PR fusionados, 3.300 incidencias cerradas y más de 450 colaboradores de la comunidad.⁵⁶

• Aproximadamente un 80 % menos de tiempo hasta el primer token, en todas partes. El intervalo entre el envío en frío y el despacho bajó de unos 4,3 s a 0,9 s tanto en la CLI como en el gateway, la TUI, la aplicación de escritorio y cron: la detección de capacidades de Discord salió de la ruta crítica, la comprobación de Ollama se omite para proveedores que se sabe que no son Ollama y se eliminaron las operaciones bloqueantes de la inicialización del agente. La latencia percibida también recibió atención específica: ahora, los modelos de razonamiento transmiten sus pensamientos en vivo de forma predeterminada (display.show_reasoning está activado), y el cuadro de respuesta se actualiza por token en lugar de por línea.⁵⁶
• Oleada de mejoras de renderizado en la aplicación de escritorio y la TUI. La aplicación de escritorio recibió una optimización de velocidad de unos 20 PR: una reducción de 14× en el uso de CPU del separador de Markdown transmitido mediante análisis léxico incremental por bloques, diferencias virtualizadas en el panel de revisión, cambios ágiles entre sesiones con transcripciones extensas y el fin de los nuevos renderizados de la barra lateral y las filas de herramientas por cada token. Ahora, la TUI renderiza el Markdown transmitido de forma incremental por bloques.⁵⁶
• Las instalaciones mediante pip y Homebrew están obsoletas. Ambas vías se marcaron como instalaciones «heredadas no compatibles», con una eliminación prevista. Esa eliminación ya se produjo en v0.20.0: se retiraron los canales de brew y los paquetes wheel de pip/PyPI, por lo que el instalador de shell, Docker y Nix quedan como los canales compatibles.⁵⁶⁵⁵
• Los secretos pueden provenir de tu gestor de contraseñas. Una nueva interfaz conectable SecretSource obtiene secretos de Bitwarden y 1Password (referencias op://) durante la carga, permite usar varios vaults simultáneamente y ofrece precedencia determinista, advertencias de conflictos y procedencia por variable; las claves de API ya no tienen que residir en un archivo .env de texto sin formato. Los futuros proveedores de vaults podrán añadirse como plugins.⁵⁶
• Las aprobaciones inteligentes ahora son la opción predeterminada. Cuando Hermes quiere ejecutar un comando marcado, un revisor LLM independiente lo evalúa en lugar de pedirte confirmación para cada uno, y cada veredicto solo abarca ese comando exacto. Las reglas de denegación definidas por el usuario bloquean los comandos coincidentes incluso en modo YOLO, /deny <reason> transmite el motivo de tu rechazo para que el agente corrija el rumbo, y la acción de aprobación pre_tool_call del plugin (reincorporada con claves de reglas) deriva una llamada a una herramienta a una aprobación humana.⁵⁶
• Facturación desde la terminal: /subscription y /topup. Administra tu plan de Nous Portal sin salir de la terminal: consulta tu plan y la asignación restante, revisa exactamente cuánto cuesta una mejora o cuándo entra en vigor un cambio a un plan inferior, y aplícalo con opción de deshacer. La aplicación de escritorio incorpora una pestaña equivalente de configuración de facturación.⁵⁶
• Observa cómo trabajan los subagentes y no vuelvas a perder una respuesta terminada. Los despachos de delegate_task devuelven archivos de transcripción en vivo que puedes consultar con tail -f desde el momento en que se inician los subagentes: cada llamada a una herramienta, cada resultado y cada respuesta transmitida quedan en un registro legible para humanos por cada hijo. Las finalizaciones de delegaciones en segundo plano persisten entre reinicios, mientras que las respuestas finales del gateway se registran en un libro mayor de obligaciones de entrega dentro de state.db y vuelven a entregarse en el siguiente arranque si el gateway falla durante el envío. La opción de configuración max_async_children está obsoleta en favor de límites unificados de concurrencia para las delegaciones.⁵⁶
• Un gateway, muchos profiles. Un único gateway multiplexado que comparte un token de bot puede dirigir guilds, canales o hilos específicos a distintos profiles, cada uno con configuración, skills, memoria y secretos completamente aislados, mediante una anulación GATEWAY_MULTIPLEX_PROFILES. El índice de enrutamiento se trasladó a state.db; ahora sessions.json es una réplica heredada opcional.⁵⁶
• Oleada de proveedores y modelos. Fireworks AI obtiene compatibilidad de primer nivel (estimación de costos y segundo puesto en el selector de proveedores), junto con DeepInfra y Upstage Solar. Los catálogos añaden GPT-5.6 (Sol/Terra/Luna + Pro, integrado de extremo a extremo), grok-4.5 (GA), kimi-k3 (kimi-k2.x retirado) y Claude Sonnet 5 con integración completa. Una opción enabled: false por proveedor y la configuración excluded_providers eliminan los proveedores que no se usan de los selectores y la resolución de /model.⁵⁶
• El esfuerzo de razonamiento se convierte en un control ajustable. Los nuevos niveles de esfuerzo max y ultra llegan a todas las interfaces, con anulaciones por modelo en la configuración, esfuerzo por slot en los ajustes predefinidos de MoA (los asesores razonan a fondo y el sintetizador se mantiene rápido), esfuerzo por tarea para los modelos auxiliares y un /reasoning limitado a la sesión en la CLI.⁵⁶
• Superficie de CLI y MCP. hermes sessions export genera formatos Markdown, Quarto, HTML, solo prompts y trazas de Hugging Face, con una depuración opcional mediante --redact; /model --once permite anular el modelo durante un turno; las invocaciones de slash-skills pueden encadenarse (/skill-a /skill-b do XYZ); --safe-mode facilita la solución de problemas; hermes config get/unset completan la gestión de la configuración; hermes serve se convierte en un verdadero backend sin interfaz gráfica; y las herramientas de MCP adoptan la convención de nombres mcp__server__tool.⁵⁶

Si actualizas desde v0.18.x, hay dos cambios que merecen atención antes que cualquier otro: las instalaciones mediante pip o Homebrew ahora muestran una advertencia que las identifica como heredadas y no compatibles (migra al instalador de una sola línea), y max_async_children está obsoleto en favor de los límites unificados de concurrencia para las delegaciones. Todo lo demás es adicional: los principales motivos para actualizar son la reducción de aproximadamente un 80 % en la latencia del primer turno, las aprobaciones inteligentes y el libro mayor de entregas, que protege las respuestas terminadas frente a fallos.

Novedades de v0.18.0 (la versión Judgment)

Hermes Agent v0.18.0 (etiqueta v2026.7.1, 1 de julio de 2026) recibe su nombre por el juicio: el agente verifica su propio trabajo en lugar de afirmar que tuvo éxito, y ofrece un razonamiento conjunto que realmente puedes inspeccionar. También resuelve todo el trabajo pendiente P0/P1: aproximadamente 692 elementos de máxima prioridad solucionados en doce días.²²

• Mixture-of-Agents como modelo de primer nivel. Ahora puedes seleccionar MoA como cualquier otro modelo en todas las interfaces, y el razonamiento conjunto es visible: la salida completa de cada modelo de referencia se muestra en su propio bloque etiquetado, con transmisión de respuestas en vivo. Puedes observar cómo razona el conjunto en lugar de recibir una respuesta combinada opaca.²²
• Contratos de finalización para /goal. Antes de informar que un objetivo está completo, el agente verifica su propio trabajo ejecutando las comprobaciones del proyecto en lugar de limitarse a afirmar que tuvo éxito: aplica el juicio sobre sí mismo.²²
• /learn: convierte cualquier descripción en una skill. Convierte un flujo de trabajo en una skill reutilizable con solo describirlo; las skills generadas cumplen automáticamente las convenciones de CONTRIBUTING.md del repositorio.²²
• Cronología de /journey. Un historial visual de la memoria y las skills a lo largo del tiempo, con funciones de edición, además de un gráfico de memoria en la aplicación de escritorio.²²
• Expansión de subagentes en segundo plano. Delega varias tareas que se ejecutan de manera simultánea sin bloquear la conversación: el único subagente en segundo plano de v0.17.0 se convierte en toda una flota.²²
• Projects en la aplicación de escritorio. Projects de programación de primer nivel, con un modelo organizativo basado en proyecto/repositorio/lane.²²
• Gateway con reducción a cero. Los gateways pueden quedar inactivos cuando no se usan y coordinar el vaciado de tareas para facilitar implementaciones sin interrupciones, algo relevante para cualquiera que ejecute Hermes como un servicio siempre activo.²²
• Compatibilidad con Google Vertex AI. Acceso a Gemini mediante cuentas de servicio de GCP, con renovación automática de tokens de OAuth2, que se incorpora al catálogo de proveedores.²²
• Comando de edición /prompt. Abre $EDITOR para redactar prompts de varias líneas sin tener que lidiar con la línea de entrada.²²

Si actualizas desde v0.17.x, nada de esto rompe la CLI. Los principales motivos para actualizar son los contratos de finalización (objetivos que se verifican a sí mismos), MoA como función de primer nivel con conjuntos inspeccionables y /learn para capturar skills.

Novedades de v0.17.0 (la versión Reach)

Hermes Agent v0.17.0 (etiqueta v2026.6.19, 19 de junio de 2026) recibe su nombre por el alcance que ahora tiene el agente: nuevos canales de mensajería, nuevos proveedores de modelos y un control más profundo del escritorio y del panel. Amplía v0.16.x; la interfaz de CLI no cambia.²¹

• Nuevos canales de mensajería. iMessage ahora funciona sin un repetidor Mac mediante Photon Spectrum (OAuth con código de dispositivo, hermes photon login); la API de WhatsApp Business Cloud es un adaptador oficial de Meta que elimina la necesidad de un proceso puente; SimpleX incorpora grupos, archivos adjuntos nativos, agrupación de texto y aceptación automática; y Raft se suma como plugin de plataforma incluido, con un diseño de canal de activación cuya privacidad está garantizada por contrato.²¹
• Nuevos modelos y proveedores. El catálogo incorpora z-ai/glm-5.2 (contexto de 1 millón), anthropic/claude-fable-5, laguna-m.1, nemotron-3-ultra y grok-composer-2.5-fast (el modelo de Cursor mediante OAuth de xAI, con un contexto de 200.000). El modelo predeterminado de xAI cambió a grok-build-0.1, y los modelos adaptativos de Anthropic ahora siguen el contrato moderno de razonamiento (nunca envían un campo reasoning).²¹
• Escritorio y panel. La aplicación de escritorio incorpora subagentes en segundo plano con «ventanas de seguimiento» que transmiten en vivo la actividad delegada (delegate_task(background=true)), un selector de modelos en Composer, atajos de teclado reasignables, notificaciones nativas del sistema operativo, borradores de Composer por hilo, temas de VS Code Marketplace e interfaz en japonés y chino tradicional. El panel incorpora un generador completo de profiles (modelos, skills y MCPs sin editar config.yaml), un selector global de profile, un Skills Hub rediseñado con análisis de seguridad, Automation Blueprints (plantillas parametrizadas disponibles mediante formulario, comando slash, conversación y documentación) y un inicio de sesión seguro que devuelve 401 detrás de la barrera de OAuth.²¹
• Skills y herramientas. image_generate ahora puede editar y transformar una imagen de origen, no solo crear una desde cero, con todos los proveedores de imágenes compatibles; la herramienta memory incorpora un arreglo operations para agregar, reemplazar o eliminar elementos en lotes atómicos mediante una sola llamada; una nueva skill simplify-code ejecuta en paralelo una revisión y limpieza a cargo de tres agentes, sujeta a un nivel de riesgo basado en el principio de la cerca de Chesterton; y el booleano write_approval reemplaza al write_mode de tres estados.²¹
• Arquitectura. Los subagentes en segundo plano devuelven de inmediato un identificador y reintroducen su resultado como un nuevo turno; un controlador de obtención de datos de MCP permite solicitar confirmación durante una llamada a una herramienta, y las herramientas de MCP que se conectan tarde quedan disponibles entre turnos (sin invalidar la caché); cron se convierte en un CronScheduler conectable con Chronos como proveedor de cron administrado; y un nuevo ámbito Managed (/etc/hermes) permite que un administrador fije una configuración que los usuarios no pueden modificar, además de un repetidor entre gateways para topologías con varios gateways.²¹
• Nuevos comandos. /version, /billing (facturación interactiva desde la terminal), hermes photon login (autenticación de iMessage) y hermes curator run --consolidate; ahora debes activar expresamente la consolidación, por lo que la curación rutinaria en segundo plano no consume tokens.²¹
• Seguridad. v0.17.0 corrige una evasión de la lista de denegación para escapes del shell, bloquea las operaciones cuando faltan módulos de aprobación o adaptadores del gateway con políticas propias, depura el entorno de los subprocesos que ejecutan scripts de tareas cron, oculta secretos en los volcados de depuración de solicitudes, examina las configuraciones stdio de MCP en busca de patrones de exfiltración y actualiza urllib3 y PyJWT para corregir CVE.²¹

Si actualizas desde v0.16.x, nada de esto rompe la CLI; son nuevos canales, modelos e interfaces alrededor del mismo agente. iMessage sin repetidor, los adaptadores oficiales de WhatsApp y el ámbito Managed para administradores son los principales motivos para actualizar.

Novedades de v0.16.0 (la versión Surface)

Hermes Agent v0.16.0 (etiqueta v2026.6.5, 5 de junio de 2026) recibe su nombre por las nuevas interfaces que ofrece para el agente centrado en la CLI. La gran novedad es que Hermes ya no está limitado a la terminal.²⁰

• Aplicación de escritorio nativa. Hermes Desktop es una nueva aplicación Electron para macOS, Linux y Windows, con instalación mediante un clic y actualización automática desde la propia aplicación. Incluye una ventana de chat con transmisión en tiempo real, archivos mediante arrastrar y soltar, pegado de imágenes desde el portapapeles, una paleta Cmd+K, una lista de sesiones con funciones de archivo y búsqueda, y un selector de modelos en la barra de estado. Puede conectarse a un gateway remoto de Hermes mediante una WebSocket segura y autenticarse con OAuth o nombre de usuario y contraseña; admite hosts remotos específicos para cada profile y sesiones simultáneas en varios profiles, vinculadas mediante referencias @session entre profiles. La interfaz de escritorio también incluye una traducción completa al chino simplificado (简体中文) mediante una capa de i18n tipada (display.language; el inglés sigue siendo el idioma predeterminado).²⁰
• Panel de administración en el navegador. El panel web local evolucionó de una vista de estado a un panel de administración completo: un catálogo de MCP con controles para activar o desactivar elementos, gestión de credenciales, creación de webhooks y hooks, configuración de memoria, controles del gateway y una página de sistema que comprueba las actualizaciones antes de instalarlas y permite crear un Debug Share con un clic. Una nueva página de canales permite configurar desde el navegador todas las plataformas de mensajería del gateway (Telegram, Discord, Slack y las demás). Ahora la autenticación es conectable: inicio de sesión con nombre de usuario y contraseña, un proveedor OIDC genérico autoalojado, hermes dashboard register para un cliente de OAuth autoalojado y rotación de sesiones mediante tokens de actualización.²⁰
• Nuevos comandos de CLI y comandos slash. /undo [N] retrocede los últimos N turnos del usuario con contenido precargado y eliminación lógica, y funciona en la CLI, la TUI y las plataformas de mensajería. Se incorpora una interfaz predeterminada configurable (cli o tui) con la opción --cli para sobrescribirla; la TUI recibe un comando /model unificado y una vista superpuesta de sesiones. hermes portal es un alias legible del flujo de incorporación de Nous Portal, con nuevas rutas de primer uso Quick Setup y Full Setup, además de dos comandos de diagnóstico: hermes prompt-size y hermes sessions optimize.²⁰
• Nuevos modelos y proveedores. El selector incorpora deepseek-v4-flash, MiniMax-M3 (contexto de 1 millón y proveedores nativos de MiniMax), qwen3.7-plus (Nous + OpenRouter) y gemini-3.5-flash (OAuth de Gemini + clave de API). Un proveedor propio de OAuth para xAI Grok se suma al iniciador de escritorio; el selector de modelos ahora admite búsqueda aproximada en todas las interfaces, los proveedores con varios endpoints se agrupan en una sola fila y la actualización del catálogo pasa de diaria a cada hora.²⁰ (Desde entonces, v0.21.1 volvió a cambiar la frecuencia: los catálogos remotos del selector se actualizan cada 20 minutos, model_catalog.ttl_minutes.⁴⁶)
• Skills más ligeras y divulgación progresiva. El conjunto predeterminado de skills eliminó las redundantes y obsoletas (Spotify pasó a ser un plugin nativo, Linear se trasladó a hermes mcp install linear y se eliminaron varias entradas desactualizadas), convirtió más skills en opcionales e incorporó en el frontmatter un filtro de relevancia environments: (kanban/docker/s6) que mantiene las skills específicas de cada contexto fuera del índice hasta que se solicitan. NVIDIA/skills ahora es una fuente confiable predeterminada de Skills Hub junto con OpenAI, Anthropic y HuggingFace. Las herramientas de MCP y de plugins incorporan divulgación progresiva (acotada), y se corrigió un error de MCP que informaba falsamente que la autenticación mediante OAuth había sido exitosa cuando no se obtenía ningún token.²⁰
• Seguridad. v0.16.0 fija una versión corregida de Starlette (≥1.0.1) para CVE-2026-48710 (BadHost), traslada fuera del bucle de eventos las comprobaciones de URL contra SSRF en las rutas asíncronas, elimina del entorno de los subprocesos el token de portador para inferencias de Bedrock, agrega bws_cache.json a la protección de lectura para la seguridad de archivos, incorpora docker restart/stop/kill a la lista de patrones peligrosos y depura los caracteres Unicode invisibles del contenido verificado de las skills. La versión corrigió 2 problemas P0 y 62 P1, de los cuales 16 estaban etiquetados como problemas de seguridad.²⁰

Si actualizas desde v0.15.x, nada de esto supone un cambio incompatible en la propia CLI; son interfaces y proveedores adicionales alrededor del mismo agente. La aplicación de escritorio y el panel de administración son los motivos para actualizar si quieres ofrecer Hermes a usuarios que no trabajan desde la terminal o administrar un gateway remoto desde el navegador.

Novedades de v0.14.0 (la versión Foundation)

v0.14.0 no gira tanto en torno a una única función destacada, sino a reducir las dificultades de configuración y ampliar los entornos donde puede ejecutarse Hermes.¹⁹ Los principales cambios operativos son:

• La instalación y el inicio son más ligeros. pip install hermes-agent funciona desde PyPI, los adaptadores pesados se instalan bajo demanda la primera vez que se usan y la ruta de inicio aplaza suficiente trabajo como para reducir el arranque en frío unos 19 segundos. (Desde entonces, v0.19.0 marcó como obsoletas las instalaciones mediante pip; consulta Instalación.)
• Las suscripciones pueden convertirse en endpoints locales de API. hermes proxy convierte proveedores respaldados por OAuth, como Claude Pro, ChatGPT Pro y SuperGrok, en un endpoint local compatible con OpenAI para herramientas como Codex, Aider, Cline y Continue.
• Se amplía el alcance del gateway. LINE y SimpleX Chat se incorporan al gateway (la tabla comparativa de plataformas de la documentación enumera 28 plataformas en la etiqueta v2026.8.31; la sección Gateway de mensajería explica qué incluye esa cifra), Microsoft Teams queda integrado de extremo a extremo, la recuperación del historial de Discord está activada de forma predeterminada y las solicitudes clarify de Telegram y Discord ahora usan botones nativos.
• Mejora la verificación al escribir. Después de realizar modificaciones, Hermes puede mostrar resúmenes por turno de los cambios en archivos y diagnósticos semánticos del servidor de lenguaje antes del siguiente turno, lo que lo acerca a un trabajo agéntico basado en evidencia.
• Se amplían las herramientas de escritorio y contenido multimedia. computer_use funciona mediante cua-driver para proveedores distintos de Anthropic, video_generate se unifica detrás de backends conectables y vision_analyze envía los píxeles sin procesar a modelos que realmente pueden ver.

Instalación

El instalador de una sola línea es el método de instalación compatible. Se encarga de Python, uv, Node.js, ripgrep, ffmpeg, la clonación del repositorio, el entorno virtual y el comando global hermes.⁷

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

Las instalaciones mediante pip y Homebrew están obsoletas desde la versión v0.19.0. El paquete de PyPI que se introdujo en la versión v0.14.0 (pip install hermes-agent) y la fórmula de Homebrew ahora están marcados como instalaciones «heredadas no compatibles»: cada interfaz muestra una advertencia (sin bloquear la ejecución) cuando Hermes detecta alguna de ellas, y está previsto dejar de publicar en PyPI y Homebrew. Si realizaste la instalación mediante pip o brew, migra al instalador anterior.⁵⁶

Funciona en Linux, macOS, WSL2 y Android/Termux (el instalador detecta Termux automáticamente y cambia a un paquete para Android que ha sido probado).⁷ Windows nativo ahora es una plataforma de nivel 1, en lugar de la versión beta inicial incluida en v0.14.0; instálalo con iex (irm https://hermes-agent.nousresearch.com/install.ps1). La documentación señala explícitamente una salvedad: en macOS, solo se admite Apple Silicon; las Mac con Intel no son compatibles.⁵⁵ Históricamente, v0.14.0 incorporó compatibilidad con Windows nativo en una versión beta inicial mediante un instalador de PowerShell, pero WSL2 sigue siendo la recomendación más segura para entornos de producción hasta que la opción para Windows alcance mayor madurez.¹⁹

Cuando termine:

source ~/.bashrc    # or ~/.zshrc
hermes              # Start chatting

El único requisito previo es git. El instalador aprovisiona automáticamente Python 3.11 mediante uv (sin necesidad de sudo), Node.js 26 (para la automatización del navegador y el puente de WhatsApp), ripgrep y ffmpeg. Desde v0.20.0, Node 26 es el requisito mínimo obligatorio: el instalador rechaza cualquier versión anterior e instala en su lugar una versión de Node administrada por Hermes.⁵⁵⁷

Verifica la instalación

hermes --version    # Check version (global flag; there is no `version` subcommand)
hermes doctor       # Diagnose config/dependency issues
hermes status       # Show current configuration + auth state
hermes dump         # Copy-pasteable setup summary for debugging

hermes doctor te indica exactamente qué falta y cómo solucionarlo.⁷ hermes dump es el comando de diagnóstico que debes pegar en un reporte de GitHub o en un hilo de Discord cuando solicites ayuda; genera un resumen en texto sin formato de toda tu configuración, con los datos secretos ocultos.⁸

Instalación manual

Si necesitas control total —una versión personalizada de Python, componentes adicionales específicos o integración con Nix/NixOS—, el proceso manual está documentado paso a paso en la guía de instalación oficial.⁷ Estos son los principales componentes adicionales opcionales que puedes combinar con uv pip install -e ".[<extras>]":

El comando de instalación para Termux es diferente: usa pip con un archivo de restricciones, no uv pip:

python -m pip install -e ".[termux]" -c constraints-termux.txt

Esto se debe a que .[all] en Android instala faster-whisper mediante el componente adicional voice, que depende de paquetes wheel de ctranslate2 que no se publican para Android.⁷

Autenticación y proveedores

En la etiqueta v2026.9.7, hermes_cli/models_catalog_static.py contiene 39 entradas estáticas de CANONICAL_PROVIDERS en la línea 311 (la reorganización de septiembre de 2026 trasladó la lista fuera de hermes_cli/models.py; las entradas no cambiaron e incluyen tencent-tokenplan de v0.21.0) y amplía automáticamente esa lista desde plugins/model-providers/ (39 directorios incluidos; nueve de ellos —actual, alibaba-coding-plan, commandcode, deepinfra, meta-ai, nebius-token-factory, opencode-free, router, upstage— no tienen una entrada estática y se incorporan mediante la ampliación automática porque utilizan el tipo de autenticación predeterminado api_key). La página de documentación sobre proveedores incluye tablas con 45 proveedores en la nube y por suscripción, además de una fila para endpoints personalizados, y explica por separado los servidores locales y autoalojados (Ollama, vLLM, SGLang, llama.cpp, LM Studio, LiteLLM, ClawRouter y cualquier endpoint compatible con OpenAI).²⁶ En la etiqueta v2026.9.24, la lista estática todavía contiene 39 entradas, pero plugins/model-providers/ contiene 38 directorios: el proveedor sin clave opencode-free se eliminó el 18 de septiembre porque el nivel gratuito de OpenCode ahora rechaza el tráfico anónimo procedente de clientes distintos al suyo.⁵³ A esto se suman los endpoints personalizados y tres rutas de autenticación diferentes. A continuación se presenta toda la superficie de autenticación, organizada por ruta para que puedas encontrar la que corresponda a lo que tienes.

Las tres rutas de autenticación

Todos los proveedores de Hermes siguen uno de estos tres patrones de autenticación:

Ruta 1 — Clave de API en .env. Coloca tu clave en ~/.hermes/.env y Hermes la leerá al iniciarse. La utilizan OpenRouter, AI Gateway, z.ai/GLM, Kimi/Moonshot, MiniMax (y MiniMax China), Alibaba Cloud/DashScope, Kilo Code, OpenCode Zen, OpenCode Go, DeepSeek, Hugging Face, Google/Gemini y la mayoría de los proveedores externos.² Desde v0.19.0, la clave ya no tiene que almacenarse en un archivo de texto sin formato: una interfaz conectable SecretSource puede obtener secretos de Bitwarden o 1Password (referencias op://) durante la carga, con varios vaults habilitados simultáneamente, precedencia determinista, advertencias de conflictos y procedencia por variable; .env permanece como alternativa. (Esto es distinto del token de arranque de Bitwarden Secrets Manager de v0.15.0, que consolidaba las claves de los proveedores detrás de un solo token; SecretSource sustituye el propio archivo de texto sin formato y permite incorporar futuros proveedores de vaults como plugins).⁵⁶

Ruta 2 — OAuth mediante hermes model o hermes auth. Inicia un flujo de código de dispositivo, abre un navegador, almacena las credenciales en ~/.hermes/auth.json (y puede importar credenciales existentes de herramientas como Claude Code o Codex CLI). La utilizan Nous Portal, OpenAI Codex (cuenta de ChatGPT), GitHub Copilot y Anthropic (Claude Pro/Max).²

Ruta 3 — Endpoint personalizado en config.yaml. Para cualquier API compatible con OpenAI: Ollama, vLLM, SGLang, llama.cpp, LM Studio, proxy LiteLLM, Together AI, Groq, Azure OpenAI o tu propio servidor autoalojado. Se configura una vez mediante hermes model → Custom endpoint y luego se guarda en config.yaml.²

Matriz completa de proveedores

Esta matriz abarca los proveedores incluidos en las tablas de la página de documentación, con el flujo de configuración exacto para cada uno; el selector de la etiqueta enumera más proveedores que la documentación (consulta el recuento anterior) y cualquier opción compatible con OpenAI puede configurarse mediante la fila de endpoint personalizado.²²⁶

Anthropic: tres métodos de autenticación

Anthropic tiene su propia sección porque Hermes admite tres vías distintas para acceder a Claude, y es importante elegir la adecuada. Según la documentación original:²

# Method 1: API key (pay-per-token)
export ANTHROPIC_API_KEY=***
hermes chat --provider anthropic --model claude-sonnet-4-6

# Method 2: OAuth through hermes model (preferred)
# Uses Claude Code's credential store when available
hermes model

# Method 3: Manual setup-token (fallback/legacy)
export ANTHROPIC_TOKEN=***
hermes chat --provider anthropic

# Auto-detect Claude Code credentials
hermes chat --provider anthropic   # reads Claude Code files automatically

Cuando eliges Anthropic OAuth mediante hermes model, Hermes da prioridad al almacén de credenciales propio de Claude Code en lugar de copiar el token en ~/.hermes/.env. Así, las credenciales actualizables de Claude conservan esa capacidad.² Si ya utilizas Claude Code en la misma computadora, esta es la opción más sencilla.

Para fijar Anthropic de forma permanente en config.yaml:

model:
  provider: "anthropic"
  default: "claude-sonnet-4-6"

--provider claude y --provider claude-code también funcionan como formas abreviadas de --provider anthropic.²

GitHub Copilot: dos modos

Copilot admite dos modos: la API directa de Copilot (recomendado) y Copilot ACP (que ejecuta la CLI local de Copilot como subproceso).²

# Direct Copilot API
hermes chat --provider copilot --model gpt-5.4

# Copilot ACP (requires the Copilot CLI in PATH + an existing copilot login)
hermes chat --provider copilot-acp --model copilot-acp

Según la documentación original, la autenticación se comprueba en este orden:² 1. Variable de entorno COPILOT_GITHUB_TOKEN 2. Variable de entorno GH_TOKEN 3. Variable de entorno GITHUB_TOKEN 4. Alternativa mediante la CLI gh auth token 5. Inicio de sesión con código de dispositivo de OAuth mediante hermes model

El tipo de token importa. La API de Copilot no admite tokens clásicos de acceso personal (ghp_*). Los tipos compatibles son los tokens de OAuth (gho_*), los PAT con permisos específicos (github_pat_* con el permiso Copilot Requests) y los tokens de aplicaciones de GitHub (ghu_*). Si gh auth token devuelve un token ghp_*, utiliza hermes model para autenticarte mediante OAuth.²

Proveedores chinos de AI (compatibilidad de primera clase)

Hermes ofrece compatibilidad integrada con z.ai/GLM, Kimi/Moonshot, MiniMax (endpoints globales y de China) y Alibaba Cloud mediante ID de proveedor específicos.²

# z.ai / ZhipuAI GLM
hermes chat --provider zai --model glm-5                 # Requires: GLM_API_KEY

# Kimi / Moonshot AI
hermes chat --provider kimi-coding --model kimi-for-coding   # Requires: KIMI_API_KEY

# MiniMax (global)
hermes chat --provider minimax --model MiniMax-M2.7          # Requires: MINIMAX_API_KEY

# MiniMax (China)
hermes chat --provider minimax-cn --model MiniMax-M2.7       # Requires: MINIMAX_CN_API_KEY

# Alibaba Cloud / DashScope (Qwen)
hermes chat --provider alibaba --model qwen3.5-plus          # Requires: DASHSCOPE_API_KEY

Las URL base pueden sustituirse mediante las variables de entorno GLM_BASE_URL, KIMI_BASE_URL, MINIMAX_BASE_URL, MINIMAX_CN_BASE_URL o DASHSCOPE_BASE_URL.²

Z.AI detecta automáticamente el endpoint. Al utilizar el proveedor z.ai/GLM, Hermes prueba varios endpoints (globales, de China y variantes para programación) hasta encontrar uno que acepte tu clave API. El endpoint funcional se almacena en caché automáticamente, por lo que la mayoría de los usuarios no necesita configurar GLM_BASE_URL.²

xAI (Grok) activa automáticamente el almacenamiento en caché de prompts. Cuando la URL base contiene x.ai, Hermes envía el encabezado x-grok-conv-id con cada solicitud para dirigirla al mismo servidor durante una sesión de conversación, reutilizando los prompts del sistema y el historial almacenados en caché.² Es automático y no requiere configuración.

El comando hermes auth

hermes auth es el comando para administrar pools de credenciales y credenciales de OAuth.⁶

hermes auth                              # Interactive wizard
hermes auth list                         # Show all credential pools
hermes auth list openrouter              # Show one provider's pool
hermes auth add openrouter --api-key sk-or-v1-xxx
hermes auth add anthropic --type oauth
hermes auth remove openrouter 2          # Remove by index
hermes auth reset openrouter             # Clear cooldowns

Los pools de credenciales permiten rotar varias claves API o tokens de OAuth para un mismo proveedor. Esto resulta útil para distribuir los límites de solicitudes entre varias claves sin modificar el código.⁶ Los comandos heredados hermes login y hermes logout se eliminaron; utiliza hermes auth en su lugar.⁶

Endpoints personalizados y autoalojados

Hermes funciona con cualquier endpoint API compatible con OpenAI. Si un servidor implementa /v1/chat/completions, puedes hacer que Hermes lo utilice.²

Configuración interactiva (recomendada):

hermes model
# Select "Custom endpoint (self-hosted / VLLM / etc.)"
# Enter: API base URL, API key, Model name

Configuración manual de config.yaml:

model:
  default: your-model-name
  provider: custom
  base_url: http://localhost:8000/v1
  api_key: your-key-or-leave-empty-for-local

Ambos métodos guardan los datos en config.yaml, la única fuente de verdad para el modelo principal, el proveedor y la URL base.² Las variables de entorno heredadas OPENAI_BASE_URL y LLM_MODEL ya no se leen para configurar el modelo principal; utiliza hermes model o edita config.yaml directamente.² (OPENAI_BASE_URL + OPENAI_API_KEY aún se aceptan como alternativa para la ruta auxiliar provider: "main", así que no las elimines sin comprobar si las utilizas allí.)⁴

Cambio de endpoints personalizados durante una sesión:

/model custom:qwen-2.5             # Custom endpoint with explicit model
/model custom                      # Auto-detect the model from the endpoint
/model custom:local:qwen-2.5       # Named custom provider "local"
/model custom:work:llama3          # Named custom provider "work"
/model openrouter:claude-sonnet-4  # Back to a cloud provider

/model custom (sin especificar el nombre del modelo) consulta /v1/models de tu endpoint API y selecciona automáticamente el modelo si solo hay uno cargado; esto resulta útil para servidores locales que ejecutan un único modelo.²

Servidores LLM locales (plantillas de configuración)

La documentación oficial incluye guías completas de configuración para Ollama, vLLM, SGLang, llama.cpp y LM Studio. Estos son los comandos clave que realmente ejecutarás. Cada uno está diseñado para generar un endpoint funcional al que Hermes pueda conectarse.²

Ollama — la opción local más sencilla, sin configuración:

ollama pull qwen2.5-coder:32b
OLLAMA_CONTEXT_LENGTH=32768 ollama serve   # Raise from 4k default
hermes model   # Custom endpoint → http://localhost:11434/v1 → qwen2.5-coder:32b

Problema crítico de Ollama: Ollama utiliza de forma predeterminada longitudes de contexto muy bajas (4.096 tokens con menos de 24 GB de VRAM). Debes aumentarla mediante OLLAMA_CONTEXT_LENGTH o un Modelfile; la API compatible con OpenAI no acepta la longitud del contexto desde el cliente, por lo que Hermes no puede establecerla por ti.² Para usarlo como agente, configúrala en al menos 16k–32k.

vLLM — servicio de inferencia GPU de alto rendimiento:

pip install vllm
vllm serve meta-llama/Llama-3.1-70B-Instruct \
  --port 8000 \
  --max-model-len 65536 \
  --tensor-parallel-size 2 \
  --enable-auto-tool-choice \
  --tool-call-parser hermes

Las llamadas a herramientas requieren --enable-auto-tool-choice y --tool-call-parser <name>. Analizadores compatibles: hermes (Qwen 2.5, Hermes 2/3), llama3_json, mistral, deepseek_v3, deepseek_v31, xlam, pythonic. Sin estas opciones, las llamadas a herramientas se devolverán como texto sin formato.²

SGLang — servicio rápido con RadixAttention para reutilizar la caché KV:

pip install "sglang[all]"
python -m sglang.launch_server \
  --model meta-llama/Llama-3.1-70B-Instruct \
  --port 30000 \
  --context-length 65536 \
  --tp 2 \
  --tool-call-parser qwen

Problema de SGLang: El valor predeterminado de max_tokens es 128. Configura --default-max-tokens en el servidor o model.max_tokens en config.yaml si las respuestas quedan truncadas.²

llama.cpp / llama-server — CPU y Metal de Apple Silicon:

./build/bin/llama-server \
  --jinja -fa \
  -c 32768 \
  -ngl 99 \
  -m models/qwen2.5-coder-32b-instruct-Q4_K_M.gguf \
  --port 8080 --host 0.0.0.0

--jinja es obligatorio para llamar a herramientas. Sin esta opción, llama-server ignora por completo el parámetro tools y el modelo intenta llamar a las herramientas escribiendo JSON en el texto de su respuesta, algo que Hermes no puede interpretar como llamadas reales a herramientas.²

LM Studio — aplicación de escritorio con interfaz gráfica:

Inicia el servidor desde la aplicación LM Studio (pestaña Developer → Start Server) o mediante CLI: lms server start (se inicia en el puerto 1234) y lms load qwen2.5-coder --context-length 32768.² Luego, configura hermes model para que apunte a http://localhost:1234/v1.

Problema crítico de LM Studio: LM Studio obtiene la longitud del contexto de los metadatos del modelo, pero muchos modelos GGUF indican valores predeterminados de 2048 o 4096. Establece siempre la longitud del contexto de forma explícita en la configuración del modelo de LM Studio: haz clic en el ícono de engranaje junto al selector de modelos, establece “Context Length” en al menos 16384 (preferiblemente 32768) y vuelve a cargar el modelo.²

Proveedores personalizados con nombre

Si trabajas con varios endpoints personalizados (por ejemplo, un servidor local de desarrollo y un servidor GPU remoto), defínelos como proveedores personalizados con nombre en config.yaml:²

custom_providers:
  - name: local
    base_url: http://localhost:8080/v1
    # api_key omitted — Hermes uses "no-key-required" for keyless local servers
  - name: work
    base_url: https://gpu-server.internal.corp/v1
    api_key: corp-api-key
    api_mode: chat_completions      # optional, auto-detected from URL
  - name: anthropic-proxy
    base_url: https://proxy.example.com/anthropic
    api_key: proxy-key
    api_mode: anthropic_messages    # for Anthropic-compatible proxies

Luego, alterna entre ellos durante la sesión con la sintaxis triple:

/model custom:local:qwen-2.5
/model custom:work:llama3-70b
/model custom:anthropic-proxy:claude-sonnet-4

También puedes seleccionar proveedores personalizados con nombre desde el menú interactivo de hermes model.²

Arquitectura de proveedores conectables (v0.13.0+)

La versión v0.13.0 incorpora una ABC ProviderProfile, además de un directorio plugins/model-providers/, para que los proveedores de inferencia externos puedan integrarse sin modificar el núcleo.¹⁸ Si un proveedor admite un modo de API compatible con OpenAI, Anthropic o Codex, puedes implementar una subclase de ProviderProfile que declare la ruta de autenticación, la URL base, el catálogo de modelos y los encabezados de caché; Hermes la resuelve mediante la misma ruta runtime_provider.py que utilizan los proveedores integrados. Este es el cambio arquitectónico detrás de la ampliación de proveedores en la versión v0.13.0: en lugar de editar el código del núcleo para agregar un proveedor, distribuyes un plugin.

Proxy local compatible con OpenAI (v0.14.0+)

hermes proxy expone un endpoint local compatible con OpenAI, respaldado por el proveedor OAuth en el que Hermes ya inició sesión: Claude Pro, ChatGPT Pro, SuperGrok u otro proveedor compatible configurado.¹⁹ Esto significa que las herramientas que esperan una API al estilo de OpenAI, como Codex CLI, Aider, Cline, Continue o scripts personalizados, pueden reutilizar la autenticación de Hermes respaldada por tu suscripción sin necesidad de una clave API independiente. Trata el proxy como infraestructura local de desarrollo: vincúlalo de forma deliberada, no lo expongas ampliamente y ten presentes las condiciones específicas del proveedor.

Detección de la longitud del contexto

Según la documentación oficial, hay dos parámetros que se confunden constantemente:²

• context_length — la ventana de contexto total (el presupuesto combinado de tokens de entrada y salida; por ejemplo, 1.000.000 para Claude Opus 4.7 o 200.000 para Sonnet 4.6). Hermes la utiliza para decidir cuándo comprimir el historial.
• model.max_tokens — el límite de salida (la cantidad máxima de tokens que el modelo puede generar en una sola respuesta). No está relacionado con la longitud del historial.

Establece context_length cuando la detección automática calcule incorrectamente el tamaño de la ventana:

model:
  default: "qwen3.5:9b"
  base_url: "http://localhost:8080/v1"
  context_length: 131072      # tokens

Hermes utiliza una cadena de resolución con varias fuentes para detectar las ventanas de contexto: valor definido en la configuración → configuración por modelo del proveedor personalizado → caché persistente → endpoint /models → Anthropic /v1/models → API de OpenRouter → Nous Portal → models.dev (registro mantenido por la comunidad con más de 3.800 modelos) → valores predeterminados de respaldo (128K).² El sistema tiene en cuenta al proveedor, por lo que un mismo modelo puede tener límites de contexto diferentes según quién lo sirva (por ejemplo, claude-opus-4.6 admite 1M directamente en Anthropic, pero 128K en GitHub Copilot).²

Enrutamiento inteligente de modelos: rotación de proveedores y respaldo

Hermes no te limita a un solo modelo de un único proveedor. El enrutamiento inteligente de modelos es el conjunto de mecanismos que decide qué proveedor y modelo atienden realmente una solicitud determinada: los grupos de credenciales distribuyen la carga entre las claves, un respaldo configurado toma el control cuando falla el proveedor principal y las ranuras auxiliares que aparecen a continuación enrutan las tareas secundarias a modelos más económicos de forma independiente de tu modelo principal.²⁶ Configura estas tres opciones en conjunto: marcan la diferencia entre un agente que se detiene al alcanzar un límite de solicitudes y otro que continúa trabajando.

Grupos de credenciales. Cuando tengas varias claves API para el mismo proveedor, configura una estrategia de rotación mediante hermes auth. Así puedes distribuir los límites de solicitudes entre varias claves.⁶

Modelo de respaldo. Configura un provider:model de respaldo al que Hermes cambie automáticamente cuando falle tu modelo principal (por límites de solicitudes, errores del servidor o fallas de autenticación):²

fallback_model:
  provider: openrouter            # required
  model: anthropic/claude-sonnet-4  # required
  # base_url: http://localhost:8000/v1    # optional, for custom endpoints
  # api_key_env: MY_CUSTOM_KEY           # optional, env var name

El respaldo cambia el modelo y el proveedor durante la sesión sin perder la conversación. Se activa como máximo una vez por sesión.² Proveedores compatibles con el respaldo: openrouter, nous, openai-codex, copilot, copilot-acp, anthropic, huggingface, zai, kimi-coding, minimax, minimax-cn, deepseek, ai-gateway, opencode-zen, opencode-go, kilocode, alibaba, custom.²

Modelos auxiliares

Hermes utiliza modelos “auxiliares” para tareas secundarias: análisis de imágenes (visión), clasificación para aprobar comandos peligrosos, compresión del contexto, generación de títulos de sesiones, inserción de etiquetas de audio TTS, correspondencia de skills, despacho de herramientas MCP y la familia de especificadores/descomponedores de Kanban.⁴³⁴ De forma predeterminada (auxiliary.*.provider: "auto"), todas las tareas auxiliares se ejecutan en tu modelo de chat principal, es decir, el mismo proveedor/modelo que seleccionaste en hermes model. La documentación deja claro que esto sustituyó la antigua detección automática de proveedores económicos: “Las versiones anteriores asignaban a los usuarios de agregadores (OpenRouter, Nous Portal) una opción predeterminada económica del lado del proveedor. Eso resultaba inesperado… Ahora, auto usa el modelo principal para todos y las configuraciones específicas de cada tarea en config.yaml siguen teniendo prioridad”.³⁴ No necesitas configurar nada para comenzar; la contrapartida es el costo: en modelos de razonamiento costosos, las tareas auxiliares generan un gasto considerable, por lo que conviene asignar cada tarea a modelos rápidos y económicos cuando esto sea importante. Dos tareas auxiliares anteriores ya no usan ningún LLM: la extracción web (“web_extract y las capturas del navegador truncan el contenido extenso de forma determinista y almacenan el texto completo para paginarlo con read_file; no interviene ningún LLM”) y la búsqueda de sesiones (la herramienta con formato único devuelve directamente el contenido de la base de datos). Sus antiguos bloques auxiliary.web_extract.* y auxiliary.session_search.* ya no aparecen en la configuración predeterminada —los valores que queden en un config.yaml existente son “restos inofensivos que se ignoran”— y el espacio flush_memories tampoco figura en la configuración predeterminada de esa etiqueta.³⁴

Puedes configurar qué modelo y proveedor usa cada tarea auxiliar. Todos los espacios auxiliares utilizan las mismas opciones: provider, model, base_url (además de api_key, timeout, extra_body y un valor de reasoning_effort específico para cada tarea).⁴³⁴

auxiliary:
  vision:                          # vision_analyze + browser screenshots
    provider: "auto"               # "auto" (= main model), "openrouter", "nous", "main", etc.
    model: ""                      # e.g. "openai/gpt-4o", "google/gemini-2.5-flash"
    base_url: ""                   # Custom OpenAI-compatible endpoint
    api_key: ""                    # Falls back to OPENAI_API_KEY
    timeout: 120
    download_timeout: 30
  approval:                        # dangerous-command approval classifier
    provider: "auto"
    model: ""
    timeout: 30
  compression:                     # summarizer -- legacy compression.summary_* keys migrate here (config v17)
    provider: "auto"
    model: ""
    base_url: ""
    timeout: 120
  title_generation:                # auto-generated session titles after the first exchange
    enabled: true                  # set false to disable auto-titles
    provider: "auto"
    model: ""
    language: ""                   # empty follows the conversation; e.g. "English" pins titles to one language
  tts_audio_tags:    { provider: "auto", model: "" }  # Gemini 3.1 TTS hidden audio-tag insertion
  skills_hub:        { provider: "auto", model: "" }  # skill matching and search
  mcp:               { provider: "auto", model: "" }  # MCP tool dispatch
  triage_specifier:  { provider: "auto", model: "" }  # hermes kanban specify: rough one-liner into a concrete spec, promoted to todo
  kanban_decomposer: { provider: "auto", model: "" }  # hermes kanban decompose: triage task into a graph of child tasks routed to specialist profiles
  profile_describer: { provider: "auto", model: "" }  # hermes profile describe --auto: 1-2 sentence profile descriptions

Otros espacios especializados siguen la misma estructura: goal_judge (determina si se cumplió el contrato de /goal), curator (la bifurcación que revisa el uso de skills), background_review (la bifurcación de mejora automática posterior al turno), review (el subagente revisor de /review), moa_reference y moa_aggregator (Mixture-of-Agents), memory_query_rewrite y monitor. Además, no necesitas editar YAML manualmente: ejecuta hermes model y selecciona “Configure auxiliary models” para acceder a un selector interactivo por tarea.³⁴

La opción de proveedor "main" significa “usar el mismo proveedor que usa mi agente principal” y es válida únicamente dentro de auxiliary:, compression: y las entradas principales de respaldo (fallback_providers: o la opción heredada fallback_model:). No es válida para la configuración de nivel superior model.provider. Si usas un endpoint personalizado compatible con OpenAI como modelo principal, establece provider: custom en la sección model:.⁴

Por qué esto importa: dado que auto ya utiliza tu modelo principal, desapareció el antiguo problema de “configurar OpenRouter o dejar que las tareas auxiliares se degraden silenciosamente”; ahora, el costo es el factor que debes sopesar. Si tu modelo principal es un costoso modelo de razonamiento, dirige las tareas secundarias más conversacionales a uno económico y rápido:

auxiliary:
  vision:
    provider: "openrouter"
    model: "google/gemini-2.5-flash"
  compression:
    provider: "openrouter"
    model: "google/gemini-2.5-flash"

Sistema de configuración

Hermes tiene un sistema de configuración por capas. Comprender el orden de prioridad es esencial porque las capas superiores prevalecen sobre las inferiores, y una de ellas es un registro global de proveedores que no puedes ver en config.yaml.

Estructura de los archivos de configuración

Según la documentación oficial, estos son los archivos que conforman una configuración de Hermes:⁴

~/.hermes/
├── config.yaml       # All settings (model, terminal, TTS, compression, memory, toolsets, ...)
├── .env              # Secrets (API keys, bot tokens, passwords)
├── auth.json         # OAuth provider credentials (Nous Portal, Codex, Anthropic)
├── SOUL.md           # Primary agent identity (slot #1 in system prompt)
├── memories/         # Persistent memory (MEMORY.md, USER.md)
├── skills/           # Bundled + agent-created + hub-installed skills
├── cron/             # Scheduled jobs
├── sessions/         # Gateway session state
└── logs/             # agent.log, gateway.log, errors.log (secrets auto-redacted)

config.yaml frente a .env: cuando una opción está definida en ambos, config.yaml prevalece para la configuración que no contiene secretos.⁴ La regla es: - Secretos (claves de API, tokens de bots, contraseñas) → .env - Todo lo demás (modelo, backend de terminal, configuración de compresión, límites de memoria, toolsets) → config.yaml

Puedes hacer referencia a secretos desde config.yaml mediante interpolación al estilo del shell:⁴

auxiliary:
  vision:
    api_key: ${GOOGLE_API_KEY}
    base_url: ${CUSTOM_VISION_URL}
  delegation:
    api_key: ${DELEGATION_KEY}

Administración de la configuración

hermes config                # View current configuration
hermes config show           # Same as above
hermes config edit           # Open config.yaml in your editor
hermes config set KEY VAL    # Set a specific value
hermes config get KEY        # Print a single value (v0.19.0+)
hermes config unset KEY      # Remove a key so the default applies again (v0.19.0+)
hermes config path           # Print the config file path
hermes config env-path       # Print the .env file path
hermes config check          # Check for missing options (after updates)
hermes config migrate        # Interactively add missing options

Ejemplos:⁴

hermes config set model anthropic/claude-opus-4
hermes config set terminal.backend docker
hermes config set OPENROUTER_API_KEY sk-or-...   # Saves to .env

hermes config check y hermes config migrate son los comandos que debes ejecutar después de cada hermes update: detectan las opciones de configuración recién incorporadas que aún no están en tu archivo.⁶

Orden de prioridad de la configuración

Hermes carga la configuración desde varias fuentes. Cuando varias fuentes establecen el mismo valor, prevalece la que tenga mayor prioridad:⁴

1. Argumentos de CLI — hermes chat --model anthropic/claude-sonnet-4 (reemplazo para una ejecución específica)
2. Variables de entorno — se aplican al iniciar el proceso
3. config.yaml — el archivo principal de configuración
4. .env — solo para secretos
5. Valores predeterminados integrados — se aplican cuando ninguna otra fuente establece un valor

Las opciones de CLI siempre prevalecen durante esa ejecución específica. config.yaml es la fuente de verdad a largo plazo.

Localización (v0.13.0+)

La versión v0.13.0 incorporó 7 idiomas para los mensajes de CLI y gateway: chino simplificado, japonés, alemán, español, francés, ucraniano y turco.¹⁸ La versión v0.14.0 traduce todos los comandos de gateway y el panel web, incorpora 8 idiomas más y eleva el total a 16.¹⁹ En la etiqueta v2026.8.31, el árbol locales/ contiene 17 catálogos de mensajes: inglés y 16 traducciones (af, ar, de, es, fr, ga, hu, it, ja, ko, pt, ru, tr, uk, zh-hant, zh).³³ Por el momento, la documentación solo está localizada en chino simplificado. El idioma se determina a partir de las variables de entorno LC_ALL / LANG o mediante una clave locale: explícita en config.yaml. El inglés sigue siendo el idioma predeterminado y la fuente de verdad para cualquier cadena que aún no esté incluida en una traducción.

Profiles: varias instancias aisladas de Hermes

Los profiles permiten tener varias instancias aisladas de Hermes, cada una con su propia configuración, sesiones, skills, memoria y PID de gateway. Así puedes ejecutar un «Hermes del trabajo» y un «Hermes personal» en paralelo sin que ninguno tenga acceso al estado del otro.⁶

hermes profile list
hermes profile create work --clone                  # Clone from current profile
hermes profile use work                             # Set sticky default
hermes profile alias work --name h-work             # Create wrapper script
hermes profile export work -o work-backup.tar.gz
hermes profile import work-backup.tar.gz --name restored
hermes -p work chat -q "Hello from work profile"    # One-off without switching

Cada profile obtiene su propio HERMES_HOME (~/.hermes-<name>/ de forma predeterminada), por lo que varios profiles pueden ejecutar el gateway simultáneamente sin interferir entre sí.⁶³

El límite de aislamiento se aplica de manera más estricta desde la versión v0.21.2: un conjunto de correcciones solucionó filtraciones reales entre profiles en configuraciones con gateways multiplexados, donde los profiles secundarios podían heredar las listas de permitidos del profile predeterminado, enviar credenciales a su host, entregar los secretos de su bóveda a servidores MCP mediante stdio o adjuntar los archivos .env/auth.json/state.db de otro profile a entregas MEDIA: (#107609-#107630). Si multiplexas profiles, la etiqueta v0.21.2 es aquella en la que la afirmación sobre el aislamiento realmente se cumple; consulta Novedades de v0.21.2.⁴⁸

Comandos de CLI

Esta sección es la referencia práctica de los comandos de nivel superior de CLI. Para consultar la referencia oficial derivada del código, consulta la Referencia de comandos de CLI.⁶

Opciones globales

hermes [global-options] <command> [subcommand/options]

Comandos de nivel superior

hermes chat: el punto de entrada principal

hermes sin argumentos abre el chat interactivo. hermes chat es la forma explícita con opciones:⁶

hermes chat -q "Summarize the latest PRs" --oneshot # Answer and exit (without --oneshot, a TTY seeds an interactive session)
hermes chat --provider openrouter --model anthropic/claude-sonnet-4.6
hermes chat --toolsets web,terminal,skills          # Enable specific toolsets
hermes chat --quiet -q "Return only JSON"           # Programmatic mode
hermes chat --worktree -q "Review repo and open a PR"

Opciones principales:

hermes setup: asistente completo

Ejecuta el asistente de configuración completo o abre directamente una de sus secciones:⁶

hermes setup                 # Full wizard
hermes setup model           # Provider and model only
hermes setup terminal        # Terminal backend only
hermes setup gateway         # Messaging platforms only
hermes setup tools           # Tool enable/disable per platform
hermes setup agent           # Agent behavior only
hermes setup --non-interactive
hermes setup --reset         # Reset config to defaults before setup

hermes logs: consultas estructuradas de registros

hermes logs es más potente que tail -f aplicado a los archivos de registro, ya que permite filtrar simultáneamente por nivel, ID de sesión e intervalo de tiempo.⁶

hermes logs                          # Last 50 lines of agent.log
hermes logs -f                       # Follow in real time
hermes logs gateway -n 100           # Last 100 lines of gateway.log
hermes logs --level WARNING --since 1h   # Warnings from the last hour
hermes logs --session abc123         # Filter by session ID substring
hermes logs errors --since 30m -f    # Follow errors.log from 30m ago
hermes logs list                     # List all log files with sizes

Los archivos de registro se encuentran en ~/.hermes/logs/:⁶ - agent.log — toda la actividad del agente (llamadas de API, envío de tareas a herramientas, ciclo de vida de las sesiones, INFO+) - errors.log — solo advertencias y errores (un subconjunto filtrado de agent.log) - gateway.log — actividad del gateway de mensajería (conexiones con plataformas, envío de tareas, webhooks)

La rotación se realiza automáticamente mediante RotatingFileHandler de Python; busca archivos como agent.log.1, agent.log.2, etc.⁶

hermes doctor: diagnósticos

hermes doctor [--fix] es el primer comando que debes ejecutar cuando algo falla. Comprueba la validez de la configuración, la presencia de dependencias, la disponibilidad de claves de API y el estado de los servicios; además, puede intentar realizar reparaciones automáticas con --fix.⁶

Para compartir los diagnósticos con otra persona, usa hermes dump: genera un resumen compacto en texto sin formato con las claves de API ocultas, listo para pegarlo en una incidencia de GitHub o en un hilo de Discord.⁶

Comandos slash

Los comandos slash se ejecutan dentro de una sesión de chat activa (CLI o plataforma de mensajería). Se despachan desde un COMMAND_REGISTRY compartido en hermes_cli/commands.py, por lo que la mayoría funciona de manera idéntica en todas las interfaces.⁹

Control de la sesión

Configuración y modelo

El comando /model es la herramienta principal para cambiar de proveedor durante una sesión:⁹

/model                              # Show current model and options
/model claude-sonnet-4              # Switch model (auto-detect provider)
/model zai:glm-5                    # Switch provider:model
/model custom:qwen-2.5              # Use model on custom endpoint
/model custom                       # Auto-detect model from custom endpoint
/model custom:local:qwen-2.5        # Named custom provider
/model openrouter:anthropic/claude-sonnet-4   # Back to cloud

v0.19.0 agrega /model --once, una sustitución del modelo durante un solo turno que vuelve automáticamente al modelo anterior después de la respuesta.⁵⁶ Desde la serie de versiones v0.20.5, el selector de /model también admite búsqueda difusa: filtra los resultados a medida que escribes.²³³⁵

Herramientas, skills e información

Comandos slash dinámicos de los skills

Cada skill instalado se expone automáticamente como un comando slash:⁹

/gif-search funny cats
/axolotl help me fine-tune Llama 3 on my dataset
/github-pr-workflow create a PR for the auth refactor
/excalidraw       # Just the skill name loads it and lets the agent ask what you need

Desde v0.19.0, las invocaciones de skills mediante comandos slash se pueden acumular: /skill-a /skill-b do XYZ carga ambos skills en orden dentro de un solo turno, con autocompletado y texto predictivo para los nombres encadenados.⁵⁶

También puedes definir comandos rápidos en config.yaml que vinculen un nombre corto con un prompt más largo:⁹

quick_commands:
  review: "Review my latest git diff and suggest improvements"
  deploy: "Run the deployment script at scripts/deploy.sh and verify the output"
  morning: "Check my calendar, unread emails, and summarize today's priorities"

Después, escribe /review, /deploy o /morning en CLI.

Coincidencia por prefijo

Los comandos admiten coincidencias por prefijo: al escribir /h, se resuelve como /help; /mod se resuelve como /model. Cuando un prefijo es ambiguo, prevalece el primer registro según el orden del registry. Los nombres completos de los comandos y los alias registrados siempre tienen prioridad sobre las coincidencias por prefijo.⁹

Comandos específicos de las plataformas de mensajería

Algunos comandos solo funcionan en plataformas de mensajería (Telegram, Discord, Slack, WhatsApp, Signal, correo electrónico y Home Assistant):⁹

• /status — muestra información de la sesión (ya no es exclusivo de las plataformas de mensajería; consulta Control de la sesión)
• /sethome (alias /set-home) — marca el chat actual como la ubicación principal de la plataforma
• /approve [session|always] — aprueba un comando peligroso pendiente
• /deny [reason] — rechaza un comando peligroso pendiente. Desde v0.19.0, /deny <reason> transmite al agente el motivo de tu rechazo para que corrija el rumbo en lugar de volver a intentarlo a ciegas⁵⁶
• /update — actualiza Hermes Agent a la versión más reciente
• /commands [page] — explora todos los comandos y skills (con paginación)

Además, algunos son exclusivos de CLI: /skin, /tools, /toolsets, /browser, /config, /cron, /skills, /platforms, /paste, /statusbar, /plugins.⁹

Herramientas y toolsets

Hermes incluye un amplio registro de herramientas integradas que abarca búsquedas web, automatización del navegador, ejecución en terminal, edición de archivos, memoria, delegación, entrenamiento por RL, entrega de mensajes, integración con Home Assistant y mucho más.¹⁰ Las herramientas se organizan en toolsets lógicos que pueden habilitarse o deshabilitarse en cada plataforma.

Categorías de alto nivel

Entre los nombres habituales de toolsets se incluyen web, terminal, file, browser, vision, image_gen, moa, skills, tts, todo, memory, session_search, cronjob, code_execution, delegation, clarify, homeassistant y rl.¹⁰

Administración de herramientas

hermes chat --toolsets "web,terminal"       # Use specific toolsets
hermes tools                                # Interactive per-platform tool config
hermes tools --summary                      # Print enabled-tools summary

También puedes activar o desactivar herramientas durante una sesión mediante /tools disable <name> y /tools enable <name>. Esto reinicia la sesión para que el nuevo conjunto de herramientas entre en vigor.⁹

Backends de terminal

La herramienta de terminal incluye siete backends de ejecución integrados y, desde la versión v0.20.6, este conjunto puede ampliarse mediante plugins, al igual que el selector de proveedores (consulta más adelante):¹⁰²⁴

Cambia de backend con hermes config set terminal.backend <name> o en config.yaml:

terminal:
  backend: docker      # or: local, ssh, singularity, modal, daytona, vercel_sandbox
  cwd: "."             # Working directory
  timeout: 180         # Command timeout in seconds

Backends de plugins (v0.20.6+). Los proveedores externos de entornos aislados ya no necesitan incorporarse al repositorio principal: un plugin registra un TerminalEnvironmentProvider al cargarse mediante PluginContext.register_terminal_environment_provider, y el nombre registrado pasa a estar disponible en terminal.backend exactamente igual que uno integrado. Los nombres integrados están reservados: el registro rechaza cualquier proveedor cuyo nombre coincida con un backend incluido en el repositorio. Además, un backend registrado participa automáticamente en todas las superficies principales (el selector de backends de hermes setup, el estado de las comprobaciones del dashboard, las verificaciones de hermes doctor, la gestión de rutas y del directorio de trabajo actual en contenedores y la eliminación de secretos), porque el núcleo consulta el registro en cada punto de clasificación en lugar de utilizar una lista de nombres codificada de forma rígida.³²

Backend SSH (recomendado por seguridad, ya que el agente no puede modificar su propio código):¹⁰

terminal:
  backend: ssh

# In ~/.hermes/.env
TERMINAL_SSH_HOST=my-server.example.com
TERMINAL_SSH_USER=myuser
TERMINAL_SSH_KEY=~/.ssh/id_rsa

Backend Docker:

terminal:
  backend: docker
  docker_image: python:3.11-slim

Recursos de contenedores (aplicable a docker, singularity, modal y daytona):¹⁰

terminal:
  container_cpu: 1
  container_memory: 5120          # MB (default 5GB)
  container_disk: 51200           # MB (default 50GB)
  container_persistent: true      # Persist filesystem across sessions

Con container_persistent: true, los paquetes instalados, los archivos y la configuración se conservan entre sesiones.¹⁰

Todos los backends de contenedores aplican medidas de seguridad reforzadas: sistema de archivos raíz de solo lectura (Docker), eliminación de todas las capacidades de Linux excepto DAC_OVERRIDE, CHOWN y FOWNER, prohibición de elevar privilegios, límites de PID (256 procesos), aislamiento completo de espacios de nombres y espacio de trabajo persistente mediante volúmenes.¹⁰

Procesos en segundo plano

La herramienta de terminal permite ejecutar procesos en segundo plano y administrarlos de forma explícita:¹⁰

terminal(command="pytest -v tests/", background=true)
# Returns: {"session_id": "proc_abc123", "pid": 12345}

process(action="list")                            # Show all running processes
process(action="poll", session_id="proc_abc123")  # Check status
process(action="wait", session_id="proc_abc123")  # Block until done
process(action="log", session_id="proc_abc123")   # Full output
process(action="kill", session_id="proc_abc123")  # Terminate
process(action="write", session_id="proc_abc123", data="y")  # Send input

El modo PTY (pty=true) permite usar herramientas interactivas CLI como Codex y Claude Code.¹⁰

Sudo

Si un comando necesita sudo, Hermes solicita tu contraseña y la conserva en caché durante la sesión. También puedes configurar SUDO_PASSWORD en ~/.hermes/.env.¹⁰

Kanban multiagente (v0.13.0+)

v0.13.0 convierte la colaboración multiagente en una capacidad fundamental: un tablero Kanban persistente que mantiene el seguimiento de las tareas, su estado y la identidad de los trabajadores entre agentes y reinicios.¹⁸ Este tablero permite que un enjambre de trabajadores de Hermes termine realmente el trabajo en lugar de quedar paralizado por traspasos fallidos.

El tablero Kanban se combina de forma natural con /goal (el bucle Ralph con objetivo bloqueado) para gestionar el objetivo y con la herramienta delegate_task existente para definir la creación de agentes. El resultado es un patrón de enjambre en el que todos los agentes comparten una única fuente de verdad sobre qué hacer a continuación, quién está trabajando en cada tarea y qué está bloqueado.

¿Qué es un enjambre de Hermes?

Un enjambre está formado por varios trabajadores de Hermes que operan en paralelo sobre un mismo tablero Kanban compartido. No es un subsistema independiente que debas habilitar: es una posibilidad que ofrece el tablero. El tablero aporta lo único que los agentes paralelos no pueden proporcionarse por sí solos: una respuesta única y autoritativa a ¿qué debería retomar a continuación y alguien ya está trabajando en ello?

v0.15.0 convirtió este patrón en una topología compatible al incorporar una topología de enjambre para coordinar trabajadores en paralelo, la descomposición automática de un objetivo de alto nivel en subtareas, modelos alternativos por tarea, tareas programadas y administración de worktrees para que los trabajadores paralelos no entren en conflicto dentro del mismo checkout.⁵⁹

En la práctica, el proceso consiste en asignarle un objetivo al enjambre, dejar que la descomposición automática lo divida en tareas del tablero y permitir que los trabajadores las reclamen, ejecuten y devuelvan sus resultados. El límite de reintentos se define por tarea (max_retries), por lo que una subtarea frágil no consume la tolerancia de toda la ejecución. Como el tablero es persistente, el enjambre sobrevive a los reinicios: los trabajadores vuelven a conectarse y reanudan el trabajo a partir del mismo estado.

Un enjambre solo es tan bueno como su descomposición. El tablero coordina a los trabajadores, pero no convierte un objetivo mal dividido en uno bien planteado. Las tareas que compartan un estado oculto seguirán entrando en conflicto, con worktrees o sin ellos.

Sistema de skills

Las skills son documentos de conocimiento bajo demanda que el agente puede cargar cuando los necesita. Siguen un patrón de divulgación progresiva para minimizar el uso de tokens y son compatibles con el estándar abierto agentskills.io.¹¹

Todas las skills se encuentran en ~/.hermes/skills/, el directorio principal y la fuente de referencia. En una instalación nueva, las skills incluidas se copian desde el repositorio. Las instaladas desde el Hub y las creadas por el agente también se guardan aquí.¹¹

Divulgación progresiva

Level 0: skills_list()           → [{name, description, category}, ...]   (~3k tokens)
Level 1: skill_view(name)        → Full content + metadata                 (varies)
Level 2: skill_view(name, path)  → Specific reference file                 (varies)

El agente solo carga el contenido completo de una skill cuando realmente lo necesita.¹¹

Formato de SKILL.md

---
name: my-skill
description: Brief description of what this skill does
version: 1.0.0
platforms: [macos, linux]      # Optional — restrict to OS platforms
metadata:
  hermes:
    tags: [python, automation]
    category: devops
    fallback_for_toolsets: [web]     # Conditional activation
    requires_toolsets: [terminal]    # Conditional activation
    config:                          # Config.yaml settings
      - key: my.setting
        description: "What this controls"
        default: "value"
        prompt: "Prompt for setup"
---

# Skill Title

## When to Use
Trigger conditions for this skill.

## Procedure
1. Step one
2. Step two

## Pitfalls
- Known failure modes and fixes

## Verification
How to confirm it worked.

Activación condicional

Las skills pueden mostrarse u ocultarse según las herramientas disponibles. Esto resulta especialmente útil para las skills de respaldo: alternativas gratuitas o locales que solo deberían aparecer cuando una herramienta prémium no está disponible:¹¹

Ejemplo: la skill integrada duckduckgo-search utiliza fallback_for_toolsets: [web]. Cuando tienes configurada FIRECRAWL_API_KEY, el toolset web está disponible y el agente utiliza web_search; por lo tanto, la skill de DuckDuckGo permanece oculta. Sin la clave de API, la skill de DuckDuckGo aparece automáticamente como alternativa.¹¹

Skills administradas por el agente

El agente puede crear, actualizar y eliminar sus propias skills mediante la herramienta skill_manage. Esta es la memoria procedimental del agente: cuando descubre cómo realizar un flujo de trabajo complejo, guarda el procedimiento como una skill para reutilizarlo en el futuro.¹¹

Cuándo crea skills el agente:¹¹ - Después de completar correctamente una tarea compleja (5 o más llamadas a herramientas) - Cuando encontró errores o callejones sin salida y descubrió el camino correcto - Cuando el usuario corrigió su enfoque - Cuando descubrió un flujo de trabajo complejo

Acciones:¹¹

Hub de skills

Explora, busca, instala y administra skills de registros en línea:⁶¹¹

hermes skills browse                          # Browse all hub skills
hermes skills browse --source official        # Browse official optional skills
hermes skills search kubernetes               # Search all sources
hermes skills search react --source skills-sh # Search skills.sh directory
hermes skills inspect openai/skills/k8s       # Preview before installing
hermes skills install openai/skills/k8s       # Install with security scan
hermes skills install skills-sh/anthropics/skills/pdf --force
hermes skills check                           # Check for upstream updates
hermes skills update                          # Reinstall changed hub skills
hermes skills audit                           # Re-scan installed hub skills
hermes skills uninstall k8s
hermes skills publish skills/my-skill --to github --repo owner/repo
hermes skills tap add myorg/skills-repo       # Add custom GitHub source

Fuentes integradas del Hub:¹¹

Taps predeterminados de GitHub (pueden explorarse sin configuración): openai/skills, anthropics/skills, huggingface/skills, NVIDIA/skills, garrytan/gstack. La fuente claude-marketplace se eliminó en la versión 0.20.0; browse-sh la sustituyó en la lista de fuentes.¹¹⁵⁵

Análisis de seguridad

Todas las skills instaladas desde el Hub pasan por un analizador de seguridad que busca filtraciones de datos, inyección de prompts, comandos destructivos, señales de riesgos en la cadena de suministro y otras amenazas.¹¹

Niveles de confianza:¹¹

--force puede anular los bloqueos de políticas no peligrosos para las skills de la comunidad. No anula un veredicto dangerous del análisis.¹¹

Directorios externos de skills

Puedes indicarle a Hermes directorios adicionales de skills para que los examine junto con el directorio local:¹¹

skills:
  external_dirs:
    - ~/.agents/skills
    - /home/shared/team-skills
    - ${SKILLS_REPO}/skills

Las rutas admiten la expansión de ~ y la sustitución de variables de entorno mediante ${VAR}. Los directorios externos son de solo lectura: cuando el agente crea o edita una skill, siempre escribe en ~/.hermes/skills/. Si existe una skill con el mismo nombre en ambos lugares, la versión local tiene prioridad.¹¹

Skills fijadas: skills.auto_load (periodo de la versión 0.21.4)

Los nombres de skills incluidos en skills.auto_load dentro de config.yaml quedan fijados para cargarse por completo en cada sesión nueva, ya sea de CLI, TUI, gateway, cron o API:⁵¹

skills:
  auto_load:
    - team-conventions
    - deploy-checklist

La lista se resuelve una sola vez, cuando se crea por primera vez el prompt del agente. Si falta un nombre o está deshabilitado, se muestra una advertencia y se omite en lugar de provocar un error en la sesión. Además, HERMES_IGNORE_RULES (el mecanismo subyacente de --ignore-rules) suprime la lista, al igual que el resto del contexto insertado automáticamente. Esto complementa a -s/--skills con instrucciones permanentes, mientras que estas opciones solo precargan skills para una sesión.⁵¹

Memoria persistente

Hermes cuenta con una memoria limitada y seleccionada que persiste entre sesiones. La memoria del agente se compone de dos archivos, ambos almacenados en ~/.hermes/memories/:¹²

Ambos se incorporan al prompt del sistema como una instantánea inmutable al inicio de la sesión. El agente administra su propia memoria mediante la herramienta memory: add, replace o remove.¹²

Patrón de instantánea inmutable: la información incorporada al prompt del sistema se captura una sola vez al inicio de la sesión y nunca cambia durante esta. Esto es intencional, ya que conserva la caché del prefijo de LLM para mejorar el rendimiento. Los cambios realizados durante una sesión se guardan de inmediato en el disco, pero no aparecen en el prompt del sistema hasta la siguiente sesión.¹²

Qué guardar

Guarda lo siguiente (el agente lo hace de manera proactiva):¹² - Preferencias del usuario: «Prefiero TypeScript en lugar de JavaScript» → user - Datos del entorno: «Este servidor ejecuta Debian 12 con PostgreSQL 16» → memory - Correcciones: «No uses sudo para los comandos de Docker; el usuario pertenece al grupo docker» → memory - Convenciones: «El proyecto usa tabulaciones, líneas de hasta 120 caracteres y docstrings al estilo de Google» → memory - Trabajo completado: «La base de datos se migró de MySQL a PostgreSQL el 15 de enero de 2026» → memory

Omite lo siguiente:¹² - Información trivial u obvia - Datos que puedan volver a descubrirse fácilmente - Volcados de datos sin procesar (son demasiado grandes para la memoria) - Información efímera específica de una sesión - Información que ya se encuentre en los archivos de contexto

Búsqueda de sesiones

Además de MEMORY.md y USER.md, el agente puede buscar en sus conversaciones anteriores mediante la herramienta session_search. Todas las sesiones de CLI y mensajería se almacenan en SQLite (~/.hermes/state.db) con búsqueda de texto completo FTS5. Desde el rediseño de v0.15.0, la herramienta no utiliza LLM en absoluto: devuelve directamente el contenido almacenado de las conversaciones (en palabras de la fuente, la «herramienta con una única estructura devuelve directamente el contenido de la base de datos»), lo que la hizo 4.500 veces más rápida y eliminó su costo de API.¹²⁵⁹³⁴

Dos incorporaciones del periodo de v0.21.4, ambas verificadas en la etiqueta v2026.9.21. Primero, límites temporales: la estructura de descubrimiento acepta after (un límite inferior inclusivo para la hora de inicio de la sesión) y before (un límite superior exclusivo), cada uno expresado como una fecha o fecha y hora ISO —un valor que solo contiene la fecha representa la medianoche UTC de ese día— o como una duración relativa (7d, 24h, 2w). Están pensados únicamente para consultas que indiquen de forma explícita un intervalo temporal; sort sigue siendo un sesgo de clasificación, no un límite. Segundo, un reintento de recuperación cuando no hay resultados: el AND implícito entre términos de FTS5 hace que una consulta reformulada con varias palabras pueda pasar por alto una oración almacenada si le falta siquiera uno de esos términos. Por eso, cuando la consulta exacta y todas las alternativas por subcadena no producen resultados, la búsqueda vuelve a consultar el índice haciendo coincidir CUALQUIER término y ordena primero las filas que abarcan más términos. Los resultados conservan la semántica de coincidencia exacta (el reintento solo se activa cuando no se obtiene ningún resultado), mientras que las consultas con OR/NOT explícitos, las de un solo término y las dirigidas mediante CJK no se modifican.⁵¹

Proveedores externos de memoria

Para contar con una memoria persistente más profunda que MEMORY.md y USER.md, Hermes incluye siete plugins de proveedores externos de memoria: Honcho, OpenViking, Mem0, Holographic, RetainDB, ByteRover y Supermemory. Otros, como Hindsight, se instalan desde el catálogo de plugins.¹²

Hindsight formó parte del árbol principal hasta v0.21.4 y pasó al catálogo en v0.21.5, bajo el mantenimiento de Vectorize. Las instalaciones existentes se migran automáticamente: si está definido memory.provider: hindsight, hermes update instala el plugin del catálogo en el directorio principal de cada profile que lo mencione, y el primer inicio del agente lo instala si todavía falta. Con security.allow_lazy_installs: false, el proceso de inicio del agente solo registra un mensaje, así que debes ejecutar hermes plugins install hindsight por tu cuenta. El plugin se instala en ~/.hermes/plugins/hindsight/ y se agrega a plugins.enabled; memory.provider, memory.hindsight.*, HINDSIGHT_API_KEY y tus datos de memoria permanecen intactos. Comprueba el estado con hermes memory status y hermes plugins list. El extra de pip hermes-agent[hindsight] ya no existe.⁵³

Los proveedores externos funcionan junto con la memoria integrada (nunca la reemplazan) y agregan funciones como grafos de conocimiento, búsqueda semántica, extracción automática de datos y modelado del usuario entre sesiones:⁶¹²

hermes memory setup         # Pick a provider and configure it
hermes memory status        # Check what's active
hermes memory off           # Disable external provider (built-in only)

Solo puede estar activo un proveedor externo a la vez. La memoria integrada siempre está activa.⁶

Reanudación automática de sesiones (v0.13.0+)

v0.13.0 permite recuperarse de una interrupción mientras el agente está en ejecución. El gateway reanuda automáticamente las sesiones interrumpidas después de un reinicio; los reinicios provocados por /update conservan el estado de la sesión durante la actualización; y, durante el desarrollo, las recargas de archivos fuente mantienen viva la sesión activa en lugar de forzar una nueva.¹⁸ En la práctica, el trabajo de larga duración en el gateway y las tareas ejecutadas mediante cron ya no reinician su ventana de contexto cuando se reinicia el proceso.

Checkpoints v2 (v0.13.0+)

En v0.13.0, la persistencia del estado se reescribió como un diseño de almacenamiento único con depuración real, mecanismos de protección del disco y sin repositorios paralelos huérfanos.¹⁸ El sistema anterior de checkpoint acumulaba estado en el disco de los profile de larga duración; el almacenamiento v2 establece un límite estricto para el almacenamiento local de checkpoint y elimina la contabilidad duplicada que provocaba ese crecimiento. No se requiere ningún cambio de configuración por parte del usuario; la siguiente escritura de checkpoint utiliza la ruta de v2.

Personalidad y SOUL.md

SOUL.md es la identidad principal de una instancia de Hermes. Ocupa la posición n.º 1 en el prompt del sistema y reemplaza la identidad predeterminada definida directamente en el código.¹³

Hermes crea automáticamente un SOUL.md predeterminado en ~/.hermes/SOUL.md (o en $HERMES_HOME/SOUL.md para los profile personalizados). Los archivos existentes del usuario nunca se sobrescriben. Hermes solo carga SOUL.md desde HERMES_HOME; no lo busca en el directorio de trabajo actual. Así, la personalidad se mantiene predecible entre distintos proyectos.¹³

Qué debe incluir SOUL.md

Úsalo para definir pautas duraderas sobre la voz y la personalidad:¹³ - tono - estilo de comunicación - grado de franqueza - estilo de interacción predeterminado - qué evitar en cuanto al estilo - cómo debe manejar Hermes la incertidumbre, los desacuerdos y la ambigüedad

Úsalo menos para:¹³ - instrucciones específicas de un solo proyecto - rutas de archivos - convenciones del repositorio - detalles temporales del flujo de trabajo

Todo eso corresponde a AGENTS.md, no a SOUL.md.

SOUL.md frente a AGENTS.md

Esta es la distinción más importante en la administración de la identidad de Hermes:¹³

SOUL.md — identidad, tono, estilo, valores predeterminados de comunicación y comportamiento relacionado con la personalidad.

AGENTS.md — arquitectura del proyecto, convenciones de código, preferencias de herramientas, flujos de trabajo específicos del repositorio, comandos, puertos, rutas y notas de despliegue.

Una regla útil: si debe acompañarte a todas partes, corresponde a SOUL.md. Si pertenece a un proyecto, corresponde a AGENTS.md.¹³

Personalidades integradas

Hermes incluye personalidades integradas que puedes activar con /personality:¹³³³

Personalidades personalizadas en config.yaml:¹³

agent:
  personalities:
    codereviewer: >
      You are a meticulous code reviewer. Identify bugs, security issues,
      performance concerns, and unclear design choices. Be precise and constructive.

Después, actívala con /personality codereviewer.

SOUL.md frente a /personality

SOUL.md define la voz de referencia. /personality es una capa adicional para la sesión.¹³ Mantén un SOUL.md predeterminado y pragmático; luego usa /personality teacher para una conversación educativa o /personality creative para una lluvia de ideas.

Nous Tool Gateway (v0.10.0+)

A partir de Hermes Agent v0.10.0 (2026-04-16), los suscriptores de pago de Nous Portal obtienen acceso administrado a un conjunto seleccionado de herramientas mediante sus credenciales actuales de Portal, sin tener que gestionar claves de API adicionales.⁶¹ El CLI de Hermes sigue teniendo licencia MIT y siendo completamente de código abierto. Lo que cambió es que la autenticación de Portal ahora desbloquea más funciones además de la inferencia de modelos.

La forma más rápida de empezar es hermes setup --portal, que el README presenta como «Un comando desde una instalación nueva»: inicia sesión mediante OAuth, configura Nous como tu proveedor y activa Tool Gateway. A partir de entonces, hermes portal administra la conexión. hermes portal login (la opción predeterminada cuando no se especifica ningún subcomando) ejecuta la misma incorporación de una sola vez; hermes portal info muestra el «resumen de autenticación de Portal y enrutamiento de Tool Gateway»; hermes portal open abre la página de suscripción en tu navegador predeterminado; hermes portal tools enumera las herramientas del gateway e indica cuáles se enrutan mediante Nous. hermes portal status se conserva como alias oculto de info por compatibilidad con versiones anteriores, y la referencia de CLI en la documentación de esa etiqueta todavía denomina al subcomando status, por lo que ambos funcionan.²⁸

Qué incluye el gateway

Cómo funciona

El gateway se habilita por herramienta mediante un nuevo campo de configuración use_gateway. Si tienes credenciales de Portal en hermes auth y habilitas el gateway para una herramienta, las llamadas de esa herramienta se enrutan a través de Portal. De lo contrario, se utiliza tu clave directa de API (si está disponible).

# config.yaml — per-tool gateway opt-in
tools:
  web_search:
    provider: firecrawl
    use_gateway: true          # route via Nous Portal subscription
  image_generation:
    provider: fal
    use_gateway: true

Precedencia en tiempo de ejecución: cuando el gateway está disponible y una herramienta tiene use_gateway: true, Hermes da preferencia al gateway aunque también tengas configurada una clave directa de API. Esto es importante para la facturación: las llamadas al gateway se descuentan de tu suscripción de Portal, no del saldo de tu clave directa de API.

Cómo habilitar el gateway

hermes model                      # select Nous Portal (OAuth flow)
hermes tools                      # per-platform tool picker integrates gateway tools
hermes status                     # confirms gateway/subscription detection

La suscripción se detecta automáticamente a partir de las credenciales de OAuth de Portal que ya tienes en hermes auth; no hay ningún paso de inicio de sesión adicional. Desde v0.19.0 también puedes administrar la suscripción desde una sesión: /subscription muestra tu plan y la asignación restante, indica exactamente cuánto cuesta una mejora o cuándo entra en vigor una reducción del plan, y aplica el cambio con avisos de cambios programados y la opción de deshacerlo; /topup agrega crédito. La aplicación de escritorio incluye una pestaña equivalente de configuración de facturación.⁵⁶

Precios y acceso

Los precios y nombres de los niveles se publican en la página de precios de Nous Portal (https://portal.nousresearch.com/pricing). Esta guía no enumera los niveles porque son responsabilidad del producto Portal, no del CLI de Hermes, y cambian con independencia de las versiones de Hermes. Regístrate en https://portal.nousresearch.com/ y consulta la página de precios para conocer los niveles actuales.

Nivel gratuito de Nous y primer inicio guiado (v0.21.2+)

Desde v0.21.2, una instalación nueva no necesita un plan de pago ni una clave de API para ofrecer un agente funcional: incluye inferencia y conectores gratuitos desde el primer momento, con un solo comando para iniciar sesión, y /login inicia el acceso desde un chat. Las herramientas de los conectores (Gmail, Linear, Notion y las demás) pueden buscarse mediante tool_search como cualquier otra herramienta. La aplicación de escritorio incorpora un primer inicio guiado controlado por HERMES_GUEST_ONBOARDING=1; solo el valor literal 1 lo habilita – la propia prueba de la aplicación de escritorio confirma que 'true', '0' y un valor vacío lo mantienen desactivado, y la decisión tomada al iniciar queda registrada en el entorno del backend generado para que nunca se filtre un valor heredado.⁴⁸

Desde el periodo de lanzamiento de v0.21.4, conectar esos conectores es una única operación a cargo del backend, en lugar de lógica dispersa entre distintas interfaces: una llamada a la herramienta manage_connections controla en el backend una máquina de estados de conexión basada únicamente en datos (con un límite fijo de 300 segundos por operación – deliberadamente, no es una clave de configuración), y Desktop, TUI y CLI la presentan como la misma tarjeta de configuración. La tarjeta muestra un campo por cada credencial faltante (nombre, indicación y si es obligatoria) y mantiene deshabilitada su acción hasta que todos los campos obligatorios contengan texto; el backend aplica la misma separación exclusiva de secretos en todas las interfaces.⁵¹

Aviso de obsolescencia

• La variable de entorno HERMES_ENABLE_NOUS_MANAGED_TOOLS fue eliminada en v0.10.0. Ahora las herramientas administradas se habilitan mediante el campo de configuración use_gateway de cada herramienta y dependen del estado de tu suscripción de Portal.⁶¹

Contexto: lo que esta versión no es

El CLI de Hermes Agent no requiere una suscripción. El proyecto sigue teniendo licencia MIT, y todas las funciones principales (CLI, skills, memoria, gateway de mensajería, cron, MCP, panel local y BYOK para todos los proveedores) funcionan de principio a fin sin pagarle a nadie. v0.10.0 agrega una opción práctica para quienes ya pagan por Nous Portal; no elimina nada de la opción gratuita.

Gateway de mensajería

Hermes puede ejecutarse como un proceso gateway de larga duración que se conecta a 28 plataformas de mensajería desde un único proceso gateway: Telegram, Discord, Slack, WhatsApp, Signal, SMS, correo electrónico, Home Assistant, Mattermost, Matrix, DingTalk, Feishu/Lark, WeCom, Weixin (WeChat), BlueBubbles (iMessage), QQBot, Microsoft Teams, Tencent Yuanbao, Google Chat, LINE, SimpleX Chat, Photon (iMessage), WhatsApp Cloud API, WeCom Callback, Raft, IRC, ntfy, Buzz y un adaptador Webhook genérico.^360171819 La cifra de 28 proviene de la tabla de comparación de plataformas de la documentación en la etiqueta v2026.8.31; por debajo, gateway/config.py define 24 miembros integrados del enum Platform (incluidas entradas que no son de chat, como local, api_server, webhook, msgraph_webhook y relay) y resuelve cualquier otro nombre bajo demanda hacia uno de los 22 directorios de adaptadores incluidos en plugins/platforms/, por lo que contar solo el enum o los directorios no dará la misma cifra que la documentación.²⁵ v0.9.0 incorporó iMessage mediante BlueBubbles (registro automático de webhooks, asistente de configuración y resistencia ante fallos) y compatibilidad nativa con WeChat mediante iLink Bot API, con el modo de devolución de llamadas de WeCom para aplicaciones empresariales.¹⁶ v0.11.0 incorporó QQBot.⁶⁰ v0.12.0 incorporó Microsoft Teams y Tencent Yuanbao.¹⁷ v0.13.0 incorporó Google Chat como la plataforma número 20, sobre la misma arquitectura de adaptadores conectables; IRC y Microsoft Teams también migraron al nuevo patrón de adaptadores con hooks genéricos de plugins env_enablement_fn / cron_deliver_env_var.¹⁸ v0.14.0 incorpora LINE y SimpleX Chat y completa la integración de Microsoft Teams de extremo a extremo con autenticación de Graph, un listener de webhooks, el entorno de ejecución del pipeline y la entrega saliente.¹⁹ v0.17.0 (19 de junio de 2026) incorpora iMessage sin relay mediante Photon Spectrum (OAuth por código de dispositivo con hermes photon login; no requiere un relay de Mac/BlueBubbles), el adaptador oficial de WhatsApp Business Cloud API (que reemplaza el requisito de usar un proceso puente), grupos de SimpleX y archivos adjuntos nativos, y Raft como plugin de plataforma incluido.²¹ Hay otras dos plataformas en la tabla de la documentación que no recibieron atención en las notas de la versión: ntfy es un canal ligero de notificaciones push mediante publicación-suscripción HTTP (suscríbete a un tema desde la aplicación móvil de ntfy, envía un mensaje al tema para hablar con el agente y recibe la respuesta en tu teléfono; funciona con el servidor público ntfy.sh o con una instancia autohospedada, sin requerir SDK ni un daemon), mientras que Buzz conecta Hermes con una comunidad de Buzz, la plataforma de código abierto de Block para la colaboración entre personas y agentes mediante el protocolo Nostr; para los mensajes salientes, ejecuta buzz CLI y, para los entrantes, utiliza una suscripción nativa WebSocket de Nostr. Ambas se configuran mediante hermes gateway setup.²⁵

Configuración

hermes gateway setup                # Interactive platform configuration
hermes gateway install              # Install as user service (systemd/launchd)
hermes gateway start                # Start the installed service
hermes gateway stop
hermes gateway restart
hermes gateway status
hermes gateway run                  # Run in foreground (debugging)

La configuración interactiva te guía para conectar cada plataforma: tokens de API, identificadores de bots, asignaciones de canales y listas de permitidos.⁶

Cómo fluyen los mensajes

Según la documentación de arquitectura del proyecto original:³

Platform event → Adapter.on_message() → MessageEvent
  → GatewayRunner._handle_message()
    → authorize user
    → resolve session key
    → create AIAgent with session history
    → AIAgent.run_conversation()
    → deliver response back through adapter

Todas las plataformas de mensajería pasan por el mismo ciclo de conversación de AIAgent que CLI. Por eso los comandos con barra funcionan de manera idéntica en ambos lugares y una tarea cron programada en Telegram puede entregar su resultado en Discord: la diferencia entre plataformas solo existe en el extremo.³

v0.19.0 incorpora el enrutamiento de mensajes basado en perfiles y la entrega duradera. Un solo gateway multiplexado que comparte un token de bot puede dirigir servidores, canales o hilos específicos a diferentes profiles, cada uno con configuración, skills, memoria y secretos completamente aislados, además de permitir el ajuste mediante GATEWAY_MULTIPLEX_PROFILES; una serie de mejoras de robustez también evita que un profile mal configurado pueda derribar todo el gateway. Internamente, el índice de enrutamiento se trasladó a state.db (sessions.json ahora es un espejo heredado opcional), y las respuestas finales se registran en un libro mayor duradero de obligaciones de entrega en torno al envío de la plataforma: si una respuesta terminada coincide con un fallo del gateway, se vuelve a entregar en el siguiente arranque en lugar de perderse silenciosamente.⁵⁶ El aislamiento entre los profiles enrutados se reforzó en v0.21.2, que corrigió un conjunto de filtraciones entre profiles precisamente en esta configuración multiplexada: listas de permitidos heredadas, credenciales enviadas al host del profile predeterminado, secretos del almacén del profile predeterminado que llegaban a servidores stdio MCP, archivos adjuntos MEDIA: entre profiles y el token bearer de Nous de un profile hermano que persistía en memorias por proceso (#107609-#107630).⁴⁸

v0.21.1 hace que los límites de las conversaciones solo puedan establecerse de manera explícita. El documento sobre el ciclo de vida de las sesiones en la etiqueta v2026.9.7 establece el contrato en cuatro frases: «La inactividad y el tiempo de reloj nunca rotan una conversación. /new y /reset crean un límite explícito; la compresión de contexto continúa gestionando los historiales largos. La configuración heredada de temporizadores se ignora. El tipo de datos existente SessionResetPolicy es información inerte de compatibilidad, no una política de tiempo de ejecución». La suspensión explícita sigue creando un límite en el siguiente turno entrante, la recuperación respeta los límites finalizados en lugar de reabrirlos y el desalojo exclusivo de recursos permite reanudar las conversaciones. Si una sesión de tu gateway parece «no caducar nunca», ese es ahora el comportamiento previsto; rótala tú mismo con /new.⁴³

Desde el periodo de v0.21.4, una segunda ejecución de hermes gateway run se conecta o se niega a continuar en lugar de vincularse por duplicado. La regla permite un hermes serve y un hermes gateway run por host y usuario del sistema operativo; cada uno multiplexa todos los profiles. Si inicias un gateway para un profile que el multiplexor en ejecución ya atiende, este simplemente se conecta y finaliza con el código 0; si todavía no atiende ese profile, Hermes le pide que vuelva a examinar profiles/ y se conecta cuando lo haga; si no puede hacer que atienda el profile, el comando se niega a continuar en lugar de iniciar silenciosamente un segundo gateway. --replace ahora actúa sobre ese proceso del host, sin importar qué profile lo haya iniciado, y --force omite por completo la pregunta cuando el propietario está bloqueado. Los gateways independientes siguen coexistiendo: si el gateway en ejecución es el independiente (no multiplexado) de otro profile, tu profile inicia el suyo a su lado como antes, hasta que se fuerce esa migración (#109417). Si dos gateways se inician al mismo tiempo, el que pierde el bloqueo del host termina con el código 75, que todos los supervisores generados por Hermes vuelven a intentar; para entonces, el registro del ganador ya existe, por lo que el reintento se conecta o se niega a continuar según las reglas anteriores. Los bloqueos y el registro del punto de encuentro se almacenan en $HERMES_GATEWAY_LOCK_DIR o, en su defecto, en $XDG_STATE_HOME/hermes/gateway-locks (de manera predeterminada, ~/.local/state/hermes/gateway-locks) y se limitan al usuario del sistema operativo; un registro cuyo PID ya no existe o fue reutilizado por otro proceso se considera obsoleto y se ignora, por lo que un gateway que falla no bloquea el siguiente inicio. La aplicación de escritorio sigue la misma regla y se conecta al backend del host en ejecución en lugar de iniciar otro.⁵¹

Desde v0.21.5, la multiplexación ya no es opcional. gateway.multiplex_profiles tiene un único valor válido, true: si la clave no está definida, se resuelve como activada y se escribe en el config.yaml del profile predeterminado; un valor false explícito se reescribe como true en el mismo lugar, acompañado de un aviso enmarcado que aparece una sola vez al iniciar ese gateway y de nuevo en el resumen de la siguiente ejecución de hermes update. Dos controles reemplazan la opción anterior de desactivarla. Para desconectar un solo profile sin detener los bots de todos, ejecuta hermes -p <name> gateway stop: el host lo estaciona mediante un marcador profiles/<name>/gateway.parked, mientras que hermes -p <name> gateway start lo reactiva; los botones Detener/Iniciar del dashboard y de la aplicación de escritorio hacen lo mismo. Un profile con nombre que aún necesite su propio gateway debe establecer gateway.standalone: true en su propio config.yaml; el host nunca lo atiende, y sus comandos stop/start actúan sobre su propio proceso. La documentación denomina esta clave «una solución temporal de compatibilidad», no una topología admitida, y se ignora con una advertencia en el profile predeterminado. Una división entre usuarios del sistema operativo, o un HERMES_HOME fuera de profiles/ en el directorio principal predeterminado, sigue requiriendo --force.⁵³

Autorización y vinculación de usuarios

hermes pairing list                    # Show pending and approved users
hermes pairing approve <platform> <code>
hermes pairing revoke <platform> <user-id>
hermes pairing clear-pending

Los códigos de vinculación evitan que desconocidos hablen con tu gateway. El usuario envía un código de vinculación desde su plataforma de mensajería; tú lo apruebas con hermes pairing approve y, a partir de entonces, queda autorizado.⁶

unauthorized_dm_behavior determina qué recibe el mensaje directo de un desconocido antes de la vinculación: pair responde con un código de vinculación, ignore descarta el mensaje silenciosamente y decline, el valor incorporado durante el periodo de v0.21.4, envía un único rechazo cortés y luego guarda silencio ante ese remitente durante 24 horas (#88028). El rechazo se deduplica por plataforma y remitente, incluso entre alias, y su texto proviene de unauthorized_dm_decline_message (una clave global; si está vacía, se usa la respuesta integrada: «¡Hola! Soy un asistente personal y solo puedo conversar con mi propietario, así que no puedo ayudarte directamente. ¡Lo siento!»). Establece el comportamiento de forma global o por plataforma, que es donde lo escribe el asistente de configuración:

# ~/.hermes/config.yaml
unauthorized_dm_behavior: decline      # global; gateway.unauthorized_dm_behavior also works
unauthorized_dm_decline_message: ""    # empty = built-in reply
platforms:
  telegram:
    unauthorized_dm_behavior: pair     # per-platform value always wins

Cuando no se configura nada, el valor predeterminado efectivo depende de tus listas de permitidos. Si no hay ninguna configurada, es pair; en cuanto se define cualquier lista de permitidos (GATEWAY_ALLOWED_USERS o una variable de usuarios permitidos, usuarios de grupos permitidos o chats grupales permitidos de una plataforma), pasa a ser ignore, porque la lista indica que el gateway se restringió de forma deliberada, y enviar códigos a contactos desconocidos genera ruido y puede filtrar información (#9337). Un valor global ignore o decline prevalece sobre esa regla, pero un valor global pair no puede hacerlo, ya que se interpreta igual que el valor predeterminado; para conservar la vinculación junto con una lista de permitidos, establece pair por plataforma. (La política dm_policy propia del adaptador de una plataforma, cuando exista, se consulta antes de aplicar la regla de la lista de permitidos). El correo electrónico funciona como una bandeja de entrada y utiliza ignore de manera predeterminada, salvo que su propia clave por plataforma habilite otra opción; un valor global no se aplica en este caso. hermes gateway setup ofrece el rechazo como una de las opciones cuando configuras una plataforma sin una lista de permitidos.⁵¹

Tareas programadas (Cron)

Hermes cuenta con un sistema cron de primera clase donde los trabajos son tareas del agente, no comandos de shell. Cada trabajo programado se ejecuta mediante un AIAgent nuevo con el prompt configurado y las skills adjuntas opcionales, y entrega los resultados en cualquier plataforma:³⁶

hermes cron list
hermes cron create --prompt "Check HN for AI news and summarize" --schedule "0 9 * * *" --deliver telegram
hermes cron edit <id>
hermes cron pause <id>
hermes cron resume <id>
hermes cron run <id>         # Trigger now on the next tick
hermes cron remove <id>
hermes cron status           # Check if scheduler is running
hermes cron tick             # Run due jobs once and exit

También puedes crear uno de forma conversacional dentro de un chat de mensajería:

Every morning at 9am, check Hacker News for AI news and send me a summary on Telegram.

El agente configurará el trabajo cron mediante sus herramientas. Los trabajos se guardan en JSON y persisten después de los reinicios.³

v0.21.0 incorporó memoria y criterio a los trabajos programados. Incluye cuatro mecanismos, todos verificados en la etiqueta v2026.8.31:³⁵³⁷

• Continuidad. continuity=true inyecta en cada ejecución la salida más reciente del propio trabajo, de modo que un explorador o monitor «despierta viendo lo que informó la última vez y puede eliminar duplicados y continuar desde donde se quedó». La instrucción inyectada es «evitar repetir lo que ya se informó», la primera ejecución no cambia y, a nivel interno, la bandera se almacena como la entrada reservada self en context_from. Actívala o desactívala con hermes cron create ... --continuity y hermes cron edit <job_id> --continuity / --no-continuity.³⁷
• Blocs de notas persistentes. Cada trabajo obtiene un pequeño espacio temporal de tipo KV para cursores, marcas de progreso y listas de seguimiento (16 KB por valor y 64 KB por trabajo; se inyecta en el prompt en cada ejecución, por eso los límites son deliberados), en el que se escribe mediante hermes cron notepad <job_id> set <key> <value>, comando que el agente en ejecución invoca a través de su herramienta de terminal.³⁷
• Modo monitor. Un trabajo puede adjuntar una fuente económica monitor_script/monitor_url que se ejecuta primero en cada ciclo: si la salida no cambia (se compara como bytes exactos), la ejecución del agente se omite por completo —sin llamada a LLM, sin entrega y con una ejecución silenciosa no_change—, mientras que un cambio inyecta un bloque de diferencias y ejecuta el agente normalmente. Haz que los scripts de monitoreo emitan una salida estable; de lo contrario, cada ciclo parecerá contener un cambio.³⁷
• Nivel de razonamiento por trabajo y entrega mediante Bot Chat. --reasoning-effort fija el nivel de razonamiento de un trabajo (de none a ultra) y anula la configuración global y por modelo para sus ejecuciones; por su parte, deliver=bot-chat envía la salida a la sesión canónica de Bot Chat de un profile como un mensaje entrante real, donde el bot «actúa sobre todo lo que requiera una acción y responde en su chat», en lugar de que una persona se limite a leer un canal.³⁷

Integración con MCP

Hermes admite Model Context Protocol tanto como cliente como servidor:⁶

Como cliente — conecta Hermes a servidores MCP externos para ampliar su conjunto de herramientas:

hermes mcp add <name> --url https://example.com/mcp
hermes mcp add <name> --command npx --args "-y,@modelcontextprotocol/server-github"
hermes mcp list
hermes mcp test <name>
hermes mcp remove <name>
hermes mcp configure <name>   # Toggle individual tool selection
hermes mcp login <name>       # Force re-auth for an OAuth server (--flow browser|device)
hermes mcp reauth [--all]     # Re-authenticate one OAuth server, or every one

O configúralo manualmente en config.yaml:¹⁴

mcp_servers:
  github:
    command: npx
    args: ["-y", "@modelcontextprotocol/server-github"]
    env:
      GITHUB_PERSONAL_ACCESS_TOKEN: "ghp_xxx"

Desde v0.19.0, las herramientas de MCP se presentan al modelo según la convención de nombres mcp__server__tool: cada nombre de herramienta incluye el nombre de su servidor, por lo que dos servidores que ofrezcan la misma herramienta ya no generan conflictos. Además, las notificaciones de registro del servidor MCP aparecen en agent.log.⁵⁶

v0.21.1 añade una modalidad con código de dispositivo para OAuth de MCP: hermes mcp login <name> acepta --flow {browser,device}; browser es el flujo PKCE existente, mientras que device es un inicio de sesión mediante código de dispositivo conforme a RFC 8628 para máquinas sin interfaz gráfica o remotas. Esta bandera anula la configuración oauth.flow del servidor. La misma versión exige que se respete la propiedad del profile durante todas las sesiones de OAuth, ignora las cachés de metadatos de OAuth con formato incorrecto en lugar de bloquear un servidor y retransmite OAuth de MCP del escritorio mediante callbacks locales del cliente. Además, -t/--toolsets ahora también filtra cuáles de los servidores MCP configurados se inician, por lo que una invocación de alcance limitado evita el arranque en frío de servidores que no necesita.⁴⁴

v0.21.0 convierte la interfaz de MCP de la aplicación de escritorio en un centro de control: los servidores y el catálogo se integran en una sola página con importación mediante «pegar cualquier cosa» al arrastrar contenido, comprobaciones de estado en segundo plano que avisan sobre autenticaciones próximas a vencer antes de que falle una llamada a una herramienta, una vista superpuesta de costos y uso de toda la flota que muestra estimaciones de tokens del esquema y el uso de los últimos 30 días por servidor, y enlaces profundos hermes:// que instalan un servidor MCP con confirmación explícita.³⁵

La versión v0.21.4 añade mcp.discovery_concurrency (valor predeterminado: 4; 0 = ilimitado, #117373), un límite para la cantidad de servidores MCP configurados a los que puede conectarse simultáneamente el proceso de detección. Todos los servidores siguen conectándose —el límite solo evita que lo hagan todos a la vez— y, si se proporciona un valor negativo o que no sea entero, se registra una advertencia y se utiliza el valor predeterminado.⁵¹

Como servidor — permite que otros agentes accedan a las conversaciones de Hermes:

hermes mcp serve
hermes mcp serve -v    # Verbose

Compresión del contexto

Hermes comprime automáticamente las conversaciones largas para mantenerlas dentro de la ventana de contexto de tu modelo. El resumidor de compresión realiza una llamada independiente a LLM, por lo que puedes dirigirla a cualquier proveedor o endpoint.⁴ Desde v0.20.6, la política de conservación del tramo final utiliza lean de forma predeterminada (compression.tail_mode: lean) y, en la etiqueta indicada, las opciones de modelo, proveedor y endpoint del resumidor se encuentran en auxiliary.compression.*, en lugar de las antiguas compression.summary_*. Las claves heredadas se migran automáticamente durante la primera carga (versión 17 de la configuración).³⁰³¹

compression:
  enabled: true
  threshold: 0.50          # Compress at this % of context limit
  threshold_tokens: null   # Optional absolute token cap -- trigger fires at the lower of ratio vs cap
  target_ratio: 0.20       # Fraction of threshold to preserve as recent tail (legacy tail mode)
  tail_mode: lean          # Tail retention: "lean" (default) or "legacy"
  protect_last_n: 20       # Min recent messages to keep uncompressed
  protect_first_n: 3       # Non-system head messages pinned across compactions

auxiliary:
  compression:
    model: ""              # Empty = main chat model; e.g. "google/gemini-3-flash-preview"
    provider: "auto"       # "auto", "openrouter", "nous", "codex", "main", etc.
    base_url: null         # Custom OpenAI-compatible endpoint (overrides provider)

Qué determina tail_mode. legacy conserva literalmente un tramo final del tamaño especificado por target_ratio; en configuraciones con ventanas grandes o umbrales elevados, esto acapara entre 100.000 y 240.000 tokens por compactación. lean conserva literalmente un tramo final limitado al 2,5 % de la ventana de contexto (con un mínimo de 10.000 y un máximo de 25.000) y, en su lugar, preserva la continuidad mediante el resumen: un registro detallado de la sesión que conserva los identificadores de la región compactada (una llamada al resumidor auxiliar por intento), un índice de referencias extraído mecánicamente (números de PR, SHA, rutas y cadenas de error; mediante expresiones regulares, sin parafrasear), todos los mensajes reales del usuario citados textualmente y un puntero de recuperación session_search para que el agente pueda volver a acceder a cualquier contenido eliminado por el resumen. Resultado medido en la documentación con sesiones reales de 500.000 tokens: se conservaron unos 49.000 tokens en lugar de unos 162.000. Los resultados antiguos de herramientas dentro del tramo final de lean se reducen a indicadores de una línea que incluyen un puntero de recuperación, y los valores de tail_mode desconocidos recurren a lean.³¹

Opciones de proveedor:⁴³¹

El modelo de resumen debe admitir una longitud de contexto al menos tan grande como la de tu modelo principal, ya que recibe toda la sección intermedia de la conversación en una sola llamada. Si su ventana es menor, la llamada falla y los turnos intermedios se descartan sin generar un resumen.⁴³¹

Advertencias de presión sobre el presupuesto

Cuando el agente trabaja en una tarea compleja con muchas llamadas a herramientas, puede consumir su presupuesto de iteraciones (valor predeterminado: 500 turnos desde v0.20.0, frente a los 90 anteriores) sin darse cuenta. La presión sobre el presupuesto advierte automáticamente al modelo:⁴

Tiempos de espera del streaming

La conexión de streaming de LLM tiene dos niveles de tiempo de espera que se ajustan automáticamente para los proveedores locales (localhost, direcciones IP de LAN):⁴

El tiempo de espera de lectura del socket aumenta a 30 minutos para los endpoints locales porque los LLM locales pueden tardar varios minutos en realizar el prellenado de contextos grandes antes de producir el primer token.⁴

Panel web local (v0.9.0+)

Un panel basado en el navegador para administrar Hermes Agent de forma local. Configura los ajustes, monitorea las sesiones, explora las skills y administra tu gateway sin tocar archivos de configuración ni la terminal.¹⁶ Inícialo con hermes dashboard. Esta es la vía de incorporación más sencilla para los usuarios nuevos que prefieren una GUI.

Monitoreo de procesos en segundo plano (v0.9.0+)

watch_patterns te permite establecer patrones para monitorear la salida de procesos en segundo plano y recibir notificaciones en tiempo real cuando haya coincidencias.¹⁶ Puedes monitorear errores, esperar eventos específicos (“escuchando en el puerto”) u observar registros de compilación, todo sin realizar consultas periódicas. En combinación con notify_on_complete, incorporado en v0.8.0 (que avisa cuando finaliza una tarea en segundo plano), Hermes ahora cuenta con una capa completa de observabilidad para procesos en segundo plano.¹⁵

Context engine intercambiable (v0.9.0+)

La gestión del contexto ahora es un componente intercambiable mediante hermes plugins. Puedes incorporar context engines personalizados que controlen lo que el agente ve en cada turno, ya sea mediante filtrado, resumen o inyección de contexto específico del dominio.¹⁶ Esto desacopla la estrategia de contexto del bucle principal del agente y permite personalizarla por proyecto o dominio.

Copia de seguridad y restauración (v0.9.0+)

hermes backup crea un archivo completo con tu configuración, sesiones, skills y memoria. hermes import restaura el contenido de un archivo de copia de seguridad.¹⁶ Úsalo para migrar entre computadoras, crear instantáneas antes de realizar cambios importantes o compartir con tus compañeros de equipo una configuración cuyo buen funcionamiento esté comprobado.

Compatibilidad con Termux y Android (v0.9.0+)

Hermes se ejecuta de forma nativa en Android mediante Termux. Las rutas de instalación adaptadas, las optimizaciones de la TUI para pantallas móviles, la compatibilidad con motores de voz y el comando /image funcionan directamente en el dispositivo.¹⁶

Refuerzo de la seguridad (v0.13.0+)

v0.13.0 corrigió 8 problemas de seguridad P0 y modificó un valor predeterminado en beneficio del usuario.¹⁸ A continuación, v0.14.0 corrigió otros 12 problemas P0 y 50 P1, entre ellos el refuerzo contra ataques de fuerza bruta a sudo y el uso de sudo mediante stdin, correcciones de mecanismos para eludir la detección de comandos peligrosos, la depuración de errores de herramientas antes de reinyectarlos en el modelo, la autenticación de API en plugins del panel, la cobertura contra SSRF en el centro de skills y el análisis de avisos sobre la cadena de suministro durante la instalación.¹⁹

Si mantienes una implementación de Hermes, considera v0.13.0 y v0.14.0 como actualizaciones relevantes para la seguridad, no como simples entregas de funciones. v0.13.0 corrige la omisión de restricciones entre servidores de Discord y dos ventanas TOCTOU; v0.14.0 incorpora otra ronda de refuerzo que abarca el manejo de sudo, la reinyección de errores de herramientas, los APIs de plugins, SSRF en el centro de skills y los avisos sobre dependencias.

v0.21.0 incorpora una cuarta ronda. Las escrituras en archivos protegidos de instrucciones del agente – AGENTS.md, CLAUDE.md, SOUL.md, .cursorrules, skills y almacenes de memoria – ahora siempre requieren aprobación, por lo que un agente afectado por una inyección de prompts no puede reescribir silenciosamente sus propias instrucciones permanentes. La barrera viene activada de forma predeterminada (security.protected_instruction_files: true, con una lista ampliable de nombres base mediante fnmatch en protected_instruction_extra_patterns), y el código fuente identifica el vector exacto que bloquea: “una instrucción inyectada que edita AGENTS.md / CLAUDE.md / SOUL.md”. También señala que los archivos de instrucciones se cargan desde los árboles del directorio de trabajo actual, por lo que “un AGENTS.md ubicado en cualquier lugar desde el que el agente pudiera ejecutarse más adelante es un objetivo activo”.³⁵³⁹ La misma versión corrige filtraciones de secretos en errores de terminal, lecturas de archivos .env, checkpoints y registros de ACP; enseña al sistema de aprobación a reconocer comandos y rutas destructivos de Windows; permite que los permisos concedidos en macOS se conserven tras las actualizaciones mediante una identidad estable de firma TCC (configuración única: hermes desktop --setup-tcc-identity, solo para macOS, requiere openssl/security/codesign); elimina la entrada de Blender MCP del catálogo y su skill tras un incidente de seguridad en el proyecto original; y añade análisis de seguridad de nivel 1 a las instalaciones de plugins.³⁵³⁹

Arquitectura para profesionales

Esta sección está dirigida a quienes desean entender qué ocurre tras bambalinas para poder depurar Hermes, ampliarlo o analizar su rendimiento. Es una síntesis de la documentación de arquitectura del proyecto original.³

Puntos de entrada → AIAgent

Cada punto de entrada de Hermes termina llamando a AIAgent.run_conversation():

┌──────────────────────────────────────────────────────────────────┐
│                        Entry Points                              │
│                                                                  │
│  CLI (cli.py)    Gateway (gateway/run.py)    ACP (acp_adapter/)  │
│  Batch Runner    API Server                  Python Library     │
└──────────┬──────────────┬───────────────────────┬────────────────┘
           │              │                       │
           ▼              ▼                       ▼
┌──────────────────────────────────────────────────────────────────┐
│                     AIAgent (run_agent.py)                       │
│                                                                  │
│  ┌─────────────┐  ┌──────────────┐  ┌──────────────┐             │
│  │ Prompt      │  │ Provider     │  │ Tool         │             │
│  │ Builder     │  │ Resolution   │  │ Dispatch     │             │
│  └──────┬──────┘  └──────┬───────┘  └──────┬───────┘             │
│         │                │                 │                    │
│  ┌──────┴───────┐ ┌──────┴───────┐  ┌──────┴───────┐             │
│  │ Compression  │ │ 3 API Modes  │  │ Tool Registry│             │
│  │ & Caching    │ │ chat_compl   │  │ 47 tools     │             │
│  │              │ │ codex_resp   │  │ 20 toolsets  │             │
│  │              │ │ anthropic    │  │              │             │
│  └──────────────┘ └──────────────┘  └──────────────┘             │
└──────────────────────────────────────────────────────────────────┘

Diagrama adaptado de la documentación de arquitectura del proyecto original.³

«47 herramientas / 20 toolsets» frente a «28 herramientas» en tu banner. El recuento de «47 herramientas» corresponde al registro total de herramientas del repositorio original: todas las herramientas cuyo código fuente se incluye con Hermes, en todos los toolsets. La instancia de CLI que realmente ejecutes mostrará una cifra menor en su banner de inicio (la instalación con la que verifiqué esta guía informa 28 tools / 89 skills). No se trata de un error. Muchos toolsets son opcionales y deben habilitarse explícitamente en config.yaml, dentro de toolsets:; por ejemplo, los adaptadores de plataformas de mensajería, la automatización del navegador y las herramientas de extracción más exigentes. El total del registro representa «lo disponible»; la cifra del banner, «lo habilitado en tu profile actual». Consulta qué toolsets están activos con hermes tools --list y habilita o deshabilita toolsets individuales mediante el bloque toolsets: de ~/.hermes/config.yaml (o con /tools list, /tools enable <name> y /tools disable <name> dentro de una sesión en ejecución; quitar una herramienta reinicia la sesión para que el agente reconstruya su manifiesto de herramientas).

Los tres modos de API

Hermes abstrae las diferencias entre proveedores en tres modos de API, seleccionados automáticamente durante la ejecución:³

El resolutor runtime_provider.py asigna tuplas (provider, model) a (api_mode, api_key, base_url) para más de 18 proveedores y gestiona los flujos de OAuth, los grupos de credenciales y la resolución de alias.³

Flujo de datos durante una sesión de CLI

User input → HermesCLI.process_input()
  → AIAgent.run_conversation()
    → agent.prompt_builder.build_system_prompt()
    → runtime_provider.resolve_runtime_provider()
    → API call (chat_completions / codex_responses / anthropic_messages)
    → tool_calls? → model_tools.handle_function_call() → loop
    → final response → display → save to SessionDB

Tomado de la página de arquitectura del proyecto original.³

Orden de composición del prompt

La pila del prompt incluye:¹³

1. SOUL.md (identidad del agente, o la alternativa integrada si no está disponible)
2. Orientación de comportamiento adaptada a las herramientas
3. Memoria y contexto del usuario (MEMORY.md, USER.md)
4. Orientación sobre skills
5. Archivos de contexto (AGENTS.md, .cursorrules)
6. Marca de tiempo
7. Indicaciones de formato específicas de la plataforma
8. Capas opcionales sobre el prompt del sistema, como /personality

SOUL.md es la base: todo lo demás se construye sobre él.¹³

Almacenamiento de sesiones

Almacenamiento de sesiones basado en SQLite con búsqueda de texto completo FTS5. Las sesiones incluyen seguimiento de linaje (relaciones principal/secundaria entre compresiones), aislamiento por plataforma y escrituras atómicas con gestión de contención.³

Si el almacén te causa problemas en una instalación v0.21.x, usa la versión v0.21.2 o una posterior: corrigió los problemas de fragilidad de state.db propios de la época de v0.21.0 (segundos procesos de escritura que cancelaban los bloqueos entre sí, bases de datos en buen estado marcadas como dañadas y una sola fila defectuosa que impedía ejecutar sessions list) y trasladó la coordinación de salas alojadas fuera del almacén raíz a un archivo shared-state.db dedicado, de modo que los gateways de los profiles nunca abran el almacén principal de sesiones con permisos de escritura. Ahora hermes doctor distingue entre daños estructurales y daños del índice FTS; si FTS está dañado, la búsqueda se degrada en lugar de provocar un error durante el turno; y hermes sessions recover --inspect-only (sin conexión, no destructivo y vinculado a un profile) informa si la tabla canónica puede leerse sin crear una base de datos de salida. El subcomando es anterior a este periodo, pero aún no se había documentado aquí. Consulta Novedades de v0.21.2.⁴⁸ Para un almacén bloqueado en el modo de diario incorrecto de SQLite, durante el periodo de v0.21.4 se incorporó el conversor sin conexión hermes sessions set-journal-mode delete|wal (consulta la fila de hermes sessions en Comandos de nivel superior).⁵¹

Sistema de plugins

Hay tres fuentes de descubrimiento: ~/.hermes/plugins/ (usuario), .hermes/plugins/ (proyecto) y los puntos de entrada de pip. Los plugins registran herramientas, hooks y comandos de CLI mediante un API de contexto. Los proveedores de memoria son un tipo especializado de plugin ubicado en plugins/memory/.³ Desde v0.21.2 también existe un catálogo seleccionado de plugins, fijados mediante SHA, que puedes explorar e instalar por nombre, además de hermes plugins pack para crear «conjuntos de plugins declarativos y compartibles»: un único archivo hermes-pack.yaml fija un conjunto de plugins a sus SHA de commit exactos; la instalación del paquete se distribuye en instalaciones fijadas convencionales, mientras que el consentimiento de capacidades se mantiene por plugin.⁴⁸

Durante el periodo de v0.21.4, ese catálogo pasó de ser una superficie de CLI a un artefacto incluido con el producto. El directorio plugin-catalog/ del repositorio creció de 9 entradas en v2026.9.14 a 228 en v2026.9.21: un YAML revisado por plugin (nombre, repositorio, responsable del mantenimiento, nivel, categoría y capacidades), fijado a un SHA de commit exacto de 40 caracteres, donde la presencia en el directorio constituye la admisión. El catálogo se publica como plugin-catalog.json para CLI (se obtiene en tiempo real y se almacena en caché en ~/.hermes/cache/). Ahora el sitio de documentación genera una página por plugin (/docs/plugins/<name>) y otra por autor (/docs/plugins/by/<slug>) a partir de esos mismos datos. Cada página muestra el README del plugin obtenido del commit fijado, nunca del extremo de una rama, mediante una lista de permitidos aplicada durante la compilación que descarta HTML sin procesar; además, el orden por fecha de incorporación o actualización se determina a partir de las fechas de los responsables de los commits. Los diez plugins de la comunidad mencionados en la versión v0.21.4 aparecen en el catálogo de la etiqueta, con sus identificadores reales: hermes-tailscale, hermes-ssh, shodan, hermes-terminal, hermes-rss (además de un rss-reader independiente), hermes-resetwatch, done-bell, kiwi, cognee y web-octen. En la aplicación de escritorio, el centro de Plugins ahora permite desinstalar un plugin mediante un cuadro de confirmación: los plugins del catálogo se eliminan con plugins.manage remove, mientras que los plugins independientes de escritorio se quitan mediante el cargador de Electron.⁵¹

hermes plugins                       # Interactive enable/disable UI
hermes plugins browse                # List every curated plugin catalog entry (v0.21.2+)
hermes plugins search <query>        # Search the curated plugin catalog (v0.21.2+)
hermes plugins install <name|repo>   # Install from the curated catalog, a Git URL, or owner/repo
hermes plugins enable <name>
hermes plugins disable <name>
hermes plugins list
hermes plugins pack install <src>    # Shareable SHA-pinned plugin sets; also: pack export, pack show (v0.21.2+)

El periodo de compatibilidad (v0.21.1) ya venció: los plugins externos debían dejar de usar las rutas de importación anteriores a la descomposición antes del 14 de septiembre de 2026. La descomposición de septiembre de 2026 (PR #102117) reubicó los componentes internos que los plugins solían importar, y una capa temporal COMPAT_MANIFEST.md volvió a exportar 1.148 nombres públicos trasladados desde sus módulos anteriores, con una advertencia única por nombre y proceso (HermesPluginCompatWarning). La eliminación entró en vigor según lo previsto el 14 de septiembre de 2026 mediante una condición de fecha en el código distribuido (COMPAT_REMOVAL_DATE en hermes_cli/plugin_compat.py; no fue necesario revertir código): desde esa fecha, los plugins afectados quedan deshabilitados, no se cargan, y se muestra un aviso rojo en el banner de CLI, hermes doctor y hermes update, además de un cuadro de diálogo único en la aplicación de escritorio y el motivo en hermes plugins list. Autores: hermes plugins compat <path> todavía muestra cada file:line con la ruta anterior -> la ruta nueva y termina con el código 1 mientras quede alguna pendiente (agrega --json para obtener una salida legible por máquinas). Si dependes de un plugin sin mantenimiento, todavía puedes establecer plugins.allow_deprecated_imports: true en config.yaml; debe ser un valor booleano YAML literal, no una cadena entre comillas. Esto aún funciona porque la reversión que elimina las rutas anteriores todavía no se ha incorporado: el manifiesto y las capas de compatibilidad están presentes en v2026.9.14, v2026.9.21, v2026.9.24 y main al 24 de septiembre (durante el periodo de v0.21.4, el módulo de compatibilidad solo se modificó para almacenar en caché los análisis de plugins y normalizar las rutas de Windows; durante el periodo de v0.21.5, hermes_cli/plugin_compat.py no cambió y únicamente se eliminaron las entradas del manifiesto correspondientes al módulo Hindsight eliminado). Esta vía de escape dejará de funcionar en cuanto se incorpore esa reversión, porque las rutas anteriores desaparecerán. Solo se cubrieron los nombres públicos de nivel superior; los nombres privados y los puntos de integración para monkeypatch en pruebas nunca formaron parte de la superficie y no se restauraron.⁴²⁵³

Principios de diseño

De la página de arquitectura del proyecto original:³

Migración desde OpenClaw

Hermes Agent es el sucesor de OpenClaw. Si estás migrando desde una instalación existente de OpenClaw:⁶⁵

hermes claw migrate --dry-run                    # Preview what would be migrated
hermes claw migrate --preset full                # Full migration including API keys
hermes claw migrate --preset user-data --overwrite   # User data only, no secrets
hermes claw migrate --source /custom/path        # Non-default OpenClaw location

hermes claw migrate lee desde ~/.openclaw de forma predeterminada (también detecta automáticamente los directorios heredados ~/.clawdbot y ~/.moldbot) y escribe en ~/.hermes.⁶

Importado directamente (más de 30 categorías): SOUL.md, MEMORY.md, USER.md, AGENTS.md, skills de 4 directorios de origen, modelo predeterminado, proveedores personalizados, servidores MCP, tokens y listas de usuarios permitidos de plataformas de mensajería (Telegram, Discord, Slack, WhatsApp, Signal, Matrix, Mattermost), valores predeterminados del agente (esfuerzo de razonamiento, compresión, demora humana, zona horaria, sandbox), políticas de restablecimiento de sesiones (ahora inactivas: desde la versión v0.21.1, los temporizadores nunca rotan una conversación⁴³), reglas de aprobación, configuración de TTS, configuración del navegador, configuración de herramientas, tiempo de espera de ejecución, lista de comandos permitidos, configuración del gateway y claves API de 3 fuentes.⁶

Archivado para revisión manual: tareas cron, plugins, hooks/webhooks, backend de memoria (QMD), configuración del registro de skills, interfaz/identidad, registros, configuración multiagente, vinculaciones de canales, IDENTITY.md, TOOLS.md, HEARTBEAT.md, BOOTSTRAP.md.⁶

La resolución de claves API consulta tres fuentes en orden de prioridad: valores de configuración → ~/.openclaw/.env → auth-profiles.json.⁶

Solución de problemas

“No hay ningún proveedor de inferencia configurado. Ejecuta ‘hermes model’ para elegir un proveedor y un modelo”

Este es el primer error que aparece en toda instalación nueva: Hermes todavía no tiene un proveedor resuelto. Significa exactamente lo que indica: ninguna de las tres rutas de autenticación ha proporcionado un proveedor utilizable. Ejecuta:

hermes model

El selector interactivo te guía por todos los proveedores compatibles, incluidos los flujos de código de dispositivo de OAuth (Nous Portal, GitHub Copilot, Anthropic, OpenAI Codex) y los endpoints personalizados para servidores autohospedados. Si esperabas que ya hubiera un proveedor configurado, hermes doctor muestra qué credenciales puede ver realmente Hermes; las causas habituales son una clave API configurada en el lugar equivocado (debe estar en .env o establecerse mediante hermes config set, no en el perfil de tu shell), una credencial OAuth vencida en ~/.hermes/auth.json o un endpoint personalizado de config.yaml que perdió su base_url. Las rutas de autenticación se explican en detalle en Autenticación y proveedores.²⁷

“La clave API no está configurada”

Ejecuta hermes model para configurar tu proveedor de forma interactiva o hermes config set OPENROUTER_API_KEY your_key. El comando hermes doctor te indicará exactamente qué claves faltan.⁷

“Límite de contexto: 2048 tokens” al iniciar (modelos locales)

Hermes detecta automáticamente la longitud del contexto mediante el endpoint /v1/models de tu servidor, pero muchos servidores locales informan valores predeterminados bajos. Defínela explícitamente en config.yaml:²

model:
  default: your-model
  provider: custom
  base_url: http://localhost:11434/v1
  context_length: 32768

Las llamadas a herramientas aparecen como texto en lugar de ejecutarse

Tu servidor no tiene habilitadas las llamadas a herramientas o el modelo no las admite mediante la implementación del servidor.²

Las respuestas se interrumpen a mitad de una oración

Hay dos causas posibles:²

1. Límite de salida bajo (max_tokens) en el servidor: SGLang usa de forma predeterminada 128 tokens por respuesta. Configura --default-max-tokens en el servidor o define model.max_tokens en config.yaml.
2. Agotamiento del contexto: el modelo llenó su ventana de contexto. Aumenta model.context_length o habilita la compresión de contexto en Hermes.

“Conexión rechazada” desde WSL2 hacia un servidor de modelos alojado en Windows

WSL2 utiliza un adaptador de red virtual con su propia subred: localhost dentro de WSL2 se refiere a la máquina virtual Linux, no al host de Windows. Hay dos opciones:²

Red reflejada (Windows 11 22H2 o posterior): edita %USERPROFILE%\.wslconfig:

[wsl2]
networkingMode=mirrored

Después, ejecuta wsl --shutdown y reinicia. Ahora localhost funciona en ambas direcciones.

Alternativa mediante la IP del host (versiones anteriores de Windows): obtén la IP del host de Windows desde WSL2 y úsala en lugar de localhost:

ip route show | grep -i default | awk '{ print $3 }'
# Use that IP as the base_url host

También necesitas que el servidor de modelos se vincule a 0.0.0.0, no a 127.0.0.1: define OLLAMA_HOST=0.0.0.0 para Ollama, agrega --host 0.0.0.0 para llama-server/SGLang o habilita “Serve on Network” en LM Studio.²

El presupuesto de iteraciones ignora agent.max_turns

Si la línea de actividad muestra N/90 (u otro límite obsoleto) mientras config.yaml indica agent.max_turns: 500, la causa probable es una línea HERMES_MAX_ITERATIONS obsoleta en ~/.hermes/.env: antes, el asistente de configuración escribía el presupuesto en ambos lugares y, si el puente de inicio se interrumpe debido a un error previo al analizar la configuración, el valor residual de .env prevalece silenciosamente. Desde la versión v0.21.1, hermes doctor detecta este par conflictivo y hermes doctor --fix elimina la línea de .env, por lo que config.yaml queda como fuente de autoridad.⁴¹

¿Dónde está todo?

hermes status y hermes dump son tus aliados en este caso. hermes logs list muestra todos los archivos de registro con sus tamaños. hermes config path imprime la ubicación del archivo de configuración. hermes config env-path imprime la ubicación de .env.⁶

Preguntas frecuentes

¿Cuál es la diferencia entre Hermes Agent y Claude Code?

Claude Code es el CLI oficial de Anthropic, limitado a los modelos de Anthropic. Hermes Agent es un framework de agentes de código abierto de Nous Research que funciona con cualquier proveedor compatible con OpenAI: Nous Portal, OpenRouter, Anthropic, GitHub Copilot, z.ai, Kimi, MiniMax, DeepSeek, Hugging Face, Google o tu propio endpoint autoalojado.¹² Hermes también incluye un gateway de mensajería para Telegram/Discord/Slack/WhatsApp/Signal que Claude Code no tiene.

¿Puedo usar Hermes con una clave de API de Anthropic?

Sí. Hay 3 maneras:²

1. Configura ANTHROPIC_API_KEY en ~/.hermes/.env y ejecuta hermes chat --provider anthropic --model claude-sonnet-4-6
2. Ejecuta hermes model y selecciona Anthropic; Hermes usará el almacén de credenciales de Claude Code cuando esté disponible
3. Configura manualmente un ANTHROPIC_TOKEN (setup-token o token de OAuth) como alternativa

La opción 2 es la recomendada si ya usas Claude Code en la misma computadora, pues permite que las credenciales de Claude que se pueden renovar sigan siendo renovables.

¿Cómo cambio de proveedor sin perder mi conversación?

Usa /model provider:model dentro de una sesión. El historial de conversación, la memoria y los skills se conservan:⁹

/model zai:glm-5
/model openrouter:anthropic/claude-sonnet-4
/model custom:local:qwen-2.5

Configuré Anthropic, pero la visión, la web y la compresión no funcionan

En las versiones actuales, esto prácticamente ya no puede ocurrir como antes. De manera predeterminada (auxiliary.*.provider: "auto"), todas las tareas auxiliares —visión, clasificación de aprobaciones, compresión y títulos de sesiones— se ejecutan en tu modelo de chat principal, por lo que una configuración que solo usa Anthropic las atiende con el OAuth que ya tiene. El valor predeterminado anterior (Gemini Flash mediante OpenRouter → Nous → detección automática de Codex, con una degradación silenciosa cuando ninguno estaba configurado) desapareció: «Ahora, auto usa el modelo principal para todos, y las configuraciones específicas por tarea en config.yaml siguen teniendo prioridad».³⁴

Si una tarea auxiliar aún falla, busca una configuración específica por tarea que apunte a un proveedor que nunca configuraste (auxiliary.<task>.provider / .model en config.yaml) o claves heredadas obsoletas: desde la etiqueta v2026.8.31, el resumidor de compresión se configura como cualquier otro espacio auxiliar —auxiliary.compression.provider— y las claves heredadas compression.summary_* se migran allí automáticamente (versión 17 de la configuración).³¹ La extracción web ya no es en absoluto una tarea de LLM («no interviene ningún LLM»), por lo que, en las versiones actuales, un error al resumir contenido web no es un problema del modelo auxiliar.³⁴ Para vincular explícitamente una tarea de nuevo con tu proveedor principal:

auxiliary:
  vision:      { provider: "main" }
  compression: { provider: "main" }

¿Cuál es la diferencia entre SOUL.md y AGENTS.md?

SOUL.md define la identidad de tu agente: tono, estilo y preferencias predeterminadas de comunicación. Se encuentra en ~/.hermes/SOUL.md y te acompaña en todas partes. AGENTS.md es específico de cada proyecto —arquitectura, convenciones, comandos y rutas— y se encuentra en el directorio de tu proyecto.¹³ Si debe acompañarte en todas partes, corresponde a SOUL.md. Si pertenece a un proyecto, corresponde a AGENTS.md.

¿Cómo ejecuto varias instancias de Hermes en paralelo?

Con profiles. Cada profile obtiene su propio HERMES_HOME, configuración, memoria, sesiones y PID del gateway:⁶

hermes profile create work --clone
hermes profile use work                 # Sticky default
hermes -p work chat -q "..."            # One-off without switching
hermes profile alias work --name h-work # Wrapper script

¿Hermes admite LLMs locales?

Sí, mediante la ruta de endpoints personalizados. Hermes funciona con cualquier servidor compatible con OpenAI: Ollama, vLLM, SGLang, llama.cpp/llama-server, LM Studio, LocalAI, Jan o uno propio.² Consulta Endpoints personalizados y autoalojados para conocer la configuración de cada servidor.

¿Por qué el banner de inicio muestra menos herramientas de las que la guía afirma que tiene Hermes?

La guía cita 47 herramientas y 20 toolsets del registro de arquitectura del proyecto original: esa es la cantidad total de herramientas cuyo código fuente incluye Hermes en todos los toolsets. Tu instalación en ejecución muestra una cantidad menor en el banner (la instalación de referencia utilizada para esta guía informa 28 herramientas) porque Hermes solo activa el conjunto predeterminado de toolsets al iniciarse. Muchos toolsets son opcionales: los adaptadores del gateway de mensajería, la automatización del navegador, los sistemas más pesados de extracción web y varias integraciones especializadas deben incluirse explícitamente en toolsets: dentro de ~/.hermes/config.yaml para que se carguen. Total del registro = «lo que está disponible si lo activas». Total del banner = «lo que realmente cargó tu profile actual». Usa hermes tools --list para ver qué toolsets están activos y cuáles están disponibles, pero desactivados. Activa o desactiva toolsets individuales durante la ejecución con /tools enable <name> y /tools disable <name> (desactivarlos reinicia la sesión para que el agente reconstruya su manifiesto de herramientas con la nueva estructura).

¿Cómo gestiona Hermes el modelo de respaldo cuando falla mi proveedor principal?

Configura un bloque fallback_model en config.yaml:²

fallback_model:
  provider: openrouter
  model: anthropic/claude-sonnet-4

Cuando el proveedor principal falla (por límite de solicitudes, error del servidor o fallo de autenticación), Hermes cambia al modelo de respaldo durante la sesión sin perder el historial de conversación. Esto ocurre como máximo una vez por sesión.

¿Puede el agente mejorar sus propios skills con el tiempo?

Sí; esa es la parte «automejorable» de Hermes Agent. El agente puede crear, actualizar y eliminar skills mediante la herramienta skill_manage. Cuando descubre un flujo de trabajo no trivial, guarda el método como un skill para reutilizarlo en el futuro.¹¹ El agente crea skills después de tareas complejas (más de 5 llamadas a herramientas), cuando encuentra errores y descubre el procedimiento que funciona, cuando corriges su enfoque o cuando descubre un flujo de trabajo no trivial.

¿Existe una integración con IDE?

Sí; Hermes puede ejecutarse como servidor ACP (Agent Client Protocol) para VS Code, Zed y JetBrains:⁶

pip install -e '.[acp]'
hermes acp

Registro de cambios