A maioria das pessoas instala o Hermes Agent e o usa como um chatbot. Elas escrevem um prompt, recebem uma resposta e fecham a aba. Isso cobre talvez 10% do que o agente pode fazer.
Este artigo mapeia cada nível de uso do Hermes Agent, desde o primeiro prompt até um sistema que gerencia seu negócio sem você. 15 níveis, agrupados em três fases. Cada nível se baseia no anterior, mas você pode pular para qualquer nível que se encaixe na sua configuração.
A estrutura é a mesma para cada nível: o que é, o que desbloqueia, como configurar e o erro que pega as pessoas naquele estágio.
Todos os detalhes técnicos verificados na documentação oficial e código-fonte do Hermes Agent v0.17.0.
Inscreva-se no meu SubStack para mais artigos: https://substack.com/@yanxbt
FASE 1 — FUNDAÇÃO (Níveis 1-3)
Você está usando o Hermes. O agente responde ao que você pergunta.
NÍVEL 1 — PROMPTS ÚNICOS
O que é: Você instalou o Hermes. Você digita prompts. O agente responde com chamadas de ferramentas, edições de arquivos, pesquisas na web, comandos de terminal. Interação básica.
O que desbloqueia: O Hermes executa tarefas em seu sistema de arquivos, terminal e web. Ele lê arquivos, escreve código, pesquisa na internet, executa comandos no shell. Ele faz coisas. Um chatbot fala sobre coisas.
Configuração:
Aplicativo desktop: baixe de hermes-agent.nousresearch.com. Instalação com um clique. CLI: hermes setup
Três modos de configuração: → Configuração Rápida (Nous Portal): login OAuth, modelo + Tool Gateway em um comando → Configuração Completa: percorra cada provedor, ferramenta e opção manualmente → Tela em Branco: tudo começa DESLIGADO, exceto provedor, modelo, ferramentas de arquivo e terminal. Sem pesquisa na web, sem navegador, sem memória, sem delegação, sem cron, sem habilidades, sem plugins, sem MCP. Você ativa apenas o que precisa. Nada que você não escolheu carrega, mesmo após atualizações.
O modo Tela em Branco é o ponto de partida mais limpo para usuários que desejam controle total sobre o que o agente pode e não pode fazer.
Conecte um provedor de modelo. Comece a conversar.
O erro: Tratar o Hermes como um mecanismo de busca. "Me fale sobre X" desperdiça um agente que pode fazer coisas. "Pesquise X, escreva um relatório, salve em ~/reports/" usa as ferramentas.
Exemplo: "pesquise os 5 principais CRMs para fundadores solo, compare preços e recursos, salve um relatório em ~/reports/crm-comparison.html" — o agente pesquisa, compara, escreve o arquivo. pronto em 3 minutos.
NÍVEL 2 — MEMÓRIA + SOUL.MD
O que é: O Hermes lembra de você entre sessões. O SOUL.md define quem o agente é. MEMORY.md e USER.md armazenam fatos duráveis sobre seus projetos, preferências e contexto de negócio.
O que desbloqueia: O agente para de pedir para você reexplicar as coisas. Duas pessoas fazendo a mesma pergunta recebem respostas diferentes porque o Hermes conhece seus contextos distintos. Suas instruções, preferências e detalhes de negócios persistem em todas as sessões.
A v0.17.0 adicionou operações de memória atômicas: o agente pode adicionar, substituir e remover entradas de memória em lote em uma única chamada. As atualizações de memória não falham mais no meio da edição quando o orçamento está apertado.
Configuração:
Aplicativo desktop / Painel: Perfil → SOUL.md → Editar CLI: abra ~/.hermes/SOUL.md em qualquer editor
Escreva 50-80 linhas cobrindo identidade, voz, operações e restrições. O agente lê isso no início de cada sessão.
O erro: Deixar o SOUL.md vazio e esperar uma saída personalizada. O Hermes sem um SOUL.md é genérico por design. O arquivo de identidade é a diferença entre um assistente geral e SEU assistente.
Exemplo: você pergunta "devo aumentar os preços?" Sem SOUL.md: conselho genérico sobre estratégia de preços. Com SOUL.md contendo seu modelo de negócio, margens e segmentos de clientes: "seu nível de entrada converte a 12%. Aumentá-lo em R$10 corre o risco de perda no segmento B, onde você tem 60% da receita. Teste no segmento A primeiro."
https://x.com/IBuzovskyi/status/2065125711401062758
NÍVEL 3 — COMANDOS DE BARRA (SLASH COMMANDS)
O que é: Comandos que mudam como o agente trabalha no meio da sessão. A maioria dos usuários nunca os digita.
O que desbloqueia: Trabalho paralelo dentro de uma única sessão. Você para de esperar uma tarefa terminar para começar a próxima.
Os comandos:
/background <prompt> Dispara uma tarefa em segundo plano. Sua sessão principal permanece livre. O resultado aparece como um painel quando termina.
/steer <prompt> Injeta uma mensagem na execução atual sem interrompê-la. Redireciona o agente no meio da execução.
/queue <prompt> Enfileira um acompanhamento. Espera até a tarefa atual terminar e, em seguida, executa automaticamente.
/model <nome> Alterna modelos no meio da sessão. Comece com Sonnet para planejamento. Mude para DeepSeek para execução. Mude para Opus para revisão.
A v0.17.0 adicionou grok-composer-2.5-fast via Grok OAuth: o modelo de codificação de contexto de 200K por trás do Cursor's Composer, acessível através da sua assinatura Grok.
Configure o comportamento padrão quando você digita enquanto o agente está ocupado:
Defina no aplicativo desktop, Painel ou config.yaml:
display: busy_input_mode: steer # ou queue, ou interrupt
O erro: Não saber que esses comandos existem. A maioria dos usuários digita um prompt, espera terminar, digita outro prompt. O /background sozinho dobra sua produtividade por sessão.
Exemplo: você está redigindo uma proposta. No meio da sessão: /background pesquisar [concorrente] preços e posicionamento. Você continua escrevendo. 5 minutos depois, um painel aparece com a análise competitiva. Você cola na proposta sem perder o ritmo.
FASE 2 — ALAVANCADA (Níveis 4-7)
O Hermes trabalha de forma mais inteligente. Você para de fazer tarefas que o agente pode cuidar.
NÍVEL 4 — HABILIDADES + MODELO CERTO PARA CADA HABILIDADE
O que é: Habilidades são documentos de conhecimento sob demanda e coleções de ferramentas que o agente carrega quando necessário. Cada habilidade pode ser executada em um modelo diferente.
O que desbloqueia: O agente se torna um especialista sob demanda. Uma habilidade de pesquisa carrega metodologia de pesquisa. Uma habilidade de revisão de código carrega padrões de segurança. Cada habilidade usa o modelo mais adequado para seu trabalho.
Configuração:
Aplicativo desktop / Painel: Central de Habilidades → Navegar → Instalar CLI: /skills search [tópico]
A v0.17.0 reformulou a Central de Habilidades: hubs conectados (OpenAI, Anthropic, HuggingFace, NVIDIA), seção em destaque, pré-visualizações completas das habilidades antes de instalar e verificação de segurança em cada habilidade.
A v0.17.0 também adicionou edição de imagens: image_generate agora edita imagens de origem ("deixe este logotipo azul", "remova o fundo"). Mesma ferramenta, novo modo.
Atribua um modelo por habilidade no aplicativo desktop ou config.yaml:
pesquisa/pesquisa web → DeepSeek V4 Flash (US$ 0,10/M tokens, mais barato) revisão de código → Claude Opus 4.8 (US$ 5/US$ 25/M, melhores benchmarks de codificação) escrita de conteúdo → Claude Sonnet 4.6 (US$ 3/US$ 15/M, prosa mais forte + chamada de ferramentas) codificação (valor) → GPT-5.5 (US$ 2/US$ 12/M, #1 Chatbot Arena, contexto de 2M) pesquisa com fundamentação → Gemini 2.5 Pro (US$ 1,25/US$ 10/M, Google Search integrado) trabalho em massa de subagentes → DeepSeek V4 (US$ 0,30/US$ 0,50/M, 90% de desconto em cache) juiz /goal → Gemini Flash (mais barato, rápido o suficiente para decisão binária feito/não feito) auto-hospedado (grátis) → Qwen 3 8B via Ollama (8 GB de RAM, lida com tarefas rotineiras)
O MiniMax M2.7 também vale a pena testar. Nous Research e MiniMax estão colaborando para otimizar futuros lançamentos para o Hermes. Um dos modelos mais usados dentro do Hermes em meados de 2026.
O erro: Executar toda habilidade no seu modelo mais caro. Uma habilidade rotineira de pesquisa web queimando tokens do Opus é dinheiro jogado fora. Corresponda o custo do modelo à complexidade da tarefa.
Exemplo: você executa uma habilidade de pesquisa competitiva no DeepSeek V4 Flash em vez do Opus 4.8. Qualidade comparável para pesquisa web. 30-50x mais barato por chamada. Ao longo de 30 execuções por mês, a economia se acumula rapidamente.
NÍVEL 5 — MCPs (CONECTE SEU MUNDO)
O que é: Servidores MCP (Model Context Protocol) conectam o Hermes a ferramentas externas. Gmail, Calendário, Notion, Slack, ClickUp, GitHub, bancos de dados, APIs.
O que desbloqueia: O agente trabalha com SEUS dados, não apenas com a web aberta. Ele lê seus e-mails, verifica seu calendário, consulta seu quadro de projetos e responde perguntas usando o contexto das ferramentas que você já usa.
Configuração:
Aplicativo desktop / Painel: MCP → Catálogo → navegar e instalar CLI: hermes mcp
O erro: Conectar 15 MCPs de uma vez. Cada MCP adiciona esquemas de ferramentas à janela de contexto. 15 MCPs com 10 ferramentas cada = 150 definições de ferramentas que o modelo lê a cada turno. Instale o que você usa. Desative o que não usa. O Tool Search (ativado automaticamente quando os esquemas consomem 10%+ do contexto) ajuda a gerenciar isso, mas menos MCPs ainda é melhor.
Exemplo: "o que aconteceu no Slack esta semana enquanto eu estava focado em codificar?" O agente lê seus canais do Slack, filtra por menções e tópicos principais, cruza com seus objetivos na memória. Entrega um resumo de 10 linhas. Sem alternar abas. Sem rolar por 200 mensagens.
NÍVEL 6 — SUBAGENTES + EXECUÇÃO PARALELA
O que é: delegate_task cria subagentes isolados com sua própria janela de contexto, sessão de terminal e conjunto de ferramentas.
O que desbloqueia: Trabalho paralelo entre vários agentes. Um pesquisa. Um critica. Um codifica. O pai orquestra. Cada filho pode executar um modelo diferente.
Configuração:
O agente usa delegate_task automaticamente quando a tarefa se beneficia do isolamento. Você também pode pedir diretamente:
"crie um subagente no DeepSeek para pesquisar X enquanto outro no GPT-5.5 critica os achados"
Configuração:
Defina no aplicativo desktop, Painel ou config.yaml:
delegation: max_concurrent_children: 3 # padrão max_spawn_depth: 2 # limita recursão
Papéis:→ leaf (padrão): executa, não pode recriar → orchestrator: pode criar seus próprios trabalhadores
Modo de segundo plano (v0.17.0): delegate_task(background=true) envia o subagente e retorna imediatamente. Sua sessão permanece ativa. O resultado reentra como um novo turno quando termina.
O erro: Usar subagentes para tarefas simples. A delegação tem sobrecarga (configuração de contexto, alocação de ferramentas). Uma tarefa que o agente principal pode lidar em 3 turnos não deve criar um subagente.
Exemplo: "pesquise três concorrentes em paralelo. um agente por concorrente. Use DeepSeek para pesquisa. O pai no Sonnet sintetiza os três." Três relatórios em 10 minutos em vez de 30. Cada agente trabalha isolado, então uma tarefa de pesquisa lenta não bloqueia as outras.
NÍVEL 7 — OPERAÇÕES ASSÍNCRONAS
O que é: Três recursos que permitem ao Hermes trabalhar sem você digitar.
O que desbloqueia: A mudança de "eu pergunto, ele responde" para "ele trabalha, eu reviso".
/goal — objetivos persistentes: Defina uma meta. Um modelo juiz avalia após cada turno: feito ou não feito? O agente continua automaticamente até que o objetivo seja alcançado, você pause ou o orçamento de turnos (padrão 20) acabe.
/goal encontrar 100 clínicas em Toronto, criar uma página de destino para cada uma, redigir e-mails personalizados para cada clínica.
/subgoal adiciona critérios no meio da execução sem redefinir o loop.
Tarefas Cron — agendadas: O Gateway marca a cada 60 segundos. Dispara tarefas devidas em novas sessões isoladas. Entrega resultados em 27+ plataformas: Telegram, Discord, Slack, WhatsApp, Signal, Matrix, iMessage, Microsoft Teams, Google Chat, LINE, e-mail, SMS e mais.
Adições da v0.17.0: → WhatsApp Business Cloud API (adaptador oficial da Meta, sem ponte QR) → iMessage via Photon Spectrum (sem necessidade de retransmissão Mac) → Mensagens rich do Telegram (Bot API 10.1, formatação nativa) → Blueprints de Automação: modelos de cron com um clique no Painel (briefing matinal, revisão semanal, resumo de notícias, lembrete). Sem necessidade de sintaxe cron.
Três camadas de custo: → modo no_agent: o script É o trabalho, US$ 0 para sempre → gate wakeAgent: o script decide se o LLM é necessário, US$ 0 até que algo mude → context_from: encadeie saídas de tarefas em pipelines sem um framework
Rede de segurança — checkpoints: Ative checkpoints antes de executar operações autônomas. O agente tira um snapshot do seu diretório de trabalho antes das alterações. /rollback restaura o estado se algo der errado durante a noite.
Defina no aplicativo desktop, Painel ou config.yaml:
checkpoints: enabled: true
O erro: Escrever prompts cron vagos. Cada execução cron começa do zero. Sem memória, sem histórico de chat. "Verifique aquele problema no servidor" não significa nada. "SSH em 10.0.0.5, verifique o status do nginx, confirme que a porta 443 retorna 200" funciona.
Exemplo: 8:00 da manhã. O Telegram notifica. Você não pediu isso. O Cron entregou: "3 novos artigos do arXiv no seu nicho. Concorrente atualizou a página de preços. Repositório GitHub que você acompanha mesclou uma alteração crítica. Ação: revise os preços do concorrente antes da sua reunião das 11h."
https://x.com/IBuzovskyi/status/2066145326780518736
FASE 3 — AUTONOMIA (Níveis 8-15)
O Hermes trabalha sem você. O sistema se acumula com o tempo.
NÍVEL 8 — ARQUITETURA DE MÚLTIPLOS PERFIS
O que é: Perfis separados do Hermes, cada um com seu próprio SOUL.md, config, memória, habilidades, tarefas cron e modelo. Agentes totalmente isolados em uma máquina.
O que desbloqueia: Trabalhadores especializados em vez de um generalista sobrecarregado. Um perfil Scout encontra sinais. Um perfil Analyst sintetiza pesquisas. Um perfil Coder entrega funcionalidades. Cada um faz bem um trabalho com o modelo certo para esse trabalho.
Configuração:
Aplicativo desktop / Painel: Perfis → Construir (assistente de 5 etapas: Identidade → Modelo → Habilidades → MCPs → Revisão) CLI: hermes profile create [nome]
Cada perfil se torna seu próprio comando:
hermes -p scout chat hermes -p analyst chat
O erro: Dar a todos os perfis o mesmo SOUL.md. O objetivo principal é o isolamento. Um Scout que tenta analisar desperdiça tokens. Um Analyst que tenta encontrar fontes duplica o trabalho do Scout. Um trabalho por perfil.
Exemplo: O Scout encontrou 12 fontes durante a noite. O Analyst as sintetizou em 4 entradas de wiki até as 10h. O Briefer entregou um resumo de 5 tópicos às 8h. Você leu enquanto tomava café. Nenhum deles compartilha memória. Cada um fez um trabalho com o modelo certo para esse trabalho.
https://x.com/IBuzovskyi/status/2067313826492547483
NÍVEL 9 — BASE DE CONHECIMENTO AUTOMELHORÁVEL
O que é: A habilidade LLM Wiki, baseada no padrão de Andrej Karpathy. Uma base de conhecimento automelhorável construída como arquivos markdown interligados. Embutida no Hermes.
O que desbloqueia: Conhecimento de longo prazo que se acumula além do limite de memória. A memória interna do Hermes lida com o contexto conversacional. A wiki lida com conhecimento de domínio: artigos, transcrições, notas de reuniões, descobertas de pesquisa. Referências cruzadas permanecem vinculadas. Contradições são sinalizadas automaticamente.
Configuração:
Defina no aplicativo desktop, Painel ou config.yaml:
WIKI_PATH=~/obsidian-wiki
Na primeira execução, a habilidade pergunta seu domínio para construir SCHEMA.md com a taxonomia de tags correta.
Conecte ao Obsidian para visualização em grafo: defina OBSIDIAN_VAULT_PATH para o mesmo diretório.
Alimente: "indexe este artigo na minha wiki: [cole URL ou texto]"
O erro: Nunca alimentar a wiki. Uma base de conhecimento vazia não acrescenta nada. O valor vem da acumulação. Mês 1: 50 entradas. Mês 3: 300+ entradas com referências cruzadas. O agente fica mais afiado porque a base de conhecimento ficou mais afiada.
Exemplo: você pergunta "como o concorrente X lida com a integração?" Sem wiki: o agente pesquisa na web, fornece informações genéricas. Com 3 meses de entradas na wiki: o agente extrai suas próprias notas de pesquisa, transcrições de reuniões onde um cliente mencionou o concorrente X e um artigo que você indexou no mês passado. A resposta inclui contexto que nenhuma pesquisa na web poderia encontrar.
NÍVEL 10 — ORQUESTRAÇÃO KANBAN
O que é: Um quadro de tarefas SQLite durável compartilhado entre todos os perfis. Os status fluem de triagem → a fazer → pronto → executando → bloqueado → concluído → arquivado. O despachante dispara a cada 60 segundos.
O que desbloqueia: Projetos complexos de várias etapas com cadeias de dependência. Cada cartão pode executar seu próprio loop /goal (goal_mode). Cartões com cartões pai inacabados aguardam automaticamente. Múltiplos perfis pegam cartões atribuídos a eles.
Configuração:
/kanban create "Pesquisar 100 clínicas" \ --assignee scout --goal --goal-max-turns 15
/kanban create "Criar páginas de destino" \ --assignee coder --goal --goal-max-turns 20 \ --depends-on "Pesquisar 100 clínicas"
CLI: hermes kanban ou /kanban no chat.
Kanban vs cron vs delegate_task: → Kanban: fila de trabalho durável, persiste entre reinicializações, multi-perfil → Cron: agendamento baseado em tempo, tarefas repetitivas → delegate_task: execução paralela única dentro de uma sessão
O erro: Usar Kanban para pipelines lineares simples. Três perfis em linha reta (Scout → Analyst → Briefer) funcionam bem com coordenação baseada em arquivos. O Kanban agrega valor quando você tem árvores de dependência, ramificações paralelas ou 10+ tarefas que precisam de acompanhamento.
Exemplo: Análise competitiva trimestral como um projeto Kanban. 12 cartões: 3 concorrentes × 4 dimensões (preços, recursos, posicionamento, sinais de contratação). O cartão de preços depende do cartão de raspagem web. O cartão de contratação depende do cartão de pesquisa no LinkedIn. Agentes pegam o trabalho à medida que as dependências são liberadas. Você revisa o relatório final sintetizado.
NÍVEL 11 — MODO DE VOZ
O que é: Conversão de fala em texto e texto em fala em todas as plataformas de mensagens. Seis provedores STT, cinco provedores TTS.
O que desbloqueia: Fale com o Hermes através de mensagens de voz no Telegram, Discord, WhatsApp. O agente transcreve, processa e pode responder com fala sintetizada. Conversas de voz completas sem digitar.
Provedores STT: → faster-whisper (grátis, executa no dispositivo) → wrapper de comando local → Groq (nuvem rápida) → OpenAI Whisper API → Mistral → xAI
Provedores TTS: → Edge TTS (grátis, padrão) → ElevenLabs (melhor qualidade, pago) → OpenAI TTS → MiniMax → NeuTTS (grátis)
O erro: Usar STT em nuvem caro para mensagens de voz rotineiras. O faster-whisper local lida bem com a maioria dos idiomas e não custa nada. Reserve o STT pago para áudio complexo ou ambientes ruidosos.
Exemplo: Dirigindo para uma reunião. Mensagem de voz no Telegram: "alguma coisa da pesquisa de ontem à noite que eu deva saber antes da minha reunião das 11h?" O agente responde com um resumo de áudio de 30 segundos. Você ouve em vez de ler. Mãos no volante.
NÍVEL 12 — AUTOMAÇÃO DE NAVEGADOR
O que é: O Hermes pode controlar um navegador para navegar em sites, preencher formulários, extrair dados e interagir com aplicações web.
O que desbloqueia: Tarefas que exigem uma sessão de navegador: raspar páginas dinâmicas, preencher formulários web, interagir com ferramentas que não têm API. O agente vê a página e age sobre ela.
Configuração:
Incluído no Tool Gateway para assinantes Nous Portal:
hermes setup --portal
Ou configure a automação de navegador separadamente através do painel.
O erro: Usar automação de navegador para tarefas que têm uma API. A automação de navegador é mais lenta, mais frágil e mais cara do que uma chamada de API direta. Use-a apenas quando não existir API.
Exemplo: O concorrente não tem API pública. O agente abre a página de preços deles via navegador, extrai planos e preços atuais, compara com o instantâneo do mês passado armazenado na sua wiki. Mudança detectada: eles eliminaram o nível gratuito. Sinalizado no seu briefing matinal.
NÍVEL 13 — SERVIDOR DE API
O que é: O Hermes exposto como um endpoint HTTP compatível com OpenAI. Agente completo com ferramentas, memória e habilidades acessíveis via formato de API padrão.
O que desbloqueia: Qualquer frontend que fale o formato OpenAI se conecta ao Hermes como backend: Open WebUI, LobeChat, LibreChat, ChatBox, aplicações personalizadas, integrações Excel. O agente se torna uma API sobre a qual você constrói.
Configuração:
Defina no aplicativo desktop, Painel ou .env:
API_SERVER_ENABLED=true API_SERVER_KEY=sua_chave_secreta
Inicie o gateway: Aplicativo desktop / Painel: Gateway → Iniciar CLI: hermes gateway
Endpoint: http://127.0.0.1:8642/v1/chat/completions
Configuração multiusuário: Crie um perfil por usuário em portas diferentes. Cada um obtém configuração, memória e habilidades isoladas.
O erro: Expor o servidor de API à internet pública sem autenticação. O servidor vincula a 127.0.0.1 por padrão. Acesse remotamente via túnel SSH, não exposição pública. A v0.17.0 adicionou gate OAuth em todos os endpoints que exigem token e autenticação websocket para o painel.
Exemplo: Sua pesquisa competitiva é executada como um endpoint de API. Um painel personalizado consulta o Hermes pelas informações mais recentes. Sua equipe vê dados competitivos em uma página interna ao vivo. Ninguém abre o Telegram. Os dados se servem sozinhos.
NÍVEL 14 — INTEGRAÇÃO IDE (ACP)
O que é: O Hermes é executado como um servidor ACP (Agent Communication Protocol) dentro do VS Code, Zed e editores JetBrains.
O que desbloqueia: Chat, atividade de ferramentas, diffs de arquivos e comandos de terminal são renderizados dentro do seu editor. O agente trabalha no diretório do seu projeto com o contexto do seu editor. Mesmo núcleo do agente, mesmas ferramentas, mesma memória que CLI e gateway.
Configuração:
hermes acp start
No VS Code: instale a extensão ACP, aponte para o Hermes.
O que o ACP inclui: → Ferramentas de arquivo: read_file, write_file, patch, search_files → Execução de terminal → Interface de chat dentro do editor → Solicitações de aprovação para comandos perigosos
O que o ACP exclui (por design): → Entrega de mensagens → Gerenciamento de tarefas cron → Recursos específicos do gateway
O erro: Pensar que o ACP substitui o gateway. O ACP é para sessões de codificação dentro de um editor. O gateway lida com mensagens, cron e entrega multiplataforma. Ambos executam o mesmo núcleo do agente por baixo.
Exemplo: Codificando uma página de preços. Dentro do VS Code, você pergunta ao Hermes: "como o concorrente X estrutura seus níveis?" O agente verifica sua wiki do Obsidian, encontra suas notas de pesquisa, dá a resposta. Você ajusta seu design sem abrir um navegador ou Telegram.
NÍVEL 15 — DISTRIBUIÇÕES DE PERFIL
O que é: Empacote toda a configuração do seu agente como um repositório git. Qualquer pessoa instala seu agente com um comando.
O que desbloqueia: Seu agente se torna um produto. Venda-o. Compartilhe-o com sua equipe. Distribua-o para clientes. Tudo é transferido, exceto chaves de API e memórias pessoais.
A v0.17.0 também introduziu a RAFT Agent Network: conecte o Hermes a raft.build como um agente externo. Ponte de canal de ativação com privacidade por contrato (os payloads de ativação carregam apenas metadados, nunca corpos de mensagens). Seu agente pode colaborar com agentes em outras máquinas.
O que uma distribuição contém:
distribution.yaml # manifesto SOUL.md # identidade config.yaml # configurações de modelo e provedor skills/ # habilidades personalizadas cron/ # tarefas agendadas mcp.json # ferramentas conectadas
Instalar a distribuição de outra pessoa:
hermes profile install
O erro: Incluir chaves de API ou dados pessoais na distribuição. As credenciais permanecem por máquina. A distribuição carrega personalidade, habilidades e fluxos de trabalho. O usuário traz suas próprias chaves.
Exemplo: Você construiu um departamento de pesquisa com Scout, Analyst, Briefer. Um novo membro da equipe entra. Ele executa: hermes profile install github.com/voce/depto-pesquisa. Ele tem seus três perfis, estrutura de wiki, tarefas cron e modelos SOUL.md. Ele adiciona suas próprias chaves de API e bot do Telegram. Funcionando em 10 minutos.
UM FLUXO DE TRABALHO, 15 EVOLUÇÕES
Pesquisa competitiva. A mesma tarefa. Veja como ela muda em cada nível.
Nível 1: você digita "o que há de novo em agentes de IA esta semana?" e lê um mural de texto.
Nível 2: o agente já conhece seu nicho e concorrentes do SOUL.md. A mesma pergunta, a resposta é filtrada para SEU mercado.
Nível 3: /background pesquisa concorrentes enquanto você redige uma proposta. Os resultados aparecem sem quebrar seu fluxo.
Nível 4: a habilidade de pesquisa é executada no DeepSeek V4 Flash. A habilidade de análise é executada no Sonnet. Você para de pagar preços do Opus por pesquisas web.
Nível 5: o agente verifica Slack, e-mail e ClickUp ANTES de responder. "Concorrente lançou ontem. Sua equipe discutiu isso em #product."
Nível 6: três subagentes pesquisam três concorrentes em paralelo. cada um no DeepSeek. o pai no Sonnet sintetiza. 10 minutos em vez de 30.
Nível 7: você parou de pedir. o cron job roda às 7h. wakeAgent gate: nada mudou = $0. concorrente lançou uma atualização = agente acorda, pesquisa, entrega o briefing no Telegram. você lê enquanto toma café.
Nível 8: perfil Scout encontra sinais a cada 3 horas. Analyst sintetiza às 10h. Briefer entrega às 8h. três perfis. um pipeline.
Nível 9: descobertas vão para a wiki do Obsidian. mês 3: 300+ entradas. o agente revela padrões que você não pediu porque a wiki encontrou conexões entre fontes.
Nível 10: análise trimestral roda como um projeto Kanban. 12 cartões com cadeias de dependência. agentes pegam tarefas quando as dependências são liberadas. você revisa o relatório final.
Nível 11: dirigindo para uma reunião. mensagem de voz: "alguma novidade da pesquisa de ontem à noite?" O agente responde com áudio. você ouve em vez de ler.
Nível 12: concorrente não tem API. agente abre a página de preços pelo navegador, compara com o snapshot do mês passado. mudança detectada. sinalizada no seu briefing.
Nível 13: pesquisa roda como um endpoint de API. um dashboard personalizado consulta. sua equipe vê inteligência competitiva em uma página ao vivo.
Nível 14: programando uma funcionalidade. dentro do VS Code você pergunta "como o concorrente X lida com isso?" O agente responde da sua wiki sem sair do editor.
Nível 15: sua configuração de pesquisa é um repositório git. novo membro da equipe roda um comando. Scout, Analyst, Briefer, estrutura da wiki, cron jobs. tudo instalado em 10 minutos.
ECONOMIA DE TOKENS: COMO EXECUTAR TODOS OS 15 NÍVEIS SEM QUEIMAR DINHEIRO
todo nível acima de 3 custa tokens. aqui estão os controles que mantêm os gastos previsíveis.
MODELO CERTO PARA CADA TAREFA (Nível 4+)
nem toda tarefa precisa do seu modelo mais caro. pesquisa na web = DeepSeek V4 Flash ($0,10/M). síntese = Sonnet ($3/$15/M). revisão final = Opus 4.8 ($5/$25/M). atribua modelos por habilidade, por perfil, por cron job. veja o Nível 4 para a referência completa de modelo por tarefa.
WAKEAGENT GATES (Nível 7+)
script roda a cada tick de graça. verifica se algo mudou. nada mudou = agente nunca acorda = $0. o agente só gasta tokens quando há trabalho a fazer.
MODO NO_AGENT (Nível 7+)
quando o script É o trabalho. verificações de uptime, alertas de disco, observadores de arquivos. saída vai diretamente para o Telegram. zero chamadas LLM. zero tokens. sempre.
SCRIPTS DE PRÉ-EXECUÇÃO (Nível 7+)
script coleta dados de graça. saída injetada no prompt como contexto. o modelo resume o que o script obteve em vez de queimar chamadas de ferramenta para encontrar os dados sozinho.
CONJUNTOS DE FERRAMENTAS ENXUTOS (Nível 5+)
defina --skills web,file por cron job. menos esquemas de ferramentas no contexto = prompt menor = mais barato. um trabalho de resumo de notícias não precisa de ferramentas de navegador, delegação ou kanban.
BUSCA DE FERRAMENTAS (Nível 5+)
ativado automaticamente quando esquemas de ferramentas consomem 10%+ do contexto. substitui definições completas de ferramentas por 3 ferramentas de ponte. ~300 tokens em vez de milhares. o agente descobre ferramentas sob demanda em vez de carregar tudo de uma vez.
LIMIAR DE COMPRESSÃO (Nível 7+)
definido no aplicativo Desktop, Dashboard ou config.yaml:
compression: threshold: 0.40 # padrão 0.50
aciona a compressão de contexto mais cedo. mantém execuções longas de /goal e sessões cron dentro do orçamento de tokens mesmo com 20+ turnos.
CURATOR — GRATUITO POR PADRÃO (v0.17.0)
a poda determinística de habilidades ainda roda de graça. a consolidação alimentada por LLM agora é opt-in apenas:
definido no aplicativo Desktop, Dashboard ou config.yaml:
curator: consolidate: true # opt-in, padrão false
a curadoria de fundo de rotina custa zero tokens. ative a consolidação apenas quando sua biblioteca de habilidades precisar de uma limpeza profunda.
DENSIFICAÇÃO SEM PERDAS (PR #47866 por teknium)
resultados de search_files são comprimidos antes de chegar ao modelo. mesma informação. menos tokens. mesclado no Hermes mais recente. execute hermes update.
MODELOS AUXILIARES PARA JULGAMENTO (Nível 7+)
o juiz /goal roda APÓS CADA turno. direcione-o para um modelo rápido e barato.
definido no aplicativo Desktop, Dashboard ou config.yaml:
auxiliary: goal_judge: provider: openrouter model: google/gemini-3-flash-preview
20 chamadas de juiz no Gemini Flash vs 20 no Opus = economia significativa.
LIMITES DE ORÇAMENTO (todos os níveis)
definido no aplicativo Desktop, Dashboard ou config.yaml:
budget: daily_max_usd: 10 session_max_usd: 2 monthly_max_usd: 200
limites rígidos. o agente para quando atinge o teto. defina-os antes de ativar qualquer cron job ou execução de /goal.
MONITORE OS GASTOS
aplicativo Desktop / Dashboard: a guia Uso mostra a discriminação por perfil. CLI: /usage em qualquer sessão para estatísticas por sessão.
adicione "encerre com gasto de token desta semana" aos prompts do Briefer para rastreamento semanal de custos no Telegram.
o padrão em tudo isso: transferir o trabalho do modelo caro para código gratuito, modelos baratos e contexto comprimido. o agente raciocina. tudo o mais roda de graça.
COMEÇE DO ZERO
se você se preocupa com controle de tokens desde o primeiro dia, instale com o modo Blank Slate (hermes setup → Blank Slate). tudo desativado, exceto provedor, modelo, ferramentas de arquivo, terminal. adicione recursos um por um conforme precisar. nada carrega que você não tenha ativado explicitamente. este é o ponto de partida mais barato e controlado.
ONDE A MAIORIA DAS PESSOAS PARA
Níveis 1-2. Eles instalam o Hermes, escrevem um SOUL.md e o usam como um chatbot inteligente. O agente economiza 30 minutos por dia.
O salto do nível 3 para o nível 7 é onde a economia de tempo diária passa de minutos para horas. /background, habilidades com os modelos certos, cron jobs com wakeAgent gates. Eles se acumulam.
O salto do nível 7 para o nível 10+ é onde o agente deixa de ser uma ferramenta e se torna um sistema. Arquitetura de múltiplos perfis, conhecimento auto-melhorável, orquestração Kanban. Você revisa o trabalho que aconteceu sem você.
COMO IDENTIFICAR SEU NÍVEL ATUAL
Você não precisa atingir o nível 15. A maioria dos fundadores solo opera bem nos níveis 7-10. Os níveis acima disso resolvem problemas específicos: voz para fluxos de trabalho móveis, navegador para ferramentas sem APIs, servidor API para integrações personalizadas, IDE para programação, distribuições para equipes.
Escolha o nível que corresponde ao seu gargalo. Configure esse. Passe para o próximo quando ele não for mais suficiente.
ARTIGOS RELACIONADOS
- ALMA DO AGENTE HERMES: POR QUE 50 LINHAS IMPORTAM MAIS DO QUE SEU MODELO — Mergulho profundo no Nível 2
- AGENTE HERMES SE CONSTRÓI ENQUANTO VOCÊ DORME — Mergulho profundo no Nível 7
- AGENTE HERMES + NOTEBOOKLM + OBSIDIAN: DEPARTAMENTO DE PESQUISA DE 3 AGENTES — Mergulho profundo nos Níveis 8-9
FONTES OFICIAIS
- Visão Geral dos Recursos
- SOUL.md
- Habilidades
- Cron
- Delegação
- Metas
- Perfis
- Kanban
- Voz e TTS
- Automação de Navegador
- Servidor API
- ACP/IDE
- Distribuições de Perfil
- Visão Geral de Integrações
Todos os detalhes técnicos verificados na documentação do Hermes Agent v0.17.0.
