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

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
Formação Claude Code
Domine Claude Code do absoluto zero até o avançado
- 120 aulas
- 4 projetos
- 9h 48min
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) |

VPS Hostinger para seu sistema
10% OFF extraVPS com SSD NVMe e backups semanais. O cupom MATHEUSHORADECODAR é aplicado automaticamente pelo link.
Ver planos com 10% OFF →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
- Abra o
~/.hermes/config.yamle defina oapprovals.modeantes de qualquer coisa. As opções sãomanual(pede confirmação toda vez que um padrão perigoso é detectado),smart(usa uma chamada auxiliar de LLM pra classificar o risco) eoff(desliga os prompts). O erro comum deste passo é tratar ooffcomo "modo produtivo" numa máquina que tem coisa séria dentro
- Ligue o gate de skills com
skills.write_approvalem 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
- 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
- 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
- Use o
/skills approval on|offpra ligar ou desligar esse gate na hora, conforme o que você tá fazendo naquele momento

Crie sistemas com IA para vender
Prompts, modelos e checklists para criar e publicar seu sistema com IA e preparar a oferta para o primeiro cliente.
Quero o e-book gratuito Receba o livro e os bônus no seu e-mail.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.
Formações
Formação Vibe Coding
Do Prompt ao Produto: Crie Software Real com IA
- 474 aulas
- 20 projetos
- 39h 30min
Blog | Mais populares
Hermes Agent requisitos: que máquina roda o agente sem travar?
Hermes Agent requisitos: entenda a diferença entre rodar com modelo em nuvem (VPS simples) ou modelo local (9B a 35B, 32 GB+ de RAM) sem travar o agente.
Hermes Agent no Telegram: vale a pena usar o agente pelo mensageiro em vez do terminal?
Hermes Agent Telegram traz o agente open source da Nous Research pro mensageiro: texto, voz, imagem e /model sem terminal aberto. Vale a pena trocar?
Hermes Agent é gratuito para usar em trabalho de cliente?
Hermes Agent é licenciado em MIT: uso comercial liberado sem taxa. Veja o que isso cobre, o que fica de fora e as regras para trabalho de cliente.
