Hermes Agent: o que ele faz sozinho e o que ainda depende de você?

Hermes Agent criando e editando skills sozinho no terminal
Resposta rápida

O Hermes Agent é um agente de IA open source da Nous Research, licença MIT, que roda na sua própria infraestrutura com a chave de modelo que você escolher. Sozinho ele cria, edita e apaga as próprias skills em ~/.hermes/skills/, grava e remove entradas de memória e executa comandos no seu ambiente. Você entra nos freios: approvals.mode (manual, smart ou off) no config.yaml e skills.write_approval, que segura toda escrita de skill em stage para revisão. A hardline blocklist e o tirith barram operações catastróficas mesmo com aprovação desligada. Provedor, modelo e chave de API são sempre escolha sua

Fala aí, beleza? Quem ouve falar do Hermes Agent pela primeira vez não pergunta "o que ele faz", pergunta outra coisa: o que ele faz SEM me consultar?

Ele é um agente de IA open source da Nous Research, no repositório oficial NousResearch/hermes-agent, com a tagline "The agent that grows with you"

E é esse "grows with you" que assusta e atrai ao mesmo tempo, porque o bicho escreve as próprias skills e mexe na própria memória enquanto você trabalha

Então bora dividir a coisa em duas colunas bem honestas: o que ele conduz de ponta a ponta e o que continua dependendo da sua decisão, aprovação ou correção 🙂

O que é o Hermes Agent e como ele chega na sua máquina

O Hermes é licenciado como MIT e roda na sua própria infraestrutura

Ou seja: não tem taxa de licenciamento, o custo é o das APIs de modelo de terceiros que tu resolver plugar nele

E ele é model-agnostic, funcionando com qualquer endpoint compatível com OpenAI: tem suporte oficial a Nous Portal, OpenRouter, OpenAI, Anthropic, Google Gemini e modelos locais via Ollama, sempre com chave própria (BYOK)

BYOK? Bring Your Own Key, ou seja, a chave é sua, a fatura é sua, o controle é seu

Os dois pontos de entrada:

O Hermes tem duas portas, e isso muda MUITO a percepção de autonomia

A primeira é a TUI: tu roda o comando hermes e cai numa interface de terminal

A segunda é o gateway, que roda como processo em segundo plano e conecta o agente a plataformas de mensagem

Que plataformas? A doc lista conversas em Telegram, Discord, Slack, WhatsApp, Signal, SMS, e-mail, Matrix, Mattermost, Microsoft Teams, Home Assistant, LINE, ntfy e navegador, entre outras, tudo a partir de um único processo

Sacou o pulo do gato? Um agente que vive num processo em background e responde por mensagem é um nível de autonomia bem diferente de um agente que só existe enquanto o terminal está aberto

A instalação é um comando só:

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

Esse script resolve as dependências no caminho: instala uv, Python, Node.js, ripgrep e ffmpeg, clona o repositório, cria o venv e configura o comando global hermes

E se você tá no Windows, se liga: CLI, gateway, TUI e ferramentas funcionam nativamente, sem WSL, com o instalador trazendo uv, Python 3.11, Node.js, ripgrep, ffmpeg e um Git Bash portátil

E a versão?

A estável mais recente é a v0.20.1 (tag v2026.8.13), publicada em 13 de agosto de 2026, consolidando cerca de 656 PRs desde a v0.20.0

A v0.20.0 (v2026.8.3, de 3 de agosto de 2026) foi a release apelidada de "The Herald", que trouxe TTS em streaming, barge-in, wake words on-device, Agent-to-Agent protocol (A2A v1.0), webhooks assinados e pesquisa com citações verificáveis

O que o Hermes faz sozinho e o que ainda passa por você

Aqui tá o coração do post: a divisão de trabalho real, tarefa a tarefa

Tarefa O que o Hermes conduz sozinho Onde você entra
Skills (memória procedural) Cria, edita e apaga skills em ~/.hermes/skills/, cada uma num diretório com um SKILL.md (frontmatter YAML + instruções em markdown), pela ferramenta skill_manage. Por padrão escreve livremente Só se você ligar skills.write_approval em true: aí toda escrita fica em stage em ~/.hermes/pending/skills/ esperando sua aprovação (o padrão é false)
Autoaperfeiçoamento Roda uma revisão em segundo plano ao fim de um turno, que também pode gerar escrita de skill Mesmo gate acima: sem ele ligado, essa revisão aplica direto
Memória persistente Adiciona, substitui e remove entradas em ~/.hermes/memories/ (MEMORY.md e USER.md) pela ferramenta memory, injetada no system prompt como snapshot congelado no início da sessão Nada é pedido a você, mas há checagem de segurança: conteúdo com padrões de prompt injection, exfiltração de credenciais, backdoor SSH ou caracteres Unicode invisíveis é bloqueado
Limite da memória Não compacta sozinha Quando uma escrita passaria do limite de caracteres, a ferramenta devolve erro em vez de descartar entradas em silêncio, e a arrumação fica com você
Execução de comandos Executa o que a tarefa pedir approvals.mode no ~/.hermes/config.yaml: manual confirma toda vez que um padrão perigoso aparece, smart usa uma chamada auxiliar de LLM pra classificar o risco, off desliga os prompts
Comandos catastróficos Recusa um conjunto de operações irreversíveis pela hardline blocklist, mesmo com approvals.mode: off ou /yolo ativo Não depende de você, e essa é a boa notícia
Escaneamento do conteúdo do comando O tirith analisa antes da execução e pega o que casamento de padrão não pega, tipo spoofing de URL por homógrafos e pipe pra interpretador. Ele se instala sozinho pelos releases do GitHub com verificação de checksum SHA-256 Também roda sem você pedir
Busca no histórico Consulta sessões antigas de CLI e mensageria via session_search, no SQLite em ~/.hermes/state.db com busca full-text FTS5 Nada
Provedor, modelo e chave de API Nada 100% sua escolha, sempre (BYOK)

Repara no padrão: as decisões de conteúdo (o que lembrar, o que virar skill, o que rodar) são dele por padrão

As decisões de dinheiro e de risco catastrófico continuam suas, ou de uma barreira fixa que ninguém desliga

Em quais situações vale deixar o Hermes Agent trabalhar sozinho

Autonomia não é boa nem ruim, é adequada ou inadequada ao ambiente, beleza?

Tarefa repetitiva que vale virar procedimento. Como o agente escreve as próprias skills, aquilo que você explica toda semana tende a virar um SKILL.md reaproveitável em ~/.hermes/skills/, e o ganho aparece na segunda vez em diante

Atendimento e comandos por mensageria. Com o gateway rodando em background, o agente atende num canal de conversa em vez de exigir terminal aberto, o que muda o uso pra quem quer disparar coisa do celular

Projeto longo, com contexto que você cansou de repetir. A memória em MEMORY.md e USER.md persiste em disco, e o session_search ainda deixa ele vasculhar as conversas antigas com FTS5 quando o snapshot não basta

Se você quer ver esse recorte com mais calma, eu abro os casos de uso reais do Hermes num post separado

Agora o contraponto, e esse é importante…

Máquina de produção, repositório com credencial, cliente real no meio: aí o combo é approvals.mode: manual e skills.write_approval ligado, e ponto

Não porque o agente seja ruim, mas porque o padrão dele é escrever skill livremente, e num ambiente sensível ninguém quer descobrir isso depois do fato 😀

Como ajustar o nível de autonomia do Hermes Agent

Os controles existem e são poucos, o problema é que quase ninguém liga eles antes do primeiro uso sério

Se a máquina onde ele vai rodar te preocupa, vale antes passar por um checklist para avaliar o projeto com calma

  1. Abra o ~/.hermes/config.yaml e defina o approvals.mode antes de qualquer coisa. As opções são manual (pede confirmação toda vez que um padrão perigoso é detectado), smart (usa uma chamada auxiliar de LLM pra classificar o risco) e off (desliga os prompts). O erro comum deste passo é tratar o off como "modo produtivo" numa máquina que tem coisa séria dentro
  1. Ligue o gate de skills com skills.write_approval em true. O erro comum deste passo é achar que isso já vem ligado: o padrão é false, então quem instala e sai usando está no modo em que o agente cria, edita e apaga skill sem perguntar
  1. Com o gate ligado, toda escrita do skill_manage (create, edit, patch, delete, write_file, remove_file) fica em stage em ~/.hermes/pending/skills/ em vez de ser aplicada, e essas escritas sobrevivem a reinícios
  1. Revise o que ficou parado antes de aprovar qualquer coisa, usando os comandos próprios do Hermes:
/skills pending
/skills diff <id>
/skills approve <id>
/skills reject <id>
/skills approval on|off

Traduzindo cada um: o /skills pending lista o que está em stage, o /skills diff <id> mostra o diff unificado daquela escrita, o /skills approve <id> aplica, o /skills reject <id> descarta e o /skills approval on|off liga ou desliga o gate

  1. Use o /skills approval on|off pra ligar ou desligar esse gate na hora, conforme o que você tá fazendo naquele momento

Duas coisas que dá pra guardar com carinho

A primeira: a hardline blocklist continua valendo mesmo com approvals.mode: off ou /yolo ativo, então existe um chão que não some

A segunda: quando a memória chega no limite de caracteres, a ferramenta devolve erro em vez de jogar entrada fora calada, o que é MUITO melhor do que perder contexto sem saber

Ah, e sobre provedores de memória externos: existem como plugin, mas só um pode ficar ativo por vez, e a memória interna (MEMORY.md e USER.md) segue ativa junto com o externo escolhido

O que percebi usando o Hermes na prática

No vídeo eu instalei o Hermes numa VPS Linux em vez do meu próprio computador com Windows

Vale o registro honesto: a doc oficial fala em execução nativa no Windows sem WSL, mas eu preferi a VPS mesmo assim, pra não misturar ambiente

A instalação rolou direto no terminal da VPS: um comando baixa os arquivos, outro executa o script, e os pacotes que faltavam foram entrando no meio do caminho

Quando terminou, eu nem precisei chamar o assistente de configuração, o setup abriu sozinho na tela

Escolhi o quick setup em vez do full setup, porque a ideia era colocar pra rodar com o mínimo necessário e já ver o agente em ação

Selecionei o OpenRouter como provider e colei uma chave de API criada na hora, com nome próprio pro Hermes, limite de crédito e data de expiração opcionais

Tome cuidado! A chave não aparece de novo depois de criada: ou tu salva na hora, ou vai ter que gerar outra

Pra testar sem gastar nada, fui de um modelo gratuito disponível no OpenRouter (Qwen), e já deu pra sentir o ciclo

Uma coisa que deixa claro o "não vem tudo pronto": eu pulei a etapa de configuração do gateway de mensagens (Telegram) no setup e deixei pra depois

No fim do setup a ferramenta mostra onde ficam os arquivos principais, quais comandos editam as configurações, como iniciar o agente, como configurar o gateway e um comando de checagem de problemas, o que ajuda bastante

Já dentro do agente, a primeira coisa que pedi foi um resumo das ferramentas disponíveis, só pra saber o que eu tinha em mãos antes de mandar ele fazer qualquer coisa

A sensação de uso da TUI foi de ferramenta leve, sem cerimônia

E eu também montei um infográfico comparando Hermes e Claude Code em memória, skills, agendamento, providers e tamanho de comunidade, pra ninguém achar que é substituição automática

Uma coisa eu repito sempre: a documentação oficial é a fonte confiável, e nenhum vídeo do YouTube, incluindo o meu, substitui a leitura da doc

Sobre infra, um aviso prático: eu recomendo um plano de VPS intermediário pra rodar com folga, porque o plano de entrada dá conta só de um teste inicial

No vídeo abaixo eu mostro esse caminho inteiro na tela: instalação na VPS, quick setup, chave do OpenRouter, primeiro contato com o agente e a comparação com o Claude Code

Vale instalar o Hermes Agent agora?

O resumo honesto é esse: o Hermes nasce com autonomia alta por padrão e com freios opcionais que VOCÊ precisa ligar conscientemente

Ele conduz sozinho a parte de virar experiência em procedimento: escreve e reescreve skill, grava e apaga memória, busca no histórico, executa comando

Você continua dono do que custa e do que dói: provedor, modelo, chave, e a decisão de exigir aprovação antes de escrita de skill ou de comando perigoso

O próximo passo é bem objetivo: escolha o provedor de modelo, rode o script de instalação e, ANTES do primeiro uso sério, defina o approvals.mode e o skills.write_approval de acordo com o risco daquela máquina

Dá pra começar com modelo gratuito e tirar suas próprias conclusões, que é exatamente o que eu sugiro: testa e me conta o que achou 🙂

até o próximo post!

Perguntas frequentes

O Hermes Agent é gratuito ou tem taxa de licenciamento?

O Hermes Agent é licenciado como MIT e roda na sua própria infraestrutura, então não existe taxa de licenciamento. O custo real é o das APIs de modelo de terceiros que você plugar nele, já que o agente funciona no modelo BYOK (Bring Your Own Key).

Dá pra usar o Hermes Agent no Windows sem WSL?

Dá sim, o CLI, o gateway, a TUI e as ferramentas funcionam nativamente no Windows, sem precisar de WSL. O próprio instalador já traz uv, Python 3.11, Node.js, ripgrep, ffmpeg e um Git Bash portátil.

Como impedir que o Hermes Agent crie ou edite skills sem minha aprovação?

Basta ligar skills.write_approval em true, já que por padrão essa opção vem como false. Com o gate ligado, toda escrita do skill_manage (create, edit, patch, delete, write_file, remove_file) fica em stage em ~/.hermes/pending/skills/ até você listar com /skills pending, revisar o diff com /skills diff e aplicar com /skills approve, ou descartar com /skills reject.

Quais plataformas de mensagem o gateway do Hermes Agent suporta?

O gateway roda como um processo único em segundo plano e conecta o agente a Telegram, Discord, Slack, WhatsApp, Signal, SMS, e-mail, Matrix, Mattermost, Microsoft Teams, Home Assistant, LINE, ntfy e navegador, entre outras plataformas. É essa mesma instância que mantém a memória e as skills funcionando fora do terminal.

O Hermes Agent pode rodar comandos perigosos sozinho no modo automático?

O approvals.mode no ~/.hermes/config.yaml controla isso: manual pede confirmação a cada padrão perigoso detectado, smart usa uma chamada auxiliar de LLM pra classificar o risco, e off desliga os prompts. Mesmo assim, uma hardline blocklist recusa um conjunto de operações irreversíveis mesmo com approvals.mode em off ou com o /yolo ativo.

Qual é a versão mais recente do Hermes Agent e o que ela trouxe?

A versão estável mais recente é a v0.20.1 (tag v2026.8.13), publicada em 13 de agosto de 2026, consolidando cerca de 656 PRs desde a v0.20.0. A v0.20.0, de 3 de agosto de 2026 e apelidada de ‘The Herald’, trouxe TTS em streaming, barge-in, wake words on-device, o protocolo Agent-to-Agent (A2A v1.0), webhooks assinados e pesquisa com citações verificáveis.




Escrito por | Matheus Battisti

Matheus Battisti
Fundador da Hora de Codar

Programador apaixonado pelo mundo das tecnologias, sempre buscando em aprender e se aprofundar em linguagens, frameworks e o que mais for necessário para executar um bom trabalho. Agora tem uma nova missão que é de passar seu conhecimento adiante para formar novos programadores e especializar mais os que já são.

Subscribe
Notify of
guest

0 Comentários
Oldest
Newest Most Voted

Formações

Formação Vibe Coding

Formação Vibe Coding

Do Prompt ao Produto: Crie Software Real com IA

  • 474 aulas
  • 20 projetos
  • 39h 30min

Blog | Mais populares