Hermes Agent: La referencia para profesionales (2026)

TL;DR: Hermes Agent es un agente de IA de código abierto y mejora continua desarrollado por Nous Research. Funciona como CLI y como gateway de mensajería multiplataforma, almacena en disco una identidad duradera y memoria persistente, reúne skills que mejoran con el uso y funciona 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.¹²¹⁹ A partir de la versión v0.14.0 (16 de mayo de 2026), Hermes incorpora SuperGrok OAuth con grok-4.3 y un contexto de 1 millón de tokens, un proxy local compatible con OpenAI para proveedores de OAuth (hermes proxy), compatibilidad nativa con x_search, instalación desde PyPI (obsoleta desde la versión v0.19.0; el instalador de una sola línea es la vía recomendada), instalación diferida de dependencias, 28 plataformas de mensajería —incluidas LINE y SimpleX Chat—, /handoff, diagnósticos semánticos de LSP después de cada escritura, una herramienta video_generate unificada, computer_use mediante cua-driver para proveedores distintos de Anthropic, una versión beta nativa para Windows y el cierre de 12 incidencias P0 y 50 P1.¹⁹ Para la mayoría de los usuarios nuevos, lo más difícil es la autenticación con el proveedor: Hermes incluye 39 proveedores en su lista estática de selección en la etiqueta v2026.9.7 y amplía automáticamente esa lista mediante 39 complementos de proveedores incluidos, además de endpoints personalizados y tres métodos de autenticación distintos (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 simple interfaz de chat. Lee tu sistema de archivos, ejecuta comandos en backends aislados, extrae información de la web, genera 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 dirige 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 tu capacidad:

1. Resolución de proveedores: cómo se traducen los flujos de autenticación en llamadas a 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 vida, no solo donde te encuentras

Puntos clave

• La autenticación del proveedor tiene tres vías, no una. Clave de API en .env, OAuth mediante hermes model/hermes auth o un endpoint personalizado en config.yaml. Elige la vía que corresponda a 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, y /model provider:model te permite cambiar durante una sesión sin perder el historial.²
• Dos archivos conforman la superficie de configuración editable por 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 se ejecutan con tu modelo principal. La visión, la clasificación de aprobaciones, la compresión y los títulos de las sesiones se ejecutan como llamadas «auxiliares» independientes a LLM, y en la etiqueta auto todas se dirigen a tu modelo de chat principal. No necesitas configurar nada, pero estas tareas secundarias pueden generar costos considerables con modelos de razonamiento caros. Cuando esto importe, asigna modelos rápidos y económicos a cada espacio auxiliary.<task>.⁴³⁴

Qué cambia en v0.14

v0.14.0 no se centra tanto en una función destacada como en reducir las dificultades de configuración y ampliar los entornos donde puede ejecutarse Hermes.¹⁹ Estos son los principales cambios operativos:

• La instalación y el inicio son más ligeros. pip install hermes-agent permite instalarlo desde PyPI, los adaptadores pesados se instalan de forma diferida cuando se usan por primera vez y la ruta de inicio pospone suficiente trabajo como para reducir el arranque en frío unos 19 segundos. (Desde entonces, v0.19.0 declaró obsoletas las instalaciones mediante pip; consulta Instalación.)
• Las suscripciones pueden convertirse en endpoints locales de API. hermes proxy transforma proveedores basados en OAuth, como Claude Pro, ChatGPT Pro y SuperGrok, en un endpoint local compatible con OpenAI para herramientas como Codex, Aider, Cline y Continue.
• El alcance del gateway se amplía. 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 principio a fin, la recuperación del historial de Discord está activada de forma predeterminada y las solicitudes clarify de Telegram/Discord ahora utilizan botones nativos.
• Mejora la verificación durante la escritura. Después de realizar modificaciones, Hermes puede mostrar en cada turno resúmenes 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 con agentes basado en evidencia.
• Se amplían las herramientas de escritorio y contenido multimedia. computer_use funciona mediante cua-driver con proveedores distintos de Anthropic, video_generate se unifica tras backends intercambiables y vision_analyze envía los píxeles sin procesar a modelos que realmente pueden verlos.

Todas las secciones siguientes se basan en la documentación oficial 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 oficial específica de la que procede.

Elige tu ruta

Cómo funciona Hermes: el modelo mental

Hermes se estructura en torno a un único bucle 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 de las herramientas mediante agent/prompt_builder.py (la reorganización de septiembre de 2026 lo trasladó al nuevo paquete agent/)³
2. Resuelve el proveedor de ejecución mediante runtime_provider.py; en este paso se seleccionan la autenticación, la URL base y el modo de API³
3. Llama al proveedor mediante uno de estos tres modos de API: chat_completions, codex_responses o anthropic_messages³
4. Procesa todas 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³

Comprender este bucle es importante porque cada función —personalidades, memoria, skills, compresión y respaldo— se conecta con una de estas etapas. Cuando leas una clave de configuración y te preguntes qué hace, la respuesta suele ser: «es un ajuste de la etapa 1, 2, 3 o 4 del bucle anterior».

Núcleo independiente de la plataforma. Una sola clase AIAgent sirve para la CLI, el gateway, ACP, la ejecución por lotes y el servidor API. Las diferencias entre plataformas se encuentran en el punto de entrada, no en el propio agente.³ Por eso los mismos comandos slash 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; ninguna se superpone con otra. Si buscas «dónde almacena Hermes X», está en uno de ellos.

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 seleccionado al que venía remitiendo toda la serie acumulativa 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 completamente documentados aquí». El planteamiento continúa la historia del Heraldo: «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 en el mismo punto.

• Bot Mode: tus agentes se convierten en una sociedad integrada. Bot Mode pasa de ser el plugin hermes-bots incluido durante el periodo de v0.20.3 a formar parte de la aplicación de escritorio y estar activado de forma predeterminada. Cada profile de agente recibe un nombre, un rostro de avatar determinista con controles para generarlo al azar o bloquearlo, y un lugar en una lista compartida; puedes crear chats grupales al estilo de Discord donde tú y varios bots conversan en una misma sala, mencionar con @ a cualquier bot desde el editor y asignar nombres e imágenes a las salas. El catálogo secundario incluye tarjetas de mensajes entre agentes con atribución, avisos de entrega para el remitente, hidratación con renderizado prioritario para activaciones 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, “multiagente” significaba infraestructura; ahora parece una aplicación de chat llena de compañeros de trabajo».³⁵
• hermes peer: mensajes directos de bot a bot entre tus agentes. Cualquier agente Hermes puede enviar mensajes a cualquier otro mediante su identificador, entre distintos profiles y gateways, desde la CLI o dentro de 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 allí donde estés. «Las respuestas llegan al Bot Chat canónico de cada agente, por lo que las conversaciones entre agentes son persistentes e inspeccionables, en lugar de enviarse y olvidarse». El comando hermes peer (agregar, enumerar o eliminar peers; dm) aparece en la tabla de comandos de nivel superior.³⁵
• Tareas cron que recuerdan. Las tareas programadas dejan de tener memoria de pez: los agentes cron cargan y actualizan memoria persistente como cualquier otro agente; continuity=true incorpora el resultado de cada ejecución en la siguiente, de modo que un monitor pueda evitar duplicar información que ya haya comunicado; cada tarea recibe un bloc de notas persistente; las tareas en modo monitor omiten por completo la LLM cuando no hay cambios; el esfuerzo de razonamiento puede fijarse por tarea; y el resultado 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 @ de cada una.³⁵³⁷
• Orquestación de subagentes en tiempo real. delegate_task incorpora acciones de control: enumerar los agentes secundarios en ejecución, orientar a uno sobre la marcha mediante una corrección de rumbo o detenerlo antes de tiempo y conservar el resultado parcial. Los resultados de los agentes secundarios pueden validarse con un esquema JSON, el costo de cada delegación se muestra en los resultados 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 mando de MCP. Los servidores MCP y el catálogo se combinan en una única página de escritorio con importación mediante «pegar cualquier cosa» al arrastrar contenido, comprobaciones de estado en segundo plano que te avisan para que vuelvas a autenticarte antes de que falle una llamada a una herramienta, una superposición de costos y uso de toda la flota (estimaciones de tokens de esquema y uso de cada servidor durante 30 días) y enlaces profundos hermes:// que instalan un servidor MCP con confirmación explícita. Consulta Integración de 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 context, 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 individuales para cada campo. También se incorporan una detención de emergencia global, la opción de fijar o liberar sesiones, textos de ejemplo rotativos en el editor y mascotas para la terminal. Una aclaración sobre el nombre: la versión anuncia un verificador de aprobaciones de prueba como hermes approval-check; en esta etiqueta, esa función es hermes approvals test y 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 navega, hace clic y lee directamente su contenido, y las páginas pueden abrirse en el navegador del sistema con menús contextuales completos para los enlaces.³⁵
• Seis proveedores nuevos y una oleada de incorporaciones al 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 completa 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 gratuito, 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 context 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 protección de selección advierte 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, para impedir que un agente víctima de una inyección de instrucciones reescriba silenciosamente sus propias órdenes permanentes; una revisión exhaustiva de ocultación de datos cierra las brechas de filtración de secretos en errores de terminal, lecturas de .env, checkpoints y registros ACP; el sistema de aprobación aprende a reconocer comandos destructivos de Windows; los permisos concedidos en macOS sobreviven a las actualizaciones gracias a una identidad estable de firma TCC (hermes desktop --setup-tcc-identity); y la entrada de Blender en el catálogo de MCP, junto con su skill, se eliminó tras una vulneración del proyecto original. Consulta Refuerzo de la seguridad para conocer los detalles correspondientes a esta etiqueta.³⁵³⁹
• Maduración del gateway. Slack recibe tarjetas dinámicas nativas (respuestas transmitidas realmente en tiempo real y tarjetas opcionales de planes y tareas), además de la supresión de vistas previas de enlaces salientes; Telegram incorpora un selector integrado que permite buscar todos los comandos y skills mediante @botname, eludiendo el límite del menú de comandos de Telegram; la vía de retransmisión madura (inicialización nativa de plugins, operaciones con tarjetas dinámicas y 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 a los consumidores de la flota consultarlo y a los actualizadores pausarlo de forma ordenada en vez de terminar todo el árbol de procesos; y el recolector de turnos captura las pilas de los procesos de trabajo bloqueados cuando se activa el monitor 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, 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.³⁵

Cambios revertidos durante este periodo (no se incluyen): tanto el modo Model Council (/council) como el context engine DCP se incorporaron y posteriormente se revirtieron; el servidor del gateway exclusivo para WS (#94245) se fusionó y luego se revirtió (#96118), por lo que FastAPI permanece en la ruta de inicio de la aplicación de escritorio, pero la repetición de eventos con sellos 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 alguna cobertura de la comunidad sobre los periodos de v0.20.x mencionó cualquiera 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 situada más abajo, bajo la versión del Heraldo, sigue siendo el registro por etiqueta que indica qué se incorporó en cada periodo.³⁵

Novedades de v0.21.1 (el parche acumulativo)

Hermes Agent v0.21.1 (etiqueta v2026.9.7, 7 de septiembre de 2026) es la versión actual y su publicación es deliberadamente escueta: un «parche» que «acumula el estado actual de la rama main desde v0.21.0 para las implementaciones basadas en etiquetas y los consumidores posteriores». El cuerpo presenta las estadísticas del período —«5.139 confirmaciones sin fusión en 4.364 archivos modificados (+601.014 / -768.419)» y «632 PR fusionadas»— y después aplaza el relato: «Las notas de la versión completas y seleccionadas para este período se publicarán con v0.22.0». Esto lo convierte en el período entre etiquetas más grande de la historia del proyecto (ningún período 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 aporte el registro seleccionado, los seis grupos siguientes describen los cambios que afectan la forma en que utilizas Hermes con esta etiqueta, todos verificados 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 y siete subpaquetes; prompt_builder.py ahora se encuentra en agent/prompt_builder.py, mientras que run_agent.py sigue siendo el hogar de AIAgent), los analizadores de subcomandos de 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ó: conserva 39 entradas estáticas y continúa ampliándose automáticamente a partir de los 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 archivo COMPAT_MANIFEST.md en la raíz del repositorio vuelve a exportar 1.148 nombres públicos «moved-lazy» desde sus rutas de módulo anteriores; cada uno emite una advertencia HermesPluginCompatWarning una vez por nombre y proceso cuando se resuelve. La capa de compatibilidad es temporal y se elimina el 14 de septiembre de 2026, seis días después de la etiqueta. A partir de esa fecha, los plugins de terceros afectados no se cargan: el banner de CLI, hermes doctor y hermes update muestran un aviso rojo que identifica el plugin deshabilitado; la aplicación de escritorio presenta un cuadro de diálogo una sola vez; y hermes plugins list indica el motivo. Si utilizas plugins externos, revísalos ahora: hermes plugins compat <path> muestra cada file:line con la ruta anterior -> la ruta nueva y devuelve el código de salida 1 mientras quede algún caso pendiente (--json genera una salida legible por máquinas; ejecútalo sin argumentos para analizar todos los plugins instalados). La vía de escape para un plugin cuyo autor aún no se haya puesto al día es plugins.allow_deprecated_imports: true en config.yaml, lo que permite que los plugins afectados sigan cargándose después de la fecha hasta que la reversión de la confirmación de compatibilidad elimine realmente las rutas anteriores. La sección Sistema de plugins incluye el mismo recuadro.⁴²
• Las conversaciones del gateway ya no rotan mediante temporizadores, bajo ninguna circunstancia. 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 del contexto continúa administrando los historiales extensos. La configuración heredada de temporizadores se ignora. El tipo de datos SessionResetPolicy existente contiene datos de compatibilidad inertes, no una política de tiempo de ejecución». Los límites son explícitos y los determina el usuario; si conservaste temporizadores de restablecimiento de sesiones 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> recibe --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 máquinas 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. Este período también 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 dañadas de metadatos de OAuth se ignoran en lugar 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 cuáles servidores MCP configurados llegan a iniciarse, por lo que una ejecución puntual de hermes -z -t <toolsets> evita el arranque en frío de servidores que no necesita. El bloque de comandos de Integración con MCP ahora incluye login y reauth [--all]; ambos son anteriores a este período, pero todavía no se habían documentado aquí.⁴⁴
• La delegación ahora refleja con franqueza el trabajo en segundo plano. Se incorporaron seis mejoras de confiabilidad en delegate_task, todas obtenidas del 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 notificación de 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 intencional: el código fuente señala que una ráfaga de notificaciones por tarea «fragmentaba a los orquestadores que no tenían un plan para ello». (2) Los procesos en segundo plano de un agente hijo se detienen durante su desmantelamiento, salvo que este los entregue al agente padre mediante process_manage(action="handoff"); los procesos restantes que no se hayan entregado aparecen en el resultado como orphaned_processes, y aquellos procesos del agente hijo que hayan terminado sin que nadie los leyera se muestran como unread_completions, junto con el final de su salida. La postura de diseño, según la cadena de documentación del código fuente, es que el agente padre «debe recibir esa información del entorno de ejecución» en lugar de confiar en que el hijo afirme que hay un «monitor en ejecución». (3) delegation.fallback_providers se convierte en una verdadera opción de configuración: null hereda la cadena del agente padre para los hijos sin fijar, [] desactiva la alternativa y un hijo fijado por proveedor, endpoint o modelo no recibe ninguna alternativa, salvo que esta opción declare una. (4) La cadena de alternativas del agente hijo se resuelve mediante el normalizador canónico, de modo que las entradas mal formadas se descartan en lugar de impedir la creación del agente. (5) Una falla a mitad de una unidad ya no hace que se pierdan los agentes hijos que terminaron: cada hijo finalizado de una unidad con varios agentes se registra de manera persistente en la propia fila de la unidad y se conserva como resultado parcial al realizar la recuperación. (6) Los subagentes nunca heredan el nivel de caché de instrucciones de 1 hora: un hijo delegado se reduce al nivel de 5 minutos, porque el nivel de 1 h tiene un precio pensado para una persona que se ausenta, no para una ráfaga de agentes hijos en paralelo.⁴⁵
• Proveedores y modelos. Los catálogos incorporan GPT-6 Astra y Astra Pro de OpenAI con variantes de nivel de velocidad -fast/-flex («precio 2 veces mayor, nivel prioritario» / «precio 0,5 veces menor, nivel flex») en los catálogos de Nous Portal y OpenRouter. En la ruta OAuth de ChatGPT/Codex, Astra está sujeto a la cuenta (solo el descubrimiento activo específico de la cuenta puede anunciarlo) y recibe una variante opcional -900k en el selector, que eleva la ventana anunciada de 272K a unas 900K verificadas en vivo; el sufijo nunca se transmite. También se incorporan 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 llega como backend de búsqueda y extracción web (TAVILY_API_KEY; funciona sin clave cuando se selecciona Tavily 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 solo llama-server supervisado y configuración con un clic desde la aplicación de escritorio), mientras que los proveedores de procesos externos ajenos al repositorio obtienen 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: 20; la clave heredada ttl_hours solo se respeta cuando el usuario la configuró 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» pasa el lote al editor con una captura de pantalla recortada por cada marcador, y cada comentario sobre un elemento incluye su selector CSS, su marcado y los estilos calculados relevantes para el diseño, de modo que el agente pueda encontrar 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 unas cuantas unidades de trabajo que normalmente afectan archivos distintos; esto permite distribuirlas de forma segura entre trabajadores paralelos. A su alrededor se suman controles estructurados de sesión y de automatización de sesiones, la creación de sesiones mediante arrastre, una vista de importación de sesiones para transcripciones de agentes de programación externos, display.resume_last_session (valor predeterminado: true; al iniciarse en frío, vuelve a abrir el último chat o la última 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 interfaz de escritorio en ruso (los 17 catálogos de configuraciones regionales de CLI no cambiaron).⁴⁷

El proceso de actualización no cambia: hermes update desde una instalación existente o el instalador de shell para instalaciones nuevas. A v0.22.0 le corresponderá presentar el registro seleccionado de este período; los grupos anteriores describen lo que cambia en esta etiqueta.⁴¹

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; v0.20.1 (13 de agosto) y v0.20.2 (16 de agosto) son etiquetas de estabilización basadas en ella, 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 esta serie de consolidaciones, cada una con su propio conjunto de nuevas funciones; consulta la subsección siguiente. El periodo 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 tienes una instalación mediante pip o brew, ese canal ya no recibe nuevas versiones.⁴⁹
• El límite predeterminado de iteraciones para llamar herramientas aumentó de 90 a 500. Las ejecuciones autónomas prolongadas dejaron de chocar con un límite artificial, y todos los umbrales de presión del presupuesto que aparecen más adelante se calculan a partir del nuevo límite. read_file también usa ahora un valor predeterminado de 2.000 líneas 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 n.º 514.⁴⁹
• Webhooks salientes firmados. Antes, hermes webhook solo aceptaba comunicaciones entrantes; v0.20.0 incorpora webhooks salientes del ciclo de vida firmados con HMAC para eventos de sesiones, turnos 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 de inmediato un comando de shell 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 resultados y permite recuperar las líneas ocultas; Ctrl+S guarda temporalmente un prompt a medio escribir. hermes import-agent migra una configuración de Claude Code o Codex CLI con un solo comando.⁴⁹
• Incorporaciones a la gestión de secretos. Una fuente de secretos mediante un comando auxiliar que puede combinarse con cualquier bóveda, rotación de tokens con un solo comando y errores de inicio que indican cómo actuar, una caché cifrada opcional para acceso de emergencia a Bitwarden, claves inyectadas desde la bóveda y limitadas al directorio principal de cada profile, y paridad de SecretRef ${env:VAR} entre config.yaml y la configuración de MCP. El modelo de autenticación con tres rutas que se explica más adelante no cambió.⁴⁹
• Inicio en caliente más rápido. El inicio en frío de hermes -w se redujo de aproximadamente 14 s a 1,8 s.⁴⁹
• La aplicación de escritorio se convirtió en una plataforma. Artifacts con tarjetas versionadas y vista previa dinámica en un entorno aislado, un Plugin SDK con Kanban como plugin inaugural para la aplicación de escritorio, un atajo global para entrada rápida, varias ventanas de GUI, modo de backend remoto de 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 (del 17 al 27 de agosto)

Tras v0.20.0, el proyecto adoptó una cadencia de consolidaciones etiquetadas frecuentes que aportaron más que estabilización. Las cuatro pospusieron sus notas seleccionadas de la misma manera: cada una indicaba que «full curated release notes for this window will ship with v0.21.0», y v0.21.0 ya las publicó: 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 registro contemporáneo de cada etiqueta: muestran qué se incorporó en cada una, mientras que las notas seleccionadas las agrupan.^48233035

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

• Migración de SDK a MCP 2.x, con compatibilidad para 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 plugin incluido (hermes-bots) e 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 controlar computadoras, además de mejoras en la propiedad del entorno de ejecución de subprocesos de Python (aislamiento de PYTHONHOME/PYTHONPATH).⁴⁸
• Fiabilidad: recuperación automática del programador cron (recuperación ante EMFILE, conciliación de asignaciones obsoletas y reactivación de tareas bloqueadas), correcciones de pérdida de datos al transferir sesiones, recuperación automática de la conexión con el gateway remoto de la aplicación de escritorio y una oleada de adaptaciones del ecosistema (análisis de seguridad al instalar plugins, /worktree, conservació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 cristal de la aplicación de escritorio: mejoras de cristal mate y translucidez, con un selector de escarcha y selección previa en macOS.⁴⁸
• Una barra lateral con pestañas SESSIONS|BOTS, con la opción de ocultar o mostrar cada bot, además de correcciones para los chats grupales de Bot Mode (turnos prolongados de los participantes, renderizado de Markdown y enrutamiento entre distintas máquinas).⁴⁸
• Análisis consultivo NVIDIA SkillEvaluator Tier 1 al instalar skills: las comprobaciones de licencia y seguridad se ejecutan cuando instalas un skill.⁴⁸
• Mejoras en el envío de contenido multimedia mediante cron (tiempo de espera configurable, archivos adjuntos en ejecuciones manuales y notificación de activaciones omitidas), correcciones de SessionDB relacionadas con el hilo del bucle de eventos y la contención, información transparente sobre ramas apartadas en hermes update 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 entre 5 proveedores con conmutación por error en anillo.²³
• Una oleada de mejoras de CLI: selector difuso de /model, una paleta de comandos con Ctrl+P y un /status más completo.²³
• Bot Mode alcanza la madurez: hilos en salas grupales, resúmenes plegables de conversaciones, avatares con rostros amorfos y archivos PDF u otros archivos adjuntos 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 «Show the update plan and exit without changing anything») y hermes worktree list/prune.²³²⁷
• Las tareas cron incorporan memoria persistente y un nivel de razonamiento configurable por tarea, además de medidas de disciplina de ejecución y protecciones contra bloqueos del entorno de ejecución basadas en los hallazgos de la evaluación de Composio, aclaraciones con varias preguntas, el proveedor sin autenticación y sin opencode, y mejoras de rendimiento en la aplicación de escritorio (hidratación de Bot Mode que prioriza 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 intervalo en unos 1.313 commits distribuidos entre aproximadamente 1.557 archivos (+177.113/−21.682), con cerca de 525 PR fusionadas.³⁰ Estos son los elementos destacados de esa descripción:

• Navegación con perfiles reales sujeta a consentimiento: la navegación local puede usar tu profile predeterminado de Chromium, con un flujo para cerrar el navegador en Windows previa aprobación.³⁰
• El navegador de la aplicación de escritorio obtiene su propia ventana del sistema operativo, además de un motor administrado de actualizaciones remotas de SSH y una barra lateral para 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 de acceso al llavero de macOS en cada inicio.³⁰
• Nuevos modelos en los selectores: GLM-5.3-Flash, MiniMax M3 gratuito y MiniMax H3 Max para video.³⁰
• Caché de resultados con TTL para web_search/web_extract y tool_search con varias consultas y derivación de palabras.³⁰
• La compresión lean-tail ahora es la opción predeterminada: la sección Compresión del contexto, más adelante, documenta la configuración correspondiente a esta etiqueta.³⁰³¹
• Los backends de terminal ahora admiten plugins: consulta Backends de terminal.³⁰³²
• Transparencia en las actualizaciones y las flotas: los actualizadores pausan los gateways mediante el socket de control en lugar de finalizar todos sus árboles de procesos, y las instalaciones administradas mediante imágenes o paquetes rechazan las actualizaciones locales que no sean seguras.³⁰
• Confirmaciones persistentes de incidencias de cron con errores más claros por diferencias entre versiones del código, controles para el despliegue automático de vistas previas de enlaces en Slack e identidades de contenedor de Docker compartidas.³⁰

El proceso de actualización no cambió: usa 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) debe su nombre a la velocidad del propio 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. En torno a ese eje se incorporan la gestión de la 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 desde v0.18.0 es el de mayor actividad del proyecto hasta la fecha: alrededor de 2.245 commits, 1.065 PR fusionadas, 3.300 incidencias cerradas y más de 450 colaboradores de la comunidad.⁵⁰

• Primer token aproximadamente un 80 % más rápido en todas partes. El tiempo en frío desde el envío hasta el despacho bajó de unos 4,3 s a 0,9 s en CLI, gateway, TUI, escritorio y cron por igual: la detección de capacidades de Discord se retiró 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 tareas bloqueantes de la inicialización del agente. La latencia percibida también recibió mejoras específicas: los modelos de razonamiento ahora transmiten su proceso de pensamiento 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 escritorio y TUI. La aplicación de escritorio recibió una optimización de velocidad de unas 20 PR: consumo de CPU 14 veces menor en el divisor de Markdown transmitido gracias al análisis léxico incremental por bloques, diferencias virtualizadas en el panel de revisión, cambios ágiles entre sesiones con transcripciones extensas y eliminación de los renderizados por token de la barra lateral y las filas de herramientas. La TUI ahora renderiza el Markdown transmitido de forma incremental por bloque.⁵⁰
• Las instalaciones mediante pip y Homebrew están obsoletas. Ambas vías se marcaron como instalaciones «heredadas no compatibles», con planes para eliminarlas. Esa eliminación ya se produjo en v0.20.0: los canales de brew y los paquetes wheel de pip/PyPI se retiraron, por lo que el instalador de shell, Docker y Nix son ahora 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 varias bóvedas al mismo tiempo y ofrece precedencia determinista, advertencias de conflictos y procedencia por variable; las claves de API ya no tienen que almacenarse en un archivo .env de texto sin formato. Los futuros proveedores de bóvedas podrán incorporarse como plugins.⁵⁰
• Las aprobaciones inteligentes son ahora la opción predeterminada. Cuando Hermes quiere ejecutar un comando marcado, un revisor independiente de LLM lo evalúa en lugar de pedirte autorización para cada comando, y cada veredicto se aplica únicamente a 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 instancia de aprobación humana.⁵⁰
• Facturación desde la terminal: /subscription y /topup. Administra tu plan de Nous Portal sin salir de la terminal: consulta el plan y la asignación restante, previsualiza el costo exacto de una mejora o cuándo entrará en vigor una reducción del plan, y aplícala con posibilidad de deshacerla. La aplicación de escritorio incorpora una pestaña equivalente de configuración de facturación.⁵⁰
• Observa cómo trabajan los subagentes y nunca pierdas una respuesta terminada. Los despachos de delegate_task devuelven archivos de transcripción en vivo que puedes seguir con tail -f en cuanto se inician los subagentes: cada llamada a una herramienta, resultado y respuesta transmitida queda registrada en un archivo legible por personas para cada agente secundario. Las finalizaciones de delegaciones en segundo plano persisten entre reinicios, y las respuestas finales del gateway se registran en un libro mayor de obligaciones de entrega dentro de state.db; si el gateway falla durante el envío, se vuelven a entregar en el siguiente arranque. 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 gremios, canales o hilos específicos a diferentes profiles, cada uno con configuración, skills, memoria y secretos completamente aislados, mediante una opción de reemplazo GATEWAY_MULTIPLEX_PROFILES. El índice de enrutamiento se trasladó a state.db; sessions.json es ahora un reflejo heredado opcional.⁵⁰
• Oleada de proveedores y modelos. Fireworks AI obtiene compatibilidad de primer nivel (estimación de costos y puesto n.º 2 en el selector de proveedores), junto con DeepInfra y Upstage Solar. Los catálogos incorporan GPT-5.6 (Sol/Terra/Luna + Pro, con integración completa), grok-4.5 (disponibilidad general), 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 de /model y del proceso de resolución.⁵⁰
• El esfuerzo de razonamiento se convierte en un control ajustable. Se incorporan los nuevos niveles de esfuerzo max y ultra en todas las interfaces, con opciones de reemplazo por modelo en la configuración, esfuerzo por posición en los ajustes predefinidos de MoA (los asesores razonan a fondo mientras el sintetizador se mantiene rápido), esfuerzo por tarea para los modelos auxiliares y un comando /reasoning limitado a la sesión en CLI.⁵⁰
• Superficie de CLI y MCP. hermes sessions export genera formatos Markdown, Quarto, HTML, solo prompt y trazas de Hugging Face, con una limpieza opcional mediante --redact; /model --once permite reemplazar el modelo durante un turno; las invocaciones de skills mediante comandos de barra 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 nomenclatura mcp__server__tool.⁵⁰

Si actualizas desde v0.18.x, hay dos cambios que merecen atención antes que cualquier otro: una instalación mediante pip o Homebrew ahora muestra una advertencia que la identifica como heredada y no compatible (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 evita perder las respuestas terminadas en caso de fallo.

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

Hermes Agent v0.18.0 (etiqueta v2026.7.1, 1 de julio de 2026) debe su nombre al juicio: el agente verifica su propio trabajo en lugar de afirmar que tuvo éxito, con un razonamiento en conjunto que realmente puedes inspeccionar. También resuelve toda la lista de pendientes P0/P1: unos 692 elementos de máxima prioridad solucionados en doce días.²²

• Mixture-of-Agents como modelo de primer nivel. MoA ahora se puede seleccionar como cualquier otro modelo en todas las interfaces, y el razonamiento en conjunto es visible: el resultado completo de cada modelo de referencia se muestra en su propio bloque etiquetado, con transmisión de la respuesta 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 vez de limitarse a afirmar que tuvo éxito: aplica el juicio sobre sí mismo.²²
• /learn: describe cualquier cosa para convertirla en un skill. Convierte un flujo de trabajo en un skill reutilizable con solo describirlo; los skills generados cumplen automáticamente las convenciones del archivo CONTRIBUTING.md del repositorio.²²
• Línea de tiempo de /journey. Un historial visual de la memoria y los 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.²²
• Distribución paralela de subagentes en segundo plano. Delega varias tareas que se ejecutan simultáneamente 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 de organización por proyecto, repositorio y línea de trabajo.²²
• Gateway con reducción a cero. Los gateways pueden permanecer inactivos cuando no se usan y coordinar su drenaje para permitir implementaciones sin interrupciones, algo importante para quienes ejecutan Hermes como un servicio permanente.²²
• Compatibilidad con Google Vertex AI. Acceso a Gemini mediante cuentas de servicio de GCP con actualización automática de tokens OAuth2, que se incorpora al catálogo de proveedores.²²
• Comando de edición /prompt. Abre $EDITOR para redactar prompts de varias líneas, en lugar de obligarte a lidiar con la línea de entrada.²²

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

Novedades de v0.17.0 (The Reach Release)

Hermes Agent v0.17.0 (etiqueta v2026.6.19, 19 de junio de 2026) debe su nombre al alcance que ahora tiene el agente: nuevos canales de mensajería, nuevos proveedores de modelos y un control más profundo del escritorio y el dashboard. Es una ampliación de v0.16.x; la interfaz CLI no ha cambiado.²¹

• Nuevos canales de mensajería. iMessage ahora funciona sin un Mac como relay 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 usar un proceso bridge; SimpleX incorpora grupos, archivos adjuntos nativos, procesamiento de texto por lotes 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 de razonamiento moderno (nunca envían un campo reasoning).²¹
• Escritorio y dashboard. 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 de Composer, atajos de teclado reasignables, notificaciones nativas del sistema operativo, borradores del editor por hilo, temas de VS Code Marketplace e interfaz en japonés y chino tradicional. El dashboard incorpora un generador de profiles completo (modelos, skills y MCPs sin editar config.yaml), un selector global de profile, un Skills Hub renovado con análisis de seguridad, Automation Blueprints (plantillas parametrizadas disponibles mediante formularios, comandos slash, conversaciones y documentación) y un inicio de sesión seguro que devuelve un error 401 detrás de la barrera de OAuth.²¹
• Skills y herramientas. image_generate ahora puede editar y transformar una imagen de origen, además de crear una desde cero, con todos los proveedores de imágenes compatibles; la herramienta memory incorporó 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 Chesterton’s Fence; y el booleano write_approval sustituye al write_mode de tres estados.²¹
• Arquitectura. Los subagentes en segundo plano devuelven de inmediato un identificador y reintroducen sus resultados como un nuevo turno; un controlador de solicitudes de MCP permite confirmar acciones durante una llamada a una herramienta, mientras que las herramientas de MCP que se conectan con retraso quedan disponibles entre turnos sin comprometer la caché; cron se convierte en un CronScheduler conectable con Chronos como proveedor administrado de cron; 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 relay Gateway-Gateway para topologías con varios gateway.²¹
• Nuevos comandos. /version, /billing (facturación interactiva desde la terminal), hermes photon login (autenticación de iMessage) y hermes curator run --consolidate; la consolidación ahora es opcional, por lo que la curaduría rutinaria en segundo plano no consume tokens.²¹
• Seguridad. v0.17.0 corrige una evasión de la lista de denegación mediante secuencias de escape del shell, adopta un comportamiento cerrado y seguro cuando faltan módulos de aprobación o adaptadores de 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 filtración y actualiza urllib3 y PyJWT para corregir vulnerabilidades CVE.²¹

Si estás actualizando desde v0.16.x, nada de esto rompe la CLI; se trata de nuevos canales, modelos e interfaces alrededor del mismo agente. iMessage sin relay, los adaptadores oficiales de WhatsApp y el ámbito Managed para administradores son las principales razones para actualizar.

Novedades de v0.16.0 (The Surface Release)

Hermes Agent v0.16.0 (etiqueta v2026.6.5, 5 de junio de 2026) debe su nombre a las nuevas interfaces que ofrece para un agente centrado en la CLI. La gran novedad es que Hermes ya no se limita 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 solo clic y actualización automática dentro de la aplicación. Ofrece una ventana de chat con transmisión en tiempo real, archivos que puedes 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 Hermes gateway remoto mediante una WebSocket segura, con autenticación por OAuth o nombre de usuario y contraseña, hosts remotos específicos para cada profile y sesiones simultáneas de varios profiles enlazadas mediante referencias @session entre profiles. La interfaz de escritorio también incluye una traducción completa al chino simplificado (简体中文) mediante una capa i18n tipada (display.language; el inglés sigue siendo el idioma predeterminado).²⁰
• Panel de administración en el navegador. El dashboard web local pasó de ser una vista de estado a convertirse en 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 del sistema con comprobación previa a las actualizaciones y Debug Share con un solo clic. Una nueva página Channels permite configurar desde el navegador todas las plataformas de mensajería del gateway (Telegram, Discord, Slack y las demás). La autenticación ahora 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 OAuth autoalojado y rotación de sesiones mediante tokens de actualización.²⁰
• Nuevas opciones de CLI y comandos slash. /undo [N] revierte los últimos N turnos del usuario con texto 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 anularla; la TUI obtiene un comando /model unificado y una vista superpuesta de sesiones. hermes portal es un alias fácil de entender para el flujo de incorporación de Nous Portal, que ahora ofrece las rutas Quick Setup y Full Setup durante la primera ejecución; además, se incorporan 2 herramientas 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 MiniMax nativos), qwen3.7-plus (Nous y OpenRouter) y gemini-3.5-flash (OAuth de Gemini y clave de API). Un proveedor propio de OAuth para xAI Grok se incorpora 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 una frecuencia diaria a una frecuencia horaria.²⁰ (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 retiraron varias entradas desactualizadas), movió más skills a la categoría opcional e incorporó un criterio de relevancia environments: en el frontmatter (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 los plugins incorporaron una divulgación progresiva (por ámbito), y se corrigió un error de MCP que informaba falsamente del éxito de OAuth cuando no se había obtenido ningún token.²⁰
• Seguridad. v0.16.0 fija una versión corregida de Starlette (≥1.0.1) para resolver la vulnerabilidad CVE-2026-48710 (BadHost), saca las comprobaciones SSRF de URL del bucle de eventos en las rutas asíncronas, elimina el token bearer de inferencia de Bedrock del entorno de los subprocesos, 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 de las skills verificadas. La versión resolvió 2 problemas P0 y 62 P1, 16 de ellos etiquetados como problemas de seguridad.²⁰

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

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 introdujo 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»: Hermes muestra advertencias en todas las interfaces cuando detecta alguna de ellas, aunque no impide su uso, 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 utiliza 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 que se lanzó con v0.14.0; instálalo con iex (irm https://hermes-agent.nousresearch.com/install.ps1). La documentación señala explícitamente una salvedad: macOS es compatible solo con Apple Silicon; las Mac con procesadores Intel no son compatibles.⁴⁹ Históricamente, v0.14.0 incorporó compatibilidad nativa con Windows en una versión beta inicial mediante un instalador de PowerShell, pero WSL2 continúa siendo la recomendación más segura para entornos de producción hasta que la opción para Windows madure.¹⁹

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. Node 26 es un requisito mínimo estricto desde v0.20.0: el instalador rechaza cualquier versión anterior e instala en su lugar una versión de Node administrada por Hermes.⁴⁹⁷

Verificar 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 problema 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 un control total —una versión personalizada de Python, extras 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 extras opcionales que puedes combinar con uv pip install -e ".[<extras>]":

El comando de instalación para Termux es diferente: utiliza 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 incorpora faster-whisper mediante el extra 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).²⁶ Sobre esta base se ofrecen los endpoints personalizados y tres rutas de autenticación diferentes. A continuación encontrarás toda la superficie de autenticación, organizada por ruta para que puedas identificar la que corresponde a lo que tienes.

Las tres rutas de autenticación

Cada proveedor de Hermes utiliza uno de estos tres patrones de autenticación:

Ruta 1 — Clave de API en .env. Coloca la clave en ~/.hermes/.env y Hermes la leerá al iniciarse. La utilizan OpenRouter, AI Gateway, z.ai/GLM, Kimi/Moonshot, MiniMax (incluido 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 los secretos de Bitwarden o 1Password (referencias op://) durante la carga, con varios cofres habilitados simultáneamente, precedencia determinista, advertencias sobre conflictos y procedencia por variable; .env sigue siendo la alternativa de respaldo. (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 único token; SecretSource sustituye el propio archivo de texto sin formato y permite incorporar futuros proveedores de cofres como plugins).⁵⁰

Ruta 2 — OAuth mediante hermes model o hermes auth. Inicia un flujo de código de dispositivo, abre un navegador y almacena las credenciales en ~/.hermes/auth.json (también puede importar credenciales existentes de herramientas como Claude Code o Codex CLI). Se utiliza con 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 incluye más proveedores que la documentación (consulta el recuento anterior), y todo lo que sea compatible con OpenAI puede utilizarse 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 OAuth de Anthropic mediante hermes model, Hermes prioriza el almacén de credenciales propio de Claude Code en lugar de copiar el token en ~/.hermes/.env. Así, las credenciales renovables de Claude conservan esa capacidad.² Si ya utilizas Claude Code en la misma computadora, esta es la opción más limpia.

Para fijar Anthropic permanentemente en config.yaml:

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

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

Copilot de GitHub: dos modos

Copilot admite dos modos: la API directa de Copilot (recomendada) y Copilot ACP (que inicia 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 de acceso personal clásicos (ghp_*). Los tipos compatibles son los tokens de OAuth (gho_*), los PAT 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_*, usa 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 de programación) para encontrar uno que acepte tu clave de API. El endpoint que funciona se almacena automáticamente en caché; la mayoría de los usuarios no necesitan definir 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, lo que permite reutilizar 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 de API o tokens de OAuth para el mismo proveedor, algo útil para distribuir los límites de solicitudes entre varias claves sin modificar el código.⁶ Los comandos antiguos hermes login y hermes logout se eliminaron; usa hermes auth en su lugar.⁶

Endpoints personalizados y autoalojados

Hermes funciona con cualquier endpoint de 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 la configuración en config.yaml, que es la única fuente de verdad para el modelo principal, el proveedor y la URL base.² Las variables de entorno antiguas OPENAI_BASE_URL y LLM_MODEL ya no se consultan para configurar el modelo principal; usa hermes model o edita config.yaml directamente.² (OPENAI_BASE_URL y OPENAI_API_KEY aún se respetan como alternativa para la ruta auxiliar provider: "main", así que no las elimines sin comprobar antes 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 nombre de modelo) consulta la API /v1/models de tu endpoint y selecciona automáticamente el modelo si solo hay uno cargado, lo que resulta útil para servidores locales que ejecutan un único modelo.²

Servidores locales de LLM (plantillas de configuración)

La documentación oficial incluye guías de configuración completas para Ollama, vLLM, SGLang, llama.cpp y LM Studio. Estos son los comandos clave que realmente ejecutarás. Cada uno está diseñado para crear 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

Detalle crítico de Ollama: Ollama usa 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 de contexto del cliente, por lo que Hermes no puede configurarla por ti.² Para usarlo como agente, establece al menos entre 16k y 32k.

vLLM — servicio de 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

Detalle 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 se interrumpen.²

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 las llamadas 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 a herramientas reales.²

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.

Detalle crítico de LM Studio: LM Studio obtiene la longitud de contexto de los metadatos del modelo, pero muchos modelos GGUF indican valores predeterminados de 2048 o 4096. Configura siempre la longitud de contexto de forma explícita en la configuración del modelo de LM Studio: haz clic en el ícono de engranaje situado 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 de desarrollo local 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 clase base abstracta ProviderProfile y un directorio plugins/model-providers/ para que puedan integrarse proveedores de inferencia externos sin modificar el núcleo.¹⁸ Si un proveedor ofrece 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 lo resuelve mediante la misma ruta runtime_provider.py que utilizan los proveedores integrados. Este es el cambio arquitectónico que sustenta la ampliación de proveedores en la versión v0.13.0: en lugar de editar el código del núcleo para añadir 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 permite que las herramientas que esperan una API al estilo de OpenAI, como Codex CLI, Aider, Cline, Continue o scripts personalizados, reutilicen la autenticación de Hermes respaldada por tu suscripción sin necesitar una clave de API adicional. Trata el proxy como infraestructura local de desarrollo: vincúlalo de manera intencional, no lo expongas ampliamente y ten en cuenta las condiciones específicas de cada proveedor.

Detección de la longitud de contexto

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

• context_length — la ventana de contexto total (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.

Configura context_length cuando la detección automática determine 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: configuración manual → modelo específico de un 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 3800 modelos) → valores predeterminados de reserva (128K).² El sistema tiene en cuenta al proveedor, por lo que un mismo modelo puede tener distintos límites de contexto según quién lo ofrezca (por ejemplo, claude-opus-4.6 admite 1M directamente con Anthropic, pero 128K en GitHub Copilot).²

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

Hermes no te limita a un modelo de un solo 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 distintas claves, un respaldo configurado toma el control cuando falla la opción principal y los espacios auxiliares que aparecen a continuación asignan las tareas secundarias a modelos más económicos de forma independiente del 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 sigue trabajando.

Grupos de credenciales. Cuando tengas varias claves de 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 el modelo principal (límites de solicitudes, errores del servidor o fallos 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 sesión, inserción de etiquetas de audio TTS, coincidencia de skills, envío de herramientas mediante MCP y la familia de especificadores/descomponedores de Kanban.⁴³⁴ De forma predeterminada (auxiliary.*.provider: "auto"), todas las tareas auxiliares se ejecutan en tu modelo principal de chat, es decir, el mismo proveedor y modelo que elegiste en hermes model. La documentación indica explícitamente 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 proveedor. Eso resultaba inesperado… Ahora, auto utiliza 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: con modelos de razonamiento caros, las tareas auxiliares pueden generar un gasto considerable, así que asigna cada tarea a modelos rápidos y económicos cuando sea importante. Dos tareas que antes eran auxiliares ya no usan ningún LLM: la extracción web (“web_extract y las instantáneas del navegador truncan el contenido extenso de forma determinista y almacenan el texto completo para paginarlo con read_file – sin intervención de LLM”) y la búsqueda de sesiones (la herramienta de estructura única devuelve directamente el contenido de la base de datos). Sus antiguos bloques auxiliary.web_extract.* y auxiliary.session_search.* ya no están incluidos en la configuración predeterminada – los valores que permanezcan en un config.yaml existente son “restos inofensivos que se ignoran” – y la ranura flush_memories tampoco aparece en la configuración predeterminada de esa etiqueta.³⁴

Puedes configurar qué modelo y proveedor usa cada tarea auxiliar. Todas las ranuras auxiliares usan las mismas opciones: provider, model, base_url (además de api_key, timeout, extra_body y un 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

Otras ranuras especializadas siguen la misma estructura: goal_judge (evalúa el cumplimiento del contrato de /goal), curator (la bifurcación que revisa el uso de skill), 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 tienes que editar YAML manualmente: ejecuta hermes model y selecciona “Configurar modelos auxiliares” para elegir interactivamente un modelo por tarea.³⁴

La opción de proveedor "main" significa “usar el mismo proveedor que usa mi agente principal” y es válida solo 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: como auto ya usa tu modelo principal, desapareció el antiguo problema de “configurar OpenRouter o dejar que las tareas auxiliares pierdan capacidades silenciosamente”; ahora la contrapartida es el costo. Si tu modelo principal es un modelo de razonamiento costoso, dirige las tareas secundarias más activas 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 precedencia es esencial, ya que 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 componen 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 los 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 añadidas que todavía no están en tu archivo.⁶

Precedencia de la configuración

Hermes carga la configuración desde varias fuentes. Cuando más de una fuente establece el mismo valor, prevalece la de 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 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 añadió 7 configuraciones regionales para los mensajes de CLI y del gateway: chino simplificado, japonés, alemán, español, francés, ucraniano y turco.¹⁸ La versión v0.14.0 localiza todos los comandos del gateway y el panel web, añade 8 configuraciones regionales 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).³³ Actualmente, la documentación solo está localizada en zh-Hans. La configuración regional se determina mediante las variables de entorno LC_ALL / LANG o con 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 del 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í.⁶³

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, visita 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 ofrece más posibilidades 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 a API, despacho de 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 a plataformas, despacho y webhooks)

La rotación es automática mediante RotatingFileHandler de Python; busca 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, y puede intentar reparaciones automáticas mediante --fix.⁶

Para compartir diagnósticos con otra persona, usa hermes dump: produce un resumen compacto en texto sin formato con las claves de API ocultas, listo para pegar 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 procesan desde un COMMAND_REGISTRY compartido en hermes_cli/commands.py, por lo que la mayoría funciona de forma idéntica en todas las interfaces.⁹

Control de sesiones

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 anulación del modelo durante un solo turno que restablece automáticamente el 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 las opciones a medida que escribes.²³³⁵

Herramientas, skills e información

Comandos slash dinámicos de 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 apilar: /skill-a /skill-b do XYZ carga ambos skills en orden dentro de un mismo turno, con autocompletado y texto predictivo para los nombres encadenados.⁵⁰

También puedes definir comandos rápidos en config.yaml que asignen un nombre corto a 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 registro. Los nombres completos de los comandos y los alias registrados siempre tienen prioridad sobre las coincidencias por prefijo.⁹

Comandos específicos de 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 sesiones)
• /sethome (alias /set-home) — marca el chat actual como página de inicio 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] — permite explorar todos los comandos y skills por páginas

Algunos, además, 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 refuerzo, 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 generales

Entre los nombres habituales de toolsets se encuentran 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 mediante plugins (v0.20.6+). Los proveedores externos de entornos aislados ya no necesitan integrarse en el repositorio principal: un plugin registra un TerminalEnvironmentProvider al cargarse mediante PluginContext.register_terminal_environment_provider, y el nombre registrado puede seleccionarse mediante terminal.backend exactamente como si fuera una opción integrada. Los nombres integrados están reservados —el registro rechaza cualquier proveedor cuyo nombre coincida con un backend incluido en el repositorio— y un backend registrado participa automáticamente en todas las interfaces principales (el selector de backends de hermes setup, el estado de las comprobaciones del panel, las verificaciones de hermes doctor, la gestión de rutas y directorios de trabajo de los 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 fija.³²

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 (se aplica 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 incorporan 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, bloqueo de la elevación de privilegios, límites de PID (256 procesos), aislamiento completo mediante espacios de nombres y espacio de trabajo persistente mediante volúmenes.¹⁰

Procesos en segundo plano

La herramienta de terminal admite la ejecución en segundo plano con administración explícita de procesos:¹⁰

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 utilizar herramientas interactivas de CLI, como Codex y Claude Code.¹⁰

Sudo

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

Kanban multiagente (v0.13.0+)

La versión v0.13.0 convierte la colaboración multiagente en una capacidad fundamental: un tablero Kanban persistente que registra las tareas, su estado y la identidad de cada trabajador entre agentes y después de los reinicios.¹⁸ El tablero permite que un enjambre de trabajadores de Hermes termine realmente el trabajo en vez de quedar paralizado por transferencias fallidas.

El tablero Kanban se complementa de forma natural con /goal (el bucle Ralph con objetivo fijo) para definir el objetivo y con la herramienta delegate_task existente para generar trabajadores. El resultado es un patrón de enjambre en el que cada agente comparte una única fuente de verdad sobre qué hacer después, quién lo está haciendo y qué tareas están bloqueadas.

¿Qué es un enjambre de Hermes?

Un enjambre consiste en varios trabajadores de Hermes que se ejecutan en paralelo sobre un mismo tablero Kanban compartido. No es un subsistema independiente que debas habilitar: es una posibilidad que ofrece el tablero. Este proporciona lo único que los agentes paralelos no pueden proporcionarse por sí mismos: una respuesta única y autoritativa a ¿qué debería tomar a continuación y ya hay alguien trabajando en ello?

La versión v0.15.0 convirtió este patrón en una topología compatible mediante la incorporación de una topología de enjambre para coordinar trabajadores en paralelo, la descomposición automática de un objetivo general en subtareas, la selección de modelos por tarea, las tareas programadas y la administración de worktrees, para que los trabajadores paralelos no entren en conflicto en el mismo checkout.⁵³

En la práctica, dale un objetivo al enjambre, deja que la descomposición automática lo divida en tareas del tablero y permite que los trabajadores las reclamen, las ejecuten y devuelvan los resultados. El límite de reintentos se configura por tarea (max_retries), de modo que una subtarea susceptible a fallos no consuma 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 sus labores con el mismo estado.

Un enjambre solo puede ser 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

Los 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 de agentskills.io.¹¹

Todos los skills se encuentran en ~/.hermes/skills/, el directorio principal y la fuente de referencia. En una instalación nueva, los skills incluidos se copian desde el repositorio. Los skills instalados desde el hub y los creados 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 del 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

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

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

Skills administrados por el agente

El agente puede crear, actualizar y eliminar sus propios 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 un 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 caminos sin salida y descubrió el procedimiento 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 (puedes explorarlos 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 reemplazó en la lista de fuentes.¹¹⁴⁹

Análisis de seguridad

Todos los skills instalados desde el hub pasan por un analizador de seguridad que comprueba posibles filtraciones de datos, inyecciones de prompts, comandos destructivos, indicios de riesgos en la cadena de suministro y otras amenazas.¹¹

Niveles de confianza:¹¹

--force puede ignorar los bloqueos de políticas que no sean peligrosos para los skills de la comunidad. No permite ignorar un veredicto dangerous del análisis.¹¹

Directorios externos de skills

Puedes indicarle a Hermes que analice directorios de skills adicionales 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 ${VAR}. Los directorios externos son de solo lectura: cuando el agente crea o edita un skill, siempre escribe en ~/.hermes/skills/. Si existe un skill con el mismo nombre en ambos lugares, tiene prioridad el local.¹¹

Memoria persistente

Hermes cuenta con una memoria limitada y seleccionada que persiste entre sesiones. Dos archivos conforman la memoria del agente, 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 incorporación al prompt del sistema se captura una sola vez al inicio de la sesión y nunca cambia durante ella. Esto es intencional, ya que conserva la caché de 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 sesión siguiente.¹²

Qué guardar

Guarda lo siguiente (el agente lo hace de forma 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 120 caracteres y cadenas de documentación al estilo de Google» → memory - Trabajo terminado: «Se migró la base de datos de MySQL a PostgreSQL el 15 de enero de 2026» → memory

Omite lo siguiente:¹² - Información trivial u obvia - Datos fáciles de volver a descubrir - 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 encuentra 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. Las consultas devuelven conversaciones anteriores relevantes, resumidas con Gemini Flash.¹²

Proveedores de memoria externos

Para disponer de una memoria persistente más profunda que la ofrecida por MEMORY.md y USER.md, Hermes incluye ocho complementos de proveedores de memoria externos: Honcho, OpenViking, Mem0, Hindsight, Holographic, RetainDB, ByteRover y Supermemory.¹²

Los proveedores externos funcionan junto con la memoria integrada (nunca la sustituyen) y añaden funciones como grafos de conocimiento, búsqueda semántica, extracción automática de datos y modelado de usuarios 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 permanece activa.⁶

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

La versión v0.13.0 permite recuperarse de una interrupción mientras el agente está trabajando. El gateway reanuda automáticamente las sesiones interrumpidas después de un reinicio; los reinicios mediante /update conservan el estado de la sesión durante la actualización; y, durante el desarrollo, las recargas de archivos fuente mantienen activa la sesión actual en vez de forzar una nueva.¹⁸ En la práctica, esto significa que las tareas prolongadas del gateway y los trabajos ejecutados mediante cron ya no reinician su ventana de contexto cuando se reinicia el proceso.

Checkpoints v2 (v0.13.0+)

En la versión v0.13.0, la persistencia del estado se rediseñó con un almacén único que incorpora depuración real, límites de seguridad para el disco y ningún repositorio paralelo huérfano.¹⁸ El sistema de checkpoint anterior acumulaba estados en el disco en los profiles de larga duración; el almacén v2 establece un límite estricto para el almacenamiento local de checkpoints y elimina el registro duplicado que provocaba ese crecimiento. No es necesario cambiar la configuración de cara al usuario; la próxima escritura de un checkpoint utilizará 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 codificada directamente.¹³

Hermes crea automáticamente un archivo SOUL.md predeterminado en ~/.hermes/SOUL.md (o en $HERMES_HOME/SOUL.md para profiles 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. Esto hace que la personalidad sea predecible en todos los proyectos.¹³

Qué incluir en SOUL.md

Úsalo para definir pautas duraderas de voz y personalidad:¹³ - tono - estilo de comunicación - grado de franqueza - estilo de interacción predeterminado - aspectos estilísticos que deben evitarse - cómo debe manejar Hermes la incertidumbre, los desacuerdos y la ambigüedad

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

Estos elementos corresponden 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 implementación.

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; después, 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 existentes de Portal, sin tener que administrar claves API adicionales.⁵⁵ Hermes CLI sigue teniendo licencia MIT y siendo completamente de código abierto. Lo que cambió es que ahora tu autenticación de Portal desbloquea más que la inferencia de modelos.

La vía más rápida para comenzar es hermes setup --portal, que el README presenta como «Un solo comando desde una instalación nueva»: inicia sesión mediante OAuth, establece Nous como proveedor y activa Tool Gateway. A partir de ese momento, hermes portal administra la relación. hermes portal login (la opción predeterminada cuando no se indica ningún subcomando) ejecuta el mismo proceso de incorporación en un solo paso; 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 mantiene como un alias oculto de compatibilidad con versiones anteriores de info, 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 separado para cada 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 mediante Portal. De lo contrario, se usa 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 durante la ejecución: cuando el gateway está disponible y una herramienta tiene use_gateway: true, Hermes da preferencia al gateway, incluso si también tienes configurada una clave directa de API. Esto es importante para la facturación: las llamadas realizadas mediante el 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 un paso de inicio de sesión independiente. Desde v0.19.0 también puedes administrar la suscripción desde una sesión: /subscription muestra tu plan y el saldo restante, ofrece una vista previa del costo exacto de una mejora o de cuándo entra en vigor un cambio a un plan inferior, y aplica el cambio con avisos de modificaciones programadas y la posibilidad de deshacerlo; /topup agrega crédito. La aplicación de escritorio cuenta con 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 corresponden al producto Portal, no a Hermes CLI, y cambian independientemente de las versiones de Hermes. Regístrate en https://portal.nousresearch.com/ y consulta la página de precios para conocer los niveles vigentes.

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 su disponibilidad depende del estado de tu suscripción de Portal.⁵⁵

Contexto: lo que esta versión no es

Hermes Agent CLI no requiere una suscripción. El proyecto sigue teniendo licencia MIT y todas sus 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 los usuarios que ya pagan Nous Portal; no elimina nada de la opción gratuita.

Gateway de mensajería

Hermes puede ejecutarse como un proceso de gateway de larga duración que se conecta con 28 plataformas de mensajería desde un único proceso: 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.^354171819 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 de ella, 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 bajo demanda cualquier otro nombre con uno de los 22 directorios de adaptadores incluidos en plugins/platforms/, por lo que contar únicamente los enums o los directorios no dará la misma cifra que la documentación.²⁵ v0.9.0 agregó iMessage mediante BlueBubbles (registro automático de webhooks, asistente de configuración y resistencia ante fallos), además de compatibilidad nativa con WeChat mediante iLink Bot API, con el modo de devolución de llamadas de WeCom para aplicaciones empresariales.¹⁶ v0.11.0 agregó QQBot.⁵⁴ v0.12.0 agregó Microsoft Teams y Tencent Yuanbao.¹⁷ v0.13.0 agregó Google Chat como la vigésima plataforma, sobre la misma arquitectura de adaptadores conectables; IRC y Microsoft Teams también se migraron al nuevo patrón de adaptadores con hooks genéricos de plugins env_enablement_fn / cron_deliver_env_var.¹⁸ v0.14.0 agrega LINE y SimpleX Chat, y completa de principio a fin la integración con Microsoft Teams mediante autenticación de Graph, un receptor de webhooks, el entorno de ejecución del pipeline y la entrega saliente.¹⁹ v0.17.0 (19 de junio de 2026) agrega iMessage sin relay mediante Photon Spectrum (OAuth con código de dispositivo mediante hermes photon login, sin necesidad de un relay de Mac/BlueBubbles), el adaptador oficial de WhatsApp Business Cloud API (que reemplaza el requisito de un proceso puente), grupos de SimpleX y archivos adjuntos nativos, además de Raft como plugin de plataforma incluido.²¹ Otras dos aparecen en la tabla de la documentación sin destacarse en las notas de la versión: ntfy es un canal ligero de notificaciones push basado en publicación-suscripción mediante 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 necesidad de SDK ni de 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 usa una suscripción nativa de Nostr WebSocket. Ambos 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 usuarios 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 bucle 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 del flujo.³

v0.19.0 agrega enrutamiento de mensajes basado en profiles y entrega duradera. Un único gateway multiplexado que comparte un token de bot puede enrutar servidores, canales o hilos específicos hacia distintos profiles —cada uno con configuración, skills, memoria y secretos totalmente aislados— mediante una anulación GATEWAY_MULTIPLEX_PROFILES; además, una serie de mejoras de robustez 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 una copia heredada opcional), y las respuestas finales se registran en un libro mayor duradero de obligaciones de entrega antes y después del envío a la plataforma: si el gateway falla cuando una respuesta ya está terminada, esta se vuelve a entregar en el siguiente arranque en lugar de perderse silenciosamente.⁵⁰

v0.21.1 hace que los límites de las conversaciones solo puedan establecerse de forma explícita. El documento sobre el ciclo de vida de las sesiones en la etiqueta v2026.9.7 define el contrato en cuatro oraciones: «La inactividad y el tiempo transcurrido nunca rotan una conversación. /new y /reset crean un límite explícito; la compresión del contexto continúa administrando historiales extensos. La configuración heredada de temporizadores se ignora. El tipo de datos SessionResetPolicy existente contiene información de compatibilidad inerte, no una política de ejecución». Una suspensión explícita todavía crea un límite en el siguiente turno entrante, la recuperación respeta los límites finalizados en lugar de reabrirlos y la expulsión exclusiva de recursos permite reanudar las conversaciones. Si parece que una sesión de tu gateway «nunca caduca», ahora ese es el comportamiento previsto; rótala manualmente con /new.⁴³

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 impiden que desconocidos hablen con tu gateway. Un 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 ese momento, queda autorizado.⁶

Tareas programadas (Cron)

Hermes cuenta con un sistema cron de primera clase en el que los trabajos son tareas del agente, no comandos de shell. Cada trabajo programado se ejecuta mediante un AIAgent nuevo con el prompt configurado y skills adjuntas opcionales, y entrega los resultados a 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 mediante una conversación 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 almacenan de forma persistente en JSON y sobreviven a los reinicios.³

La versión 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 incorpora en cada ejecución el resultado 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 quedó»; la instrucción incorporada es «evita repetir lo que ya se informó», la primera ejecución no cambia y, de forma interna, la opción 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 dispone de un pequeño espacio KV para cursores, marcas de agua y listas de seguimiento (16 KB por valor y 64 KB por trabajo; se incorpora al prompt en cada ejecución, por lo que los límites son intencionales), que se modifica 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 el resultado no cambia (se compara por bytes exactos), se omite por completo la ejecución del agente —sin llamada a LLM, sin entrega y con una ejecución silenciosa no_change—, mientras que un cambio incorpora un bloque de diferencias y ejecuta el agente con normalidad. Haz que los scripts de monitorización generen resultados estables; de lo contrario, cada ciclo parecerá un cambio.³⁷
• Nivel de razonamiento por trabajo y entrega a Bot Chat. --reasoning-effort fija el nivel de razonamiento de un trabajo (de none a ultra) y sustituye la configuración global y la específica del modelo durante sus ejecuciones; además, deliver=bot-chat entrega el resultado en 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

También puedes configurarlo manualmente en config.yaml:¹⁴

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

Desde la versión v0.19.0, las herramientas de MCP se presentan al modelo con la convención de nombres mcp__server__tool: cada nombre de herramienta incluye el nombre de su servidor, por lo que dos servidores que ofrecen la misma herramienta ya no entran en conflicto. Además, las notificaciones de registro de los servidores MCP aparecen en agent.log.⁵⁰

La versión v0.21.1 incorpora una opción de 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 ofrece un inicio de sesión mediante código de dispositivo conforme a RFC 8628 para máquinas sin interfaz gráfica o remotas. Esta opción sustituye la configuración oauth.flow del servidor. La misma versión aplica la propiedad del profile durante todas las sesiones de OAuth, ignora las cachés dañadas de metadatos de OAuth en lugar de bloquear un servidor y retransmite OAuth de MCP para escritorio mediante callbacks locales del cliente. Ahora, -t/--toolsets también filtra cuáles de los servidores MCP configurados se inician, por lo que una invocación limitada omite el arranque en frío de los servidores que no necesita.⁴⁴

La versión v0.21.0 convierte la interfaz de MCP para escritorio en un centro de control: los servidores y el catálogo se combinan en una sola página con importación mediante arrastrar y soltar de «cualquier contenido», comprobaciones de estado en segundo plano que avisan cuando la autenticación está por vencer antes de que falle una llamada a una herramienta, una capa de costos y uso de toda la flota que muestra estimaciones de tokens del esquema y el uso de cada servidor durante 30 días, además de enlaces profundos hermes:// que instalan un servidor MCP con confirmación explícita.³⁵

Como servidor — expón las conversaciones de Hermes a otros agentes:

hermes mcp serve
hermes mcp serve -v    # Verbose

Compresión del contexto

Hermes comprime automáticamente las conversaciones largas para mantenerse dentro de la ventana de contexto del modelo. El resumidor de compresión realiza una llamada independiente a LLM; puedes dirigirla a cualquier proveedor o endpoint.⁴ Desde la versión v0.20.6, la política predeterminada para conservar el tramo final es lean (compression.tail_mode: lean) y, en esa etiqueta, 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 indicado por target_ratio; en configuraciones con ventanas grandes o umbrales elevados, esto retiene entre 100.000 y 240.000 tokens por compresión. lean, en cambio, 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 traslada la continuidad al resumen: un registro detallado de la sesión para la región comprimida que preserva los identificadores (una llamada al resumidor auxiliar por intento), un índice de anclas extraído mecánicamente (números de PR, SHA, rutas y cadenas de error; usa expresiones regulares y nunca paráfrasis), todos los mensajes reales del usuario citados de forma literal y un puntero de recuperación session_search para que el agente pueda volver a acceder a cualquier contenido resumido. El resultado medido en la documentación con sesiones reales de 500.000 tokens: se conservaron unos 49.000 tokens, en lugar de aproximadamente 162.000. Los resultados antiguos de herramientas dentro del tramo final de lean se reducen a anotaciones de una sola línea que incluyen un puntero de recuperación, y los valores desconocidos de tail_mode utilizan lean como alternativa.³¹

Opciones de proveedor:⁴³¹

El modelo de resumen debe admitir una longitud de contexto al menos igual a la del 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 por presión del presupuesto

Cuando el agente trabaja en una tarea compleja con numerosas llamadas a herramientas, puede agotar su presupuesto de iteraciones (500 turnos de forma predeterminada desde la versión v0.20.0, frente a los 90 anteriores) sin darse cuenta. La presión del presupuesto advierte automáticamente al modelo:⁴

Tiempos de espera del streaming

La conexión de streaming de LLM dispone de dos niveles de tiempo de espera que se ajustan automáticamente para proveedores locales (localhost y direcciones IP de la red 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 opciones, monitoriza sesiones, explora skills y administra tu gateway sin tocar archivos de configuración ni la terminal.¹⁶ Inícialo con hermes dashboard. Es la forma más sencilla de comenzar para los usuarios nuevos que prefieren una GUI.

Monitorización de procesos en segundo plano (v0.9.0+)

watch_patterns permite definir patrones que se monitorizan en la salida de los procesos en segundo plano y recibir notificaciones en tiempo real cuando coinciden.¹⁶ Puedes vigilar errores, esperar eventos específicos («escuchando en el puerto») o revisar registros de compilación, todo ello sin realizar consultas periódicas. En combinación con notify_on_complete, incorporado en la versión v0.8.0 (que envía notificaciones cuando terminan las tareas en segundo plano), Hermes ofrece ahora una capa completa de observabilidad para procesos en segundo plano.¹⁵

Context Engine conectable (v0.9.0+)

La gestión del contexto ahora es un componente conectable mediante hermes plugins. Puedes incorporar context engine personalizados que controlen lo que el agente ve en cada turno mediante filtrado, resumen o inyección de contexto específico del dominio.¹⁶ Esto desacopla la estrategia de contexto del bucle central del agente y permite personalizar el contexto para cada proyecto o dominio.

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

hermes backup crea un archivo completo de 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 una configuración fiable con tus compañeros de equipo.

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 sistemas de voz y el comando /image funcionan directamente en el dispositivo.¹⁶

Refuerzo de la seguridad (v0.13.0+)

La versión v0.13.0 corrigió 8 problemas de seguridad P0 y modificó un valor predeterminado en beneficio del usuario.¹⁸ La versión v0.14.0 le sigue con la corrección de otros 12 problemas P0 y 50 P1, entre ellos el refuerzo contra ataques de fuerza bruta a sudo y el uso de sudo mediante la entrada estándar, correcciones de mecanismos para evadir la detección de comandos peligrosos, el saneamiento de errores de herramientas antes de reinyectarlos en el modelo, la autenticación de API del plugin del panel, la protección del centro de skills frente a SSRF y el análisis de avisos de seguridad de la cadena de suministro durante la instalación.¹⁹

Si mantienes una implementación de Hermes, considera v0.13.0 y v0.14.0 actualizaciones relevantes para la seguridad, no simples lanzamientos de funciones. La versión v0.13.0 corrige la elusión entre servidores de Discord y dos ventanas TOCTOU; v0.14.0 añade otra ronda de refuerzo que abarca el manejo de sudo, la reinyección de errores de herramientas, los APIs de plugins, la protección del centro de skills frente a SSRF y los avisos de seguridad de las dependencias.

v0.21.0 añade 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, de modo que un agente afectado por una inyección de prompts no pueda reescribir discretamente sus propias órdenes permanentes. La protección viene activada de forma predeterminada (security.protected_instruction_files: true, con una lista de extensiones de nombres base basada en 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»; además, señala que los archivos de instrucciones se cargan desde los árboles del directorio de trabajo actual, por lo que «cualquier AGENTS.md ubicado en un lugar desde el que el agente pueda ejecutarse más adelante es un objetivo activo».³⁵³⁹ La misma versión corrige brechas de filtración 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 de macOS persistan 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 del catálogo de MCP y su skill tras un ataque al 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 quieren entender lo que sucede tras bambalinas para poder depurarlo, ampliarlo o analizar su rendimiento. Es una síntesis de la documentación de arquitectura del proyecto original.³

Puntos de entrada → AIAgent

En última instancia, todos los puntos de entrada de Hermes llaman 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. La cifra de «47 herramientas» corresponde al registro total de herramientas del repositorio original: todas las herramientas cuyo código fuente se incluye con Hermes, distribuidas entre todos los toolsets. Tu CLI en ejecución mostrará una cifra menor en el banner de inicio (la instalación con la que verifiqué esta guía indica 28 tools / 89 skills). No se trata de un error. Muchos toolsets son opcionales y deben habilitarse explícitamente en config.yaml, en toolsets:; entre ellos se encuentran los adaptadores de plataformas de mensajería, la automatización del navegador, las herramientas de extracción de datos más pesadas, etc. El total del registro representa «lo que está disponible»; la cifra del banner indica «lo que está 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 solucionador runtime_provider.py asigna tuplas (provider, model) a (api_mode, api_key, base_url) para más de 18 proveedores y gestiona flujos de OAuth, grupos de credenciales y 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. Directrices de comportamiento adaptadas a las herramientas
3. Memoria y contexto del usuario (MEMORY.md, USER.md)
4. Directrices de 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 principales y derivadas entre compresiones), aislamiento por plataforma y escrituras atómicas con gestión de contención.³

Sistema de plugins

Hay tres fuentes de detección: ~/.hermes/plugins/ (usuario), .hermes/plugins/ (proyecto) y puntos de entrada de pip. Los plugins registran herramientas, hooks y comandos de CLI mediante una API de contexto. Los proveedores de memoria son un tipo especializado de plugin ubicado en plugins/memory/.³

hermes plugins                       # Interactive enable/disable UI
hermes plugins install <repo>        # Install from Git URL or owner/repo
hermes plugins enable <name>
hermes plugins disable <name>
hermes plugins list

Periodo de compatibilidad (v0.21.1): los plugins externos deben 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 vuelve a exportar 1.148 nombres públicos trasladados desde sus módulos anteriores, con una advertencia por nombre y proceso (HermesPluginCompatWarning). La capa se eliminará el 14 de septiembre de 2026; a partir de esa fecha, cualquier plugin afectado quedará deshabilitado, no se cargará, y aparecerá un aviso rojo en el banner de CLI, hermes doctor y hermes update, además de un cuadro de diálogo de escritorio que se mostrará una sola vez y el motivo en hermes plugins list. Autores: ejecuten hermes plugins compat <path> (agreguen --json para obtener una salida procesable por máquinas); el comando muestra cada file:line con la ruta anterior -> la ruta nueva y devuelve el código de salida 1 mientras quede algo pendiente. Si dependes de un plugin sin mantenimiento, puedes establecer plugins.allow_deprecated_imports: true en config.yaml para que siga cargándose después de esa fecha, hasta que la reversión de la capa de compatibilidad elimine definitivamente las rutas anteriores. Solo se incluyen los nombres públicos de nivel superior; los nombres privados y los puntos de sustitución mediante monkeypatch para pruebas nunca formaron parte de la interfaz pública y no se restauran.⁴²

Principios de diseño

Tomados 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 de ~/.openclaw de forma predeterminada (también detecta automáticamente las carpetas heredadas ~/.clawdbot y ~/.moldbot) y escribe en ~/.hermes.⁶

Importados directamente (más de 30 categorías): SOUL.md, MEMORY.md, USER.md, AGENTS.md, skills de 4 carpetas de origen, modelo predeterminado, proveedores personalizados, servidores de MCP, tokens y listas de usuarios permitidos de las plataformas de mensajería (Telegram, Discord, Slack, WhatsApp, Signal, Matrix, Mattermost), valores predeterminados del agente (esfuerzo de razonamiento, compresión, demora humana, zona horaria y sandbox), políticas de reinicio 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 de API procedentes de 3 fuentes.⁶

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

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

Solución de problemas

“No inference provider configured. Run ‘hermes model’ to choose a provider and model”

El primer error que aparece en toda instalación nueva: Hermes aún no tiene un proveedor definido. Significa exactamente lo que dice: ninguna de las 3 vías 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 autoalojados. Si esperabas que ya hubiera un proveedor configurado, hermes doctor muestra qué credenciales puede detectar Hermes; las causas habituales son una clave de 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 de OAuth vencida en ~/.hermes/auth.json o un endpoint personalizado de config.yaml que perdió su base_url. Las vías de autenticación se explican en detalle en Autenticación y proveedores.²⁷

“Clave de API no 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.⁷

“Context limit: 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. Establécela de forma explícita 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 cortan a mitad de una oración

Hay 2 causas posibles:²

1. Límite de salida bajo (max_tokens) en el servidor: SGLang usa de forma predeterminada 128 tokens por respuesta. Establece --default-max-tokens en el servidor o configura 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.

“Connection refused” 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. Tienes 2 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 escuche en 0.0.0.0, no en 127.0.0.1: establece 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 desactualizado), aunque config.yaml indique agent.max_turns: 500, la causa probable es una línea obsoleta de HERMES_MAX_ITERATIONS en ~/.hermes/.env: anteriormente, el asistente de configuración escribía el presupuesto en ambos lugares y, si el puente de inicio se interrumpe por un error previo al analizar la configuración, el valor fantasma 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, de modo que config.yaml queda como fuente autoritativa.⁴¹

¿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 formas:²

1. Establece 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 utilizará el almacén de credenciales de Claude Code cuando esté disponible
3. Establece un ANTHROPIC_TOKEN manual (token de configuración o token de OAuth) como alternativa

La opción 2 es preferible si ya utilizas Claude Code en la misma computadora, pues permite que las credenciales renovables de Claude sigan siéndolo.

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

Usa /model provider:model dentro de una sesión. El historial de la conversación, la memoria y las 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 casi nunca puede suceder como antes. De forma 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 use Anthropic las atiende con el OAuth que ya tiene. El antiguo valor predeterminado (Gemini Flash mediante OpenRouter → Nous → detección automática de Codex, con una degradación silenciosa cuando ninguno estaba configurado) ya no existe: «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 continúa fallando, 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 ni siquiera es una tarea de LLM («LLM no interviene»), por lo que un error al resumir contenido web no es un problema del modelo auxiliar en las versiones actuales.³⁴ Para volver a vincular explícitamente una tarea a 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 valores predeterminados de comunicación. Se encuentra en ~/.hermes/SOUL.md y te acompaña en todas partes. AGENTS.md es específico de cada proyecto: contiene la arquitectura, las convenciones, los comandos y las 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 tiene 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 vía 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 dice que tiene Hermes?

La guía cita 47 herramientas y 20 toolsets del registro de arquitectura del proyecto original: es el total de herramientas cuyo código fuente incluye Hermes entre todos los toolsets. Tu instalación en ejecución muestra un número menor en el banner (la instalación de referencia utilizada para esta guía informa 28 herramientas) porque Hermes solo habilita el conjunto de toolsets predeterminado al iniciar. Muchos toolsets son opcionales: los adaptadores del gateway de mensajería, la automatización del navegador, las soluciones más pesadas de extracción de datos y varias integraciones especializadas deben indicarse explícitamente en toolsets: dentro de ~/.hermes/config.yaml para que se carguen. Total del registro = «lo que está disponible si lo habilitas». Total del banner = «lo que cargó realmente tu profile actual». Usa hermes tools --list para comprobar qué toolsets están activos y cuáles están disponibles, pero deshabilitados. Activa o desactiva toolsets individuales durante la ejecución con /tools enable <name> y /tools disable <name> (al desactivar uno, se 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 falla el proveedor principal (por un límite de solicitudes, un error del servidor o un fallo de autenticación), Hermes cambia al modelo de respaldo durante la sesión sin perder el historial de la conversación. Esto ocurre como máximo una vez por sesión.

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

Sí; esa es la parte de «mejora continua» de Hermes Agent. El agente puede crear, actualizar y eliminar skills mediante la herramienta skill_manage. Cuando encuentra la manera de realizar un flujo de trabajo no trivial, guarda el método como una 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 correcto, cuando corriges su enfoque o cuando descubre un flujo de trabajo no trivial.

¿Existe alguna 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

Referencias