v0.10.0

Hermes Agent v0.10.0 — A versão do Tool Gateway

Visão Geral

v0.10.0 — The Tool Gateway Release. Publicado em 16 de abril de 2026. Mais de 180 commits · 1 PR mesclado (#11206) · 1 colaborador da comunidade (@jquesnelle).

Esta versão remove o maior ponto de atrito na adoção de agentes de IA: o gerenciamento de chaves API. Antes da v0.10.0, habilitar pesquisa web, geração de imagens, texto para fala ou automação de navegador no Hermes Agent significava obter e gerenciar chaves API separadas para cada serviço. O Nous Tool Gateway muda isso — assinantes pagos do Nous Portal obtêm todas as quatro ferramentas através da sua assinatura existente, sem configuração adicional.

Esta versão chegou apenas 3 dias após a v0.9.0 (13 de abril) e entregou somente o Tool Gateway como um recurso focado e de alto impacto. Os mais de 180 commits de correções de bugs, melhorias de plataforma e aprimoramentos de confiabilidade desta janela foram adiados e totalmente documentados no changelog da v0.11.0.

No entanto, neste ponto da evolução do projeto, o Hermes Agent já integrava um ecossistema maduro: 118 habilidades, um Ciclo de Aprendizado Fechado (Closed Learning Loop) para geração autônoma de habilidades, um Gateway de Mensagens abrangendo mais de 16 plataformas, e o sistema de personalidade SOUL.md. Essas capacidades formaram a base que tornou o Tool Gateway tão impactante — os usuários agora podiam acessar tudo isso através de uma única assinatura.

Funcionalidade Principal

Nous Tool Gateway — Uma assinatura, quatro ferramentas

O Tool Gateway é uma camada de proxy gerenciada entre o Hermes Agent e os provedores de serviços externos. Quando um assinante pago do Nous Portal habilita o acesso às ferramentas, o Gateway gerencia autenticação, limitação de taxa e roteamento de requisições de forma transparente — o agente nunca toca nas chaves API individuais.

Ferramentas disponíveis através do Gateway:

Ferramenta Provedor Função
Pesquisa Web Firecrawl Recuperação de informações web em tempo real
Geração de Imagens FAL / FLUX 2 Pro Síntese de imagens IA de alta qualidade
Texto para Fala OpenAI TTS Geração de saída de voz
Automação de Navegador Browser Use Controle automatizado do navegador web

Como habilitar:

# Passo 1: Selecionar Nous Portal como provedor de modelo
hermes model
# → Escolha "Nous Portal" no seletor interativo

# Passo 2: Escolher quais ferramentas habilitar através do Gateway
hermes tools
# → Selecione "Nous Subscription" para definir use_gateway: true por ferramenta

# Passo 3: Verificar se tudo está conectado
hermes status
# → Mostra o estado de conexão do gateway e as ferramentas habilitadas

Isso gera a seguinte configuração em ~/.hermes/config.yml:

model:
  provider: nous_portal
  model: <seu-modelo-escolhido>
tools:
  web_search:
    use_gateway: true    # roteado através do Firecrawl
  image_generation:
    use_gateway: true    # roteado através do FAL / FLUX 2 Pro
  tts:
    use_gateway: true    # roteado através do OpenAI TTS
  browser:
    use_gateway: true    # roteado através do Browser Use

Decisões de design importantes:

  • Ativação por ferramenta — Você escolhe exatamente quais ferramentas passam pelo Gateway. Se você já tem uma chave API direta do Firecrawl e prefere usá-la, deixe use_gateway: false para pesquisa web enquanto habilita o Gateway para geração de imagens.
  • O Gateway tem prioridade — Quando existem tanto uma chave API direta quanto use_gateway: true para a mesma ferramenta, o runtime prefere o Gateway. Isso evita cobrança acidental em ambos os caminhos.
  • Detecção limpa por assinatura — A antiga variável de ambiente oculta HERMES_ENABLE_NOUS_MANAGED_TOOLS desapareceu. A detecção agora é automática com base no seu status de assinatura do Nous Portal.
  • Suporte a Gateway auto-hospedado — Para organizações que desejam executar sua própria instância do Gateway, variáveis de ambiente fornecem controle de endpoint:
# ~/.hermes/.env
TOOL_GATEWAY_DOMAIN=your-gateway.example.com
TOOL_GATEWAY_SCHEME=https
TOOL_GATEWAY_USER_TOKEN=your-token

O Ecossistema na v0.10.0

Embora o changelog oficial da v0.10.0 se concentre exclusivamente no Tool Gateway, o ecossistema mais amplo do Hermes Agent nesta versão incluía vários sistemas maduros que vale a pena entender em contexto.

118 habilidades integradas + Ciclo de Aprendizado Fechado

O Hermes Agent foi distribuído com 118 habilidades pré-construídas organizadas em categorias incluindo MLOps, operações GitHub, pesquisa e coleta de informações, web scraping, execução e teste de código, e análise de dados. As habilidades são arquivos Markdown simples — legíveis, versionáveis e compatíveis com agentskills.io para compartilhamento comunitário.

O Ciclo de Aprendizado Fechado (Closed Learning Loop) é o que faz essas habilidades gerarem um efeito composto. Após qualquer tarefa envolvendo mais de 5 chamadas de ferramentas, o Hermes gera automaticamente um documento de habilidade capturando:

  1. Procedimento — os passos realizados para concluir a tarefa
  2. Armadilhas — casos limite e problemas encontrados
  3. Verificação — como confirmar que a tarefa foi concluída corretamente

Na próxima tarefa semelhante, a busca de texto completo FTS5 recupera a habilidade relevante e o agente parte da experiência em vez de começar do zero. Benchmarks relataram que agentes com mais de 20 habilidades autocriadas concluíam tarefas de pesquisa 40% mais rápido do que uma instância nova.

# Explorar habilidades disponíveis
hermes skills list

# Ver uma habilidade específica
hermes skills show <skill-name>

# Importar uma habilidade da comunidade
hermes skills import <path-to-skill.md>

Gateway de Mensagens — Mais de 16 plataformas, uma implantação

Uma única implantação hermes gateway expõe o agente em todas as plataformas de mensagens suportadas simultaneamente. Cada plataforma compartilha o mesmo contexto do agente, então uma conversa iniciada no Telegram continua perfeitamente no Discord ou Slack.

Plataforma Caso de uso
Telegram Interação mobile-first
Discord Servidores de equipe e comunidade
Slack Chat de equipe empresarial
WhatsApp Mensagens móveis e empresariais
Signal Comunicação focada em privacidade
Matrix Chat federado auto-hospedado
Mattermost Chat empresarial open-source
Email / SMS Comunicação assíncrona
DingTalk / Feishu Empresas da Ásia-Pacífico
CLI Interação nativa no terminal 
# Iniciar o gateway de mensagens
hermes gateway

# Assistente de configuração interativo
hermes gateway setup
# → Configurar tokens API, IDs de bot, mapeamentos de canais e listas de permissão

SOUL.md — Identidade do agente como Markdown

O arquivo SOUL.md define a identidade central do agente — como ele fala, o que valoriza e quais restrições deve seguir. Ele é colocado no início de cada prompt do sistema.

# ~/.hermes/SOUL.md

Você é um especialista em gerenciamento de infraestrutura.
- Sempre confirme antes de fazer alterações
- Quando incerto, declare sua incerteza explicitamente — nunca adivinhe
- Registre cada operação
- A segurança é a prioridade máxima

Substituições em nível de sessão estão disponíveis através do comando slash /personality:

/personality teacher   # Modo educacional e explicativo
/personality creative  # Modo de brainstorming e ideação
/personality analyst   # Modo de análise de dados e investigação

Este design mantém uma identidade padrão estável no SOUL.md enquanto permite mudanças de comportamento por tarefa.

Por que o Changelog é Curto

O changelog oficial da v0.10.0 é deliberadamente mínimo — ele descreve exatamente um recurso entregue nesta tag. A janela de lançamento (v0.9.0 → v0.10.0) durou apenas 3 dias, e a equipe Nous optou por entregar o Tool Gateway como uma versão independente e focada, em vez de retê-lo para um pacote maior.

Os mais de 180 commits de correções e melhorias desta janela — abrangendo o núcleo do agente, infraestrutura do gateway, CLI e sistema de ferramentas — foram adiados para o changelog da v0.11.0 (The Interface Release), que chegou apenas uma semana depois com ~1.556 commits e 761 PRs mesclados.

Esta estratégia de lançamento — entregar rapidamente um recurso de alto impacto, documentar o resto depois — reflete o ritmo de iteração acelerado do projeto nesta fase de desenvolvimento.

Atualização

# Instalações existentes
hermes update

# Nova instalação
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

# Instalação Python manual
git clone --recurse-submodules https://github.com/NousResearch/hermes-agent
cd hermes-agent
uv venv && source .venv/bin/activate
uv pip install -e ".[all]"
hermes

Colaboradores

  • @jquesnelle (emozilla) — Implementação original do Tool Gateway (#10799), resgatada e entregue nesta versão

Changelog completo: v2026.4.13…v2026.4.16

← Hermes Agent Changelog