v0.6.0

Hermes Agent v0.6.0 — A Versão Multi-Instância

Visão Geral

v0.6.0 — A Versão Multi-Instância. Publicada em 30 de março de 2026. 95 pull requests · 16 issues resolvidas · entregue em apenas 2 dias.

Esta é a versão que transformou o Hermes Agent de um assistente de sessão única em um componente de infraestrutura multi-instância e escalável. O recurso principal — Perfis — permite executar várias instâncias do Hermes completamente isoladas a partir de uma única instalação, cada uma com sua própria configuração, memória, sessões, habilidades e serviço de gateway. Juntamente com o novo Modo Servidor MCP, suporte a contêiner Docker e cadeias de fallback ordenadas de provedores, a v0.6.0 é a primeira versão do Hermes pronta para cargas de trabalho em produção.

Esta versão também marca a entrada do Hermes no mercado empresarial chinês com adaptadores nativos para Feishu/Lark e WeCom (WeChat Empresarial), além de grandes atualizações no Telegram (modo webhook), Slack (OAuth multi-workspace) e outras seis plataformas de mensagens.

Como observou o The NextGen Tech Insider, esta versão “transforma o agente de um assistente de sessão única em um componente de infraestrutura escalável capaz de executar cargas de trabalho isoladas com estados de memória distintos em hardware compartilhado.”

Funcionalidades Principais

1. Perfis — Hermes Multi-Instância

Execute várias instâncias isoladas do Hermes a partir da mesma instalação. Cada perfil possui sua própria configuração, memória, sessões, habilidades e serviço de gateway — completamente isolados, sem interferência.

# Criar um novo perfil
hermes profile create meu-agente-trabalho

# Listar todos os perfis
hermes profile list

# Alternar para um perfil
hermes -p meu-agente-trabalho

# Exportar um perfil para compartilhamento/backup
hermes profile export meu-agente-trabalho > meu-agente-trabalho.tar.gz

# Importar em outra máquina
hermes profile import meu-agente-trabalho.tar.gz

Propriedades principais:

  • Isolamento por bloqueio de token — impede que dois perfis usem a mesma credencial de bot, com mensagens de erro claras sobre qual perfil possui cada credencial
  • Autocompletar com Tab para nomes de perfil em todos os comandos CLI
  • Caminhos de exibição conscientes do perfil — todos os caminhos ~/.hermes voltados ao usuário mostram o diretório de perfil correto
  • Imports preguiçosos previnem ImportError durante hermes update quando módulos armazenam bytecode obsoleto

Esta arquitetura é o que torna o Hermes uma ferramenta de infraestrutura pronta para produção: execute um agente de suporte ao cliente, um agente de revisão de código e um agente de pesquisa simultaneamente a partir de uma instalação, cada um com memória e credenciais completamente separadas. Chega de escolher entre casos de uso.

2. Modo Servidor MCP

Exponha conversas, sessões e anexos do Hermes para qualquer cliente compatível com MCP — Claude Desktop, Cursor, VS Code e mais.

# Iniciar servidor MCP via stdio (para Claude Desktop, etc.)
hermes mcp serve

# Iniciar servidor MCP via HTTP streamable (para clientes de rede)
hermes mcp serve --transport streamable-http --port 3000

O que os clientes MCP podem fazer com o Hermes:

  • Navegar pelo histórico de conversas e ler mensagens individuais
  • Pesquisar entre sessões por tópicos específicos ou trechos de código
  • Gerenciar anexos (upload, download, listar)
  • Acessar o mecanismo de contexto completo que o Hermes constrói ao longo do tempo

Como resumiu o MurmurCast: “O modo servidor MCP permite que as conversas e o histórico do Hermes se tornem acessíveis a partir de outras ferramentas de IA por meio de um protocolo padronizado.” Esta é uma integração MCP bidirecional — o Hermes pode tanto consumir ferramentas MCP de servidores externos quanto servir seu próprio contexto para clientes MCP externos.

3. Contêiner Docker

Dockerfile oficial para executar o Hermes Agent em ambientes contêinerizados. Suporta tanto o modo CLI quanto o modo gateway.

# Construir o contêiner
docker build -t hermes-agent .

# Executar em modo CLI com configuração montada por volume
docker run -it -v ~/.hermes:/root/.hermes hermes-agent

# Executar em modo gateway
docker run -d -v ~/.hermes:/root/.hermes -p 8080:8080 hermes-agent hermes serve

Fecha #850 — um dos recursos mais antigos e solicitados pela comunidade.

4. Cadeia de Fallback Ordenada de Provedores

Configure vários provedores de inferência com failover automático. Quando seu provedor principal retorna erros ou está inacessível, o Hermes tenta automaticamente o próximo provedor na cadeia.

# hermes.config.yaml
provider:
  name: openai
  model: gpt-5
  fallback_providers:
    - name: anthropic
      model: claude-sonnet-4-20250514
    - name: openrouter
      model: google/gemini-2.5-pro

O que isso muda: Antes da v0.6.0, uma queda do provedor significava que seu agente ficava em silêncio. Agora, o Hermes se degrada graciosamente — o usuário pode nem perceber que o failover ocorreu. Isso, combinado com a correção do api_mode na troca de provedor (adeus api_mode obsoleto causando erros 404 após trocar de provedor), torna o gerenciamento de provedores de nível de produção.

Melhorias adicionais de provedores:

  • Fallback silencioso para OpenRouter interrompido — quando nenhum provedor está configurado, o Hermes agora gera um erro claro em vez de rotear silenciosamente para o OpenRouter
  • Modelos de pré-visualização Gemini 3.1 adicionados aos catálogos OpenRouter e Nous Portal
  • Mensagens amigáveis de limite de taxa 429 com contagem regressiva Retry-After
  • Listas de modelos curadas preferidas sobre a sondagem de API ao vivo quando a sondagem retorna menos modelos

5. Feishu/Lark & WeCom — Mensageria Empresarial Chinesa

Dois novos adaptadores de plataforma de mensagens de primeira classe:

Feishu/Lark (飞书):

  • Assinaturas de eventos, cartões de mensagem, chat em grupo
  • Suporte a imagens e anexos de arquivos
  • Callbacks de cartões interativos
  • Paridade total com as plataformas existentes no adaptador de gateway

WeCom / WeChat Empresarial (企业微信):

  • Suporte a mensagens de texto, imagem e voz
  • Chat em grupo com verificação de callback
  • Gerenciamento completo do ciclo de vida de mensagens
# hermes.config.yaml — exemplo de configuração Feishu
gateway:
  platforms:
    - platform: feishu
      app_id: cli_xxxxx
      app_secret: xxxxx
      encrypt_key: xxxxx
      verification_token: xxxxx

Fecha #1788.

6. OAuth Multi-Workspace do Slack

Conecte um único gateway Hermes a vários espaços de trabalho do Slack por meio de um arquivo de tokens OAuth. Cada espaço de trabalho recebe seu próprio token de bot, resolvido dinamicamente por evento de entrada.

# slack_oauth_tokens.json — um arquivo, vários espaços de trabalho
{
  "workspaces": {
    "T01ABCDEF": "xoxb-...",
    "T02GHIJKL": "xoxb-..."
  }
}

Chega de executar instâncias de gateway separadas por espaço de trabalho — um gateway cuida de todos.

7. Modo Webhook do Telegram & Controles de Grupo

Modo webhook — uma alternativa ao long-polling para implantações em produção:

# Executar adaptador Telegram em modo webhook
# Tempos de resposta mais rápidos, melhor atrás de proxies reversos
hermes serve --telegram-webhook-url https://seu-dominio.com/telegram/webhook

Controle de menções em grupo — configure exatamente quando o bot responde em grupos:

gateway:
  platforms:
    - platform: telegram
      group_mention_policy: mentioned  # 'always' | 'mentioned' | padrão regex

Além disso: tratamento elegante de alvos de resposta excluídos — sem mais travamentos quando a mensagem que estava sendo respondida foi excluída (#3229).

8. Backend de Busca Exa

Adicione o Exa como um backend alternativo de busca web e extração de conteúdo ao lado do Firecrawl e DuckDuckGo.

# Definir sua chave API Exa
export EXA_API_KEY=sua-chave-aqui
# hermes.config.yaml
tools:
  web_search:
    preferred_backend: exa  # ou 'firecrawl', 'duckduckgo'

O Exa oferece capacidades de busca semântica que complementam os backends existentes, particularmente útil para fluxos de trabalho de agente intensivos em pesquisa.

9. Habilidades & Credenciais em Backends Remotos

Monte diretórios de habilidades e arquivos de credenciais em contêineres Modal e Docker, para que sessões de terminal remotas tenham acesso às mesmas habilidades e segredos da execução local.

# hermes.config.yaml
terminal:
  remote_backend: modal  # ou 'docker'
  mount_skills: true
  mount_credentials: true

Fecha #3665 e #3433.

Novas Ferramentas Integradas & Habilidades

Ferramenta / Habilidade Descrição
Exa Search Backend de busca web semântica e extração de conteúdo
Descoberta Dinâmica de Ferramentas MCP Responde a notifications/tools/list_changed — detecta novas ferramentas de servidores MCP sem reconectar
memento-flashcards Sistema de cartões de repetição espaçada (nova habilidade)
songwriting-and-ai-music Criação de composições musicais e prompts de geração de música com IA (nova habilidade)
SiYuan Note Integração com o aplicativo de notas SiYuan (nova habilidade)
Scrapling Habilidade de web scraping usando a biblioteca Scrapling (nova habilidade)
one-three-one-rule Habilidade de framework de comunicação (nova habilidade)
Boot-md hook Exemplo de hook integrado para executar um arquivo BOOT.md na inicialização do gateway

E o Sistema de Plugins ganhou:

  • hermes plugins enable/disable <name> — gerencie o estado do plugin sem removê-lo
  • ctx.inject_message() — plugins agora podem injetar mensagens no fluxo de conversa em nome do usuário
  • Suporte auto-hospedado do Honcho — instâncias locais do Honcho sem exigir chave API

Atualizações das Plataformas de Mensagens

Discord

  • Reações de processamento de mensagens — adiciona um emoji de reação durante o processamento e o remove ao concluir (feedback visual nos canais)
  • DISCORD_IGNORE_NO_MENTION — ignora mensagens que @mencionam outros usuários/bots, mas não o Hermes
  • Limpar “thinking…” diferido — remove corretamente o indicador “thinking…” após a conclusão de comandos slash

WhatsApp

  • Sessão aiohttp persistente — reutiliza conexões HTTP entre solicitações
  • Resolução de alias LID-telefone — corresponde corretamente formatos de Linked ID e número de telefone em listas de permissão
  • Pular prefixo de resposta no modo bot — formatação de mensagem mais limpa

Matrix

  • Mensagens de voz nativas via MSC3245 — envia mensagens de voz como eventos de voz Matrix adequados em vez de anexos de arquivo

Mattermost

  • Comportamento de menção configurável — responde a mensagens sem exigir @menção

Signal

  • Codificar números de telefone em URL e corrigir parâmetro RPC de anexo — resolve falhas de entrega com certos formatos de número

Email

  • Fechar conexões SMTP/IMAP em caso de falha — previne vazamentos de conexão durante cenários de erro

Melhorias do Núcleo do Gateway

  • Escritas atômicas de configuração — previne perda de dados durante falhas do gateway
  • Substituições de variáveis de ambiente do canal principal — substituições de variáveis de ambiente aplicadas consistentemente
  • Substituir print() por logger — BasePlatformAdapter agora usa registro adequado em vez de instruções print
  • Rótulos de entrega de Cron — resolve rótulos de entrega legíveis por humanos via diretório de canais
  • Reforço de Cron [SILENT] — impede que agentes prefixem relatórios com [SILENT] para suprimir a entrega
  • Entrega de mídia em tarefas em segundo plano e correções de timeout de download de visão

Melhorias de CLI & Experiência do Usuário

  • Comprimento de pré-visualização de ferramentas configurável — mostra caminhos de arquivo completos por padrão em vez de truncar
  • Exibição de contexto de tokens de ferramentas — a checklist hermes tools agora mostra o custo estimado de tokens por conjunto de ferramentas
  • Suporte a exportação de sessão para stdout — exporta sessões para stdout com - para piping
  • Timeouts de aprovação configuráveis — define quanto tempo os prompts de aprovação de comandos perigosos esperam antes de negar automaticamente
  • Limpar pycache durante a atualização — previne ImportError de bytecode obsoleto após hermes update
  • Instalação automática de matrix-nio durante hermes setup quando Matrix é selecionado
  • Ferramentas de inicialização preguiçosa aparecem em amarelo no banner em vez de vermelho — reduzindo falsos alarmes sobre ferramentas “ausentes”
  • Várias correções de TTY e barra de status para uma experiência de terminal mais suave

Segurança & Confiabilidade

Reforço de Segurança

  • Detecção de comandos perigosos reforçada — correspondência de padrões expandida para comandos shell arriscados e proteção de caminhos sensíveis (/etc/, /boot/, docker.sock)
  • Verificações de gravação em caminhos sensíveis no sistema de aprovação — detecta gravações em arquivos de configuração do sistema via ferramentas de arquivo
  • Expansão da redação de segredos — agora cobre chaves API do ElevenLabs, Tavily e Exa
  • Rejeição de arquivos não-imagem para visão — rejeita arquivos não-imagem passados para análise de visão para prevenir divulgação de informações
  • Bloqueio de path traversal de categoria — previne ataques ../ em nomes de categorias de habilidades

Confiabilidade

  • Escritas atômicas de config.yaml — previne perda de dados durante falhas do gateway
  • Limpar pycache na atualização — previne ImportError de bytecode obsoleto
  • Timeout do terminal preserva saída parcial — sem mais perda de saída de comando no timeout
  • Restaurar terminalbench2 de corrupção por patch — arquivo recuperado danificado pela redação de segredos da ferramenta de patch

Correções de Bugs Notáveis

  • api_mode obsoleto na troca de provedor — trocar de provedor via hermes model agora limpa corretamente api_mode obsoleto, corrigindo erros 404 para provedores com endpoints compatíveis com Anthropic (#3685)
  • Alvos de resposta excluídos no Telegram — trata elegantemente respostas a mensagens excluídas em vez de travar (#3229)
  • Persistência de “thinking…” no Discord — limpa corretamente os indicadores de resposta diferida (#3595)
  • Alias LID-telefone do WhatsApp — corrige falhas de correspondência de lista de permissão com formato Linked ID
  • Codificação URL de números de telefone do Signal — corrige falhas de entrega com certos formatos
  • Vazamento de conexão de Email — fecha corretamente conexões SMTP/IMAP em caso de erro
  • KeyError ‘name’ no schema de ferramenta — garante que o campo name esteja sempre presente nas definições de ferramentas (#3729)
  • _safe_print ValueError — sem mais travamentos de thread do gateway por stdout fechado (#3534)

Atualização

hermes update

Para novas instalações, visite o guia de instalação.

Changelog completo no GitHub

← Hermes Agent Changelog