v0.4.0

Hermes Agent v0.4.0 — La versión Expansión de Plataformas

Resumen

v0.4.0 — The Platform Expansion Release. Publicado el 23 de marzo de 2026. Apenas 11 días después de v0.2.0 (primera versión pública) y v0.3.0 (streaming + arquitectura de plugins), esta versión elevó a Hermes Agent de un gran agente CLI a un producto de plataforma genuino — con una API, cobertura multi-plataforma de mensajería, gestión del ecosistema MCP y seguridad de nivel empresarial.

Si v0.2.0 mostró al mundo lo que Hermes podía hacer y v0.3.0 hizo que la experiencia fuera fluida, v0.4.0 hizo que Hermes pudiera integrarse en cualquier sistema. A partir de este momento, Hermes no es solo un agente en tu terminal — puede ser tu backend de API, tu chatbot, tu centro de automatización.

El titular en una frase: Convertir a Hermes en un servidor API accesible a través de /v1/chat/completions, mientras se conecta a casi todas las principales plataformas de mensajería del mercado.

Funcionalidades Principales

1. Servidor API Compatible con OpenAI — Hermes como Servicio Backend

Esta es la funcionalidad más estratégicamente significativa de v0.4.0: Hermes ahora puede exponerse como un endpoint estándar /v1/chat/completions. Cualquier cliente compatible con la API de OpenAI — otros agentes, scripts de automatización, aplicaciones web — puede llamar a Hermes directamente.

Iniciando el servidor API:

# Iniciar el servidor API de Hermes
hermes serve

# Los sistemas externos ahora pueden llamar a Hermes mediante el SDK estándar de OpenAI
# Cualquier código que use el SDK de OpenAI puede conectarse a Hermes
from openai import OpenAI

client = OpenAI(base_url="http://localhost:8000/v1")

response = client.chat.completions.create(
    model="hermes",
    messages=[{"role": "user", "content": "Revisa este código en busca de problemas de seguridad"}]
)

La API REST complementaria /api/jobs te permite gestionar tareas cron a través de HTTP — crear, ver, eliminar — todo mediante endpoints REST estándar.

La seguridad fue diseñada desde el principio, no añadida después:

  • Límites de entrada + listas blancas de campos: previenen ataques de solicitudes maliciosas
  • Persistencia de respuestas respaldada por SQLite: sobrevive a reinicios
  • Protección de origen CORS: bloquea el acceso no autorizado desde navegadores
  • Estas protecciones se integraron en el servidor API desde el primer día

2. Seis Nuevos Adaptadores de Mensajería — Chat en Todas Partes

v0.4.0 añade 6 nuevas plataformas de mensajería de una vez. Combinado con el soporte existente de Telegram, Discord y WhatsApp, Hermes Gateway ahora proporciona cobertura unificada de mensajería en 9 plataformas principales:

Plataforma Destacados
Signal Adaptador completo con manejo de archivos adjuntos, filtrado de mensajes grupales y protección anti-eco para “Nota a uno mismo”
DingTalk Integración con Gateway + documentación de configuración, soporte nativo para flujos de trabajo empresariales chinos
SMS (Twilio) Canal SMS para escenarios sin conexión o de baja conectividad
Mattermost Filtro de canal solo @-menciones, ideal para equipos auto-alojados
Matrix Protocolo de comunicación descentralizado, soporte de visión y caché de imágenes
Webhook Adaptador webhook universal para cualquier sistema de disparo de eventos externos

Mejoras principales del Gateway:

  • Reconexión automática con retroceso exponencial: se recupera silenciosamente de desconexiones de plataforma
  • Contexto de mensaje de respuesta: incluye automáticamente el contexto del mensaje original para respuestas fuera de sesión
  • Ignorar MD no autorizados: filtrado configurable de mensajes directos de usuarios no autorizados
# hermes.config.yaml — ejemplo de configuración multi-plataforma
gateway:
  platforms:
    - signal
    - dingtalk
    - telegram
    - discord
  auto_reconnect: true
  ignore_unauthorized_dms: true

3. Referencias de Contexto @ — Interacción Estilo Claude Code

Escribe @ en la CLI y usa Tab para autocompletar rutas de archivo o URLs. Hermes inyecta automáticamente el contenido referenciado en el contexto de la conversación.

# Referencia @file — inyecta contenido de archivo en la conversación
> @src/auth/handler.ts Revisa esta lógica de autenticación

# Referencia @url — inyecta contenido de página web en la conversación
> @https://docs.example.com/api Escribe un cliente basado en esta documentación de API

Esto toma prestado del modelo de interacción de Claude Code, pero Hermes lo implementa como autocompletado con Tab + integración CLI nativa — sin necesidad de plugins de editor. Especialmente útil en entornos de terminal pura sin ningún IDE, como sesiones SSH en servidores remotos.

4. Cuatro Nuevos Proveedores de Inferencia — Libertad de Elección de Modelo

El sistema de proveedores de Hermes se expandió aún más en v0.4.0:

GitHub Copilot (OAuth + Validación de Token)

  • Flujo completo de autenticación OAuth, sin claves API hardcodeadas
  • Ventana de contexto de 400K para análisis de código ultra-largo
  • Validación automática de tokens y gestión de expiración Contribuido por @mchzimm

Alibaba Cloud / DashScope

  • Integración completa con DashScope v1 runtime
  • Soporte para toda la familia de modelos Qwen (qwen-*)
  • Nombres de modelo que preservan puntos (ej. qwen-plus-v2)

Kilo Code

  • Proveedor de inferencia optimizado para escenarios de codificación

OpenCode Zen / Go

  • Backends de proveedor ligeros Correcciones relacionadas con Zen contribuidas por @0xbyt4

Mejoras del sistema de proveedores:

  • Degradación automática por límite de tasa: cambio automático al modelo de respaldo en errores de límite de tasa — las conversaciones nunca se interrumpen
  • Revisión de detección de longitud de contexto: integración con models.dev, resolución consciente del proveedor, coincidencia difusa para endpoints personalizados, soporte para /v1/props de llama.cpp
  • Actualizaciones del catálogo de modelos: añadidos gpt-5.4-mini, gpt-5.4-nano, haiku-4.5, claude 4.6 (contexto de 1M), minimax-m2.7 y más
  • Mejoras en endpoints personalizados: soporte de configuración model.base_url, endpoints locales sin clave API, fallo rápido en claves faltantes en lugar de fallo silencioso

5. CLI de Gestión de Servidores MCP — Flujo Completo OAuth 2.1 PKCE

El ecosistema MCP (Model Context Protocol) dio un salto cualitativo en v0.4.0: de archivos de configuración manual a una experiencia completa de gestión por CLI.

# Instalar un servidor MCP
hermes mcp install <nombre-del-servidor>

# Configurar un servidor MCP
hermes mcp configure <nombre-del-servidor>

# Autenticación OAuth 2.1 PKCE (completamente guiada)
hermes mcp auth <nombre-del-servidor>
  • Flujo completo OAuth 2.1 PKCE: redirección del navegador, manejo de callback, renovación de token — todo guiado por la CLI
  • Servidores MCP expuestos como conjuntos de herramientas independientes: cada servidor MCP es un toolset activable/desactivable
  • Configuración interactiva de herramientas MCP: configura herramientas MCP directamente en hermes tools, sin editar YAML

6. Caché de Prompts en Gateway — Reducción Dramática de Costos para Conversaciones Largas

En modo Gateway, las instancias AIAgent ahora se cachean por sesión, preservando la caché de prompts de Anthropic entre turnos.

¿Qué significa esto?

  • Para conversaciones largas, la caché de prompts de Anthropic ya no se invalida y reconstruye en cada turno
  • Reducción masiva de costos (la diferencia de precio entre escritura y lectura de caché de prompts de Anthropic es de órdenes de magnitud)
  • La caché se restaura junto con la reanudación de sesión
# Activo automáticamente en modo Gateway, sin configuración necesaria
# La instancia AIAgent de cada sesión se cachea en memoria
# La caché de prompts se preserva entre turnos

7. Revisión Completa de Compresión de Contexto — Ninguna Conversación Es Demasiado Larga

El mecanismo de compresión de contexto fue completamente reescrito en v0.4.0:

  • Resúmenes estructurados: ya no es un simple truncamiento — actualizaciones de resumen estructuradas e iterativas
  • Protección de cola del presupuesto de tokens: preserva el contenido de conversación más reciente durante la compresión
  • Endpoint de resumen configurable: summary_base_url te permite usar un modelo auto-alojado para resumir, ahorrando costos de API
  • Soporte de modelo de respaldo: cambio automático a un modelo de respaldo cuando el resumidor principal no está disponible

8. Streaming Habilitado por Defecto — Lo Que Ves Es Lo Que Obtienes

El streaming en CLI ahora está habilitado por defecto a partir de v0.4.0, con amplias mejoras:

  • Visualización correcta de spinner y progreso de herramientas durante el modo streaming
  • Corregida la pérdida de espacios en blanco durante la concatenación de fragmentos de streaming
  • Corregidos problemas de saltos de línea en límites de iteración que causaban corrupción del streaming
  • Supresión automática de animación de spinner en entornos no TTY
  • Soporte de visualización de bloques de razonamiento/pensamiento (show_reasoning)

Nuevos Comandos CLI

Comando Función Uso
/statusbar Alternar barra de estado persistente (info de modelo + proveedor) /statusbar
/queue Encolar prompts sin interrumpir al agente en ejecución /queue <mensaje>
/permission Cambiar dinámicamente el modo de aprobación durante una sesión /permission
/browser Iniciar sesión de navegador interactiva desde CLI /browser
/cost Seguimiento de costos y uso en tiempo real en modo Gateway /cost
/approve / /deny Comandos explícitos de aprobar/rechazar en Gateway /approve o /deny

Mejoras en la Gestión de Configuración

# Recarga de configuración en tiempo real — edita config.yaml sin reiniciar
# Tiene efecto automáticamente, sin acción manual necesaria

# Sustitución de variables de entorno — usa ${ENV_VAR} en config.yaml
# Ejemplo:
# api_key: ${OPENAI_API_KEY}

# Modelos personalizados — custom_models.yaml
# Añade tus propios modelos fuera del catálogo oficial
  • Sustitución ${ENV_VAR}: referencia variables de entorno directamente en config.yaml
  • Recarga de configuración en tiempo real: los cambios en config.yaml se aplican sin reiniciar
  • custom_models.yaml: adiciones de modelos gestionadas por el usuario
  • Fusión YAML anidada: fusión profunda en actualización de configuración en lugar de reemplazo brusco
  • Selección de archivos de contexto basada en prioridad + soporte CLAUDE.md

Nuevas Herramientas

Herramienta Descripción Uso
Correo IMAP Leer y enviar correos mediante protocolo IMAP El agente puede manejar correo directamente
STT (Voz a Texto) Reconocimiento de voz mediante Whisper API Transcribir archivos de audio
Tavily Backend de búsqueda/extracción/rastreo web hermes tools enable tavily
Parallel Backend alternativo de búsqueda/extracción web hermes tools enable parallel
Backend Web Configurable Selección entre Firecrawl / BeautifulSoup / Playwright Configurar según necesidad
Precios con Reconocimiento de Ruta Estimaciones de costos precisas por ruta de proveedor Cálculo automático

Mejoras de TTS

  • NeuTTS: proveedor TTS local con flujo de configuración integrado, reemplazando el antiguo skill opcional
  • Soporte de base_url personalizado para OpenAI TTS

Mejoras en Herramientas de Visión

  • Timeout configurable
  • Expansión de tilde en rutas de archivo
  • Múltiples imágenes en MD de Gateway + fallback base64

Seguridad y Fiabilidad

Refuerzo de Seguridad

  • Protección SSRF: completa para vision_tools y web_tools
  • Prevención de inyección de shell: los sufijos de ruta ~user ya no son interpretados por el shell
  • Protección de origen del navegador: bloquea el acceso no autorizado desde navegador al servidor API
  • Aislamiento de credenciales del sandbox: las credenciales del backend del sandbox nunca se filtran a las variables de entorno de subprocesos
  • Restricción de ruta de referencia @: bloquea la lectura de archivos sensibles fuera del espacio de trabajo (contribuido por @Gutslabs)
  • Escáner de código malicioso pre-ejecución: analiza comandos de terminal_tool en busca de patrones maliciosos antes de la ejecución
  • Eliminación de inyección SQL: todas las llamadas execute() convertidas a consultas parametrizadas (contribuido por @dusterbloom)
  • Refuerzo de la API de Jobs: límites de entrada + lista blanca de campos + verificaciones de inicio

Mejoras de Fiabilidad

  • Bloqueos de hilo en 4 métodos críticos de SessionDB
  • Bloqueo de archivos para escrituras concurrentes en memoria
  • Manejo elegante de errores de OpenRouter
  • Robustez del bucle del agente significativamente mejorada: recuperación automática de tool_choice rechazado por el proveedor, manejo correcto de resultados de herramientas vacíos, errores de análisis JSON devueltos al modelo en lugar de ejecutar con argumentos vacíos, prevención de pérdida silenciosa de resultados de herramientas

Mejoras del Sistema Cron

  • Respuestas [SILENT]: los agentes cron pueden ejecutarse silenciosamente sin enviar resultados
  • La ventana de gracia de trabajos perdidos se escala con la frecuencia de programación
  • Recuperar trabajos únicos recientes
  • Corrección de normalización de marcas de tiempo ISO (anteriormente, las marcas de tiempo sin zona horaria causaban que los trabajos se ejecutaran en momentos incorrectos)

Ecosistema de Skills

Nuevos Skills

Skill Descripción
OCR-and-documents OCR para PDF/DOCX/XLS/PPTX/imágenes con aceleración GPU opcional
Huggingface-hub Interacción integrada con HuggingFace Hub
Sherlock OSINT Búsqueda de nombres de usuario multiplataforma
Meme-generation Generación de imágenes con Pillow
Bioinformatics Skill gateway que indexa más de 400 skills de bioinformática
3D-model-viewer Visor de modelos 3D
FastMCP Skill de desarrollo rápido MCP
Base blockchain Interacción con blockchain

Mejoras del Sistema de Skills

  • Skills creados por el agente: hallazgos de nivel Caution permitidos, skills peligrosos preguntan en lugar de bloquear
  • Bandera --yes: omitir confirmación en instalación/desinstalación de skills
  • Skills deshabilitados respetados globalmente: ausentes del banner, system prompt y comandos slash

Mejoras del Sistema de Plugins

  • Hooks de extensión TUI: construye CLIs personalizadas sobre Hermes
  • hermes plugins install/remove/list: gestión completa del ciclo de vida de plugins
  • Registro de comandos slash: los plugins pueden registrar sus propios comandos slash
  • Evento de ciclo de vida session:end: los plugins pueden engancharse a eventos de fin de sesión

Actualización

hermes update

Para nuevas instalaciones, visita la guía de instalación.

Changelog completo en GitHub

← Hermes Agent Changelog