O Hermes, explicado por inteiro.

Num chatbot, você pergunta, ele responde e você decide o próximo passo. Com um agente, você entrega o objetivo (“organize os prompts deste roteiro e revise”) e ele mesmo escolhe os passos, usa ferramentas (terminal, arquivos, navegador, APIs) e confere o resultado de cada ação antes de seguir.

O loop do agente

O valor está na repetição: cada volta usa o resultado da anterior. No Hermes, esse loop roda dentro do AIAgent, que monta o prompt, chama o modelo, executa as ferramentas pedidas e devolve o resultado ao modelo, quantas vezes for preciso.

Os cinco níveis de um agente completo

Uma forma útil de ler o resto desta página: cada nível resolve uma limitação do anterior.

  Pontos de entrada
  CLI / TUI · App desktop · Painel web · Gateway de mensagens · IDEs (ACP) · API · Batch
                                   │
                                   ▼
  Núcleo — AIAgent
  ┌───────────────┬──────────────────┬───────────────────┐
  │ Prompt Builder│ Resolução de     │ Despacho de       │
  │ (monta o      │ provedor/modelo  │ ferramentas       │
  │  contexto)    │ (3 modos de API) │ (registro)        │
  ├───────────────┴──────────────────┴───────────────────┤
  │ Compressão de contexto · Cache de prompt              │
  └───────────────────────────┬──────────────────────────┘
                              ▼
  Estado  state.db (SQLite + busca FTS5) · memórias · skills · logs

• Prompt Builder: junta identidade (SOUL.md), regras do projeto, memória e o índice de skills num system prompt estável, que pode ficar em cache.
• Resolução de provedor: decide para qual API vai a chamada (Anthropic, OpenAI, Google…) e em qual formato.
• Despacho de ferramentas: executa as tool calls do modelo, com aprovações e sandbox, e devolve o resultado.
• Compressão: quando a conversa fica longa, resume o histórico antigo para caber no contexto do modelo.
• state.db: banco SQLite com todas as sessões e índice de busca em texto completo. É o que permite “lembrar daquela conversa da semana passada”.

O que entra no início de toda conversa

AGENTS.md: o manual do agente

Um arquivo Markdown em português comum, como o manual que você daria a um funcionário no primeiro dia: o que fazer, como responder, o que nunca fazer. A regra de ouro é ser enxuto (até ~200 linhas) e conter só o que muda decisões. O que é detalhe vai para outros arquivos que o AGENTS.md aponta.

Referências com @

Na conversa, digite @ seguido de um arquivo, pasta, diff do git ou URL, e o Hermes injeta o conteúdo na mensagem.

Por que Markdown

Títulos, listas e tabelas são o formato em que os modelos foram treinados a ler estrutura. Não é programação: é texto organizado. Por isso toda a base de conhecimento (regras, memória, skills, o vault do Obsidian) é Markdown.

Sem memória, cada conversa começa do zero: você corrige algo hoje e amanhã o agente repete o erro. O Hermes resolve isso em três camadas:

O loop de automelhoria

O agente trabalha, você corrige, ele anota, e na próxima conversa já parte da regra nova. É o mesmo loop do nível 1 (observa, age, ajusta), aplicado ao aprendizado do próprio agente. Em outras ferramentas isso precisa ser montado à mão; no Hermes vem de fábrica.

Para quem precisa de mais, há provedores de memória externos plugáveis, como Honcho (modelagem do usuário ao longo do tempo), Mem0 e Supermemory.

Contexto acumulado

Duas pessoas podem instalar a mesma ferramenta de graça. Um agente com seis meses de memória, skills e regras de um negócio específico não se copia. Esse é o ativo que cresce com o uso.

Uma skill é uma pasta com um SKILL.md: quando usar, passo a passo, armadilhas conhecidas e, se preciso, scripts e referências. Segue o padrão aberto agentskills.io, então funciona em outros agentes também.

Divulgação progressiva

No início da conversa o agente vê só o nome e a descrição de cada skill (uma linha). O conteúdo completo é carregado só quando a tarefa combina. Assim dá para ter centenas de skills sem lotar o contexto.

De onde vêm

O curator

Depois de tarefas complexas, um processo de revisão em segundo plano (o curator) propõe criar ou corrigir skills com o que foi aprendido. Toda mudança fica registrada num ledger, com antes e depois.

# gerenciar skills
hermes skills list                 # instaladas
hermes skills search <termo>       # procurar nos registros
hermes skills inspect <nome>       # ler antes de instalar
hermes skills install <id>
hermes skills repair-official all --restore   # restaurar oficiais

O Hermes tem mais de 40 ferramentas, organizadas em toolsets que podem ser ligados ou desligados por plataforma (hermes tools).

Onde os comandos rodam

Seis backends de terminal: localDockerSSHModalDaytonaVercel Sandbox. Modal e Daytona hibernam quando ociosos e custam quase nada entre sessões.

MCP: o tradutor universal

Antes, cada app (Gmail, Notion, um gerador de imagens) exigia uma integração própria. O MCP (Model Context Protocol, padrão criado pela Anthropic) é uma língua comum: qualquer servidor MCP, por stdio ou HTTP, vira ferramenta do agente, com filtro de quais ferramentas expor.

Exemplo direto do nosso trabalho: o Higgsfield tem servidor MCP oficial. Conectado, o agente passa a gerar imagem e vídeo dentro da própria conversa.

O Hermes funciona com qualquer provedor: Anthropic, OpenAI, Google, OpenRouter, Nous Portal (300+ modelos numa assinatura), endpoints compatíveis com OpenAI e modelos locais. Troca com hermes model ou /model no meio da conversa.

• Modelos auxiliares: tarefas paralelas usam modelos próprios e mais baratos (visão, compressão, títulos, revisão). Ficam em auxiliary.* no config.
• Fallback: se o provedor principal falhar, cai para um reserva automaticamente.
• Credential pools: várias chaves do mesmo provedor em rodízio quando batem limite.
• Provider routing: escolher por custo, velocidade ou qualidade.
• Cache de prompt: o system prompt estável é reaproveitado entre chamadas, o que reduz custo e latência. Por isso o Hermes evita mudar o contexto no meio da conversa.

Custo importa

Modelos de ponta são ótimos para planejar e decidir; para tarefa repetitiva em volume, um modelo menor faz igual por uma fração do preço. Modelos abertos (que rodam até na sua máquina) estão chegando perto dos fechados, o que interessa para agentes 24 horas e dados sensíveis.

Cron: tarefas agendadas

Agendamento por linguagem natural ou expressão cron, com entrega do resultado em qualquer plataforma. Um job pode rodar com agente (usando skills) ou só um script, sem gastar modelo nenhum.

hermes cron list
# exemplo real aqui: rotina diária às 07:00, script puro,
# só reporta o que estiver fora do normal

Delegação

• delegate_task: cria subagentes com contexto isolado, ferramentas restritas e terminal próprio; 3 em paralelo por padrão.
• Processos Hermes independentes: sessões completas em tmux para missões longas, horas ou dias.
• Kanban: fila de tarefas para vários agentes trabalharem em lanes.

Hooks e plugins

Hooks rodam código em pontos do ciclo de vida (logs, alertas, guardrails). Plugins adicionam ferramentas, provedores de memória e motores de contexto sem mexer no núcleo.

Profiles permitem várias instâncias independentes, cada uma com seu config, memória, skills e sessões, em ~/.hermes/profiles/<nome>/.

• Aprovação de comandos: comandos arriscados (apagar, sobrescrever config, scripts) pedem confirmação. Há modo “smart”, que aprova o óbvio e segura o perigoso.
• Segredos separados: chaves de API só em ~/.hermes/.env; o resto em config.yaml. Variáveis secretas são filtradas antes de chegar às ferramentas.
• Redação: tokens e dados sensíveis são mascarados em logs e saídas.
• Scanner de contexto: arquivos de regras e skills passam por detecção de prompt injection.
• Isolamento: backends em container ou sandbox para comandos; pareamento de DM nas plataformas de mensagem.
• Credenciais: logins, códigos 2FA e cartões são preenchidos por um cofre, nunca digitados pelo agente nem colados no chat.

hermes setup          # assistente completo
hermes model          # escolher provedor e modelo
hermes tools          # ligar/desligar ferramentas
hermes config set terminal.timeout 180   # editar config com segurança
hermes doctor         # diagnóstico
hermes update         # atualizar