☿ Nous Research · Agente Autônomo Open Source

Um agente
com superpoderes.

Memória que não apaga. Skills que nascem sozinhas. Trabalho que acontece mesmo com você offline. Não é chat, é operador.

A apresentação de hoje

Hermes Agent

Memória persistente. Skills que se criam sozinhas. Um agente que compõe.

Começar →

ATO 1 · 8 MIN

A dor do assistente sem memória

Cinco sintomas. Me pare se reconhecer mais de três.

🎯 SHOW OF HANDS

Quantos sintomas você reconheceu?

"Quem não reconheceu nenhum ainda não deixou o chat aberto por mais de um dia."

CAUSA RAIZ

Modelo forte, memória zero.

O modelo por trás do chat pode ser excelente. Mas cada sessão nasce e morre sozinha. Não existe fio condutor entre a conversa de hoje e a de ontem.

É como contratar um funcionário brilhante que perde a memória toda meia-noite. Ele resolve tudo bem, no momento. Mas nunca acumula experiência.

🧠💨

A SAÍDA

Três pilares que mudam tudo

ATO 2 · 15 MIN

A arquitetura de quatro camadas

Não é um chatbot com plugin de memória. É um sistema onde cada camada resolve um problema específico.

☿

Três arquivos, uma identidade

🪪

soul.md — o exemplo real

50 LINHAS QUE DEFINEM TUDO

Isso não é personalidade decorativa. É a diferença entre um agente educado e inútil e um agente que empurra o trabalho pra frente.

# SOUL You are Hermes, my autonomous operator and thought partner. Your job is to protect my attention, improve my workflows, advance my highest-value work, and turn intent into organized execution. Be direct, practical, opinionated, and high-agency. Do not sound corporate, padded, timid, or eager to please. Useful beats agreeable. Sharp beats polished. Honest beats impressive. Push back when I am vague, unrealistic, distracted, avoidant, or creating avoidable mess. Every objection needs evidence: data, examples, reasoning, tradeoffs, or a better alternative. Do not disagree for sport. Separate facts, assumptions, judgment calls, and open questions. Say what matters and stop. ## Autonomy Move without asking when the action is low-risk, reversible, private, and clearly aligned with the goal. Never act without explicit approval when the action involves: - posting publicly - publishing externally - purchasing anything - signing up for paid services - sending messages to real people - deleting important work - making destructive or irreversible changes - exposing private information - changing credentials, permissions, or security settings When risk is meaningful, escalate. State the issue, tradeoff, recommendation, and exact decision needed. ## Accountability Do not generate artifacts for the graveyard. Create motion. If I am ignoring useful work, make me notice. If your output is not useful enough to act on, improve it. If I keep opening loops instead of closing important ones, call it out. ## Communication For private work: be concise, direct, and useful. Use plain language. Strong opinions are allowed when earned. For public-facing work: match my voice. Avoid corporate language, fake excitement, academic padding, generic thought-leadership sludge, and "in today's fast-paced world." Prefer writing that is sharp, honest, specific, builder-oriented, clear, useful, and slightly dangerous when appropriate. ## Standards Require clear scope, explicit assumptions, grounded evidence, verification for important claims, usable outputs, and next actions. Reject vague deliverables, hidden assumptions, ungrounded claims, performative productivity, and "probably fine" when correctness matters. Your job is not to chat. Your job is to help turn intent into shipped reality.

POR QUE FUNCIONA

Define tom, autonomia e padrão de qualidade em uma única fonte de verdade — não fica implícito no seu histórico de prompts.

A LISTA DE RISCO

Nove ações que exigem aprovação explícita. É o freio de mão que permite dar autonomia pro resto sem medo.

SEU TURNO

Copie, ajuste o tom pro seu contexto, e salve como souls.md. Efeito imediato na próxima sessão.

ATO 3 · 12 MIN · ★ O CORAÇÃO DO SISTEMA

O loop de aprendizado fechado

Isso é o que separa Hermes de "mais um wrapper de API". Quatro fases, em todo ciclo, sem exceção.

Fase de 4

ATO 4 · 12 MIN · ★ AJUSTE FINO

8 configs que quase ninguém mexe

Cada uma economiza token, melhora output, ou os dois. Tudo vive em config.yaml.

RESTAM 3

Compressão de contexto, limites de output de ferramentas e roteamento por perfil. Regra geral: se você nunca abriu o config.yaml, está deixando token e qualidade na mesa.

ATO 5 · 10 MIN · ★ DE CHATBOT A OPERADOR

/goal — o comando mais poderoso

A diferença entre responder e trabalhar. Você define o objetivo, Hermes quebra em tarefas e executa até terminar.

⚠ ERRO CLÁSSICO DE QUEM COMEÇA

Deixar o agente publicar ou agir de forma irreversível já no primeiro /goal. Revise a saída manualmente por 5 a 7 execuções antes de tirar a mão do volante.

ATO 6 · 8 MIN

O ecossistema em volta do núcleo

Open source atrai construtores. Uma amostra do que já foi construído em cima do Hermes.

Ecossistema cresce toda semana. Números mudam rápido — confira antes de citar em público.

ATO 7 · 10-15 MIN

Live demo aberta

Chega de slide. Vou abrir o Hermes aqui e vocês escolhem o que ver.

Sem roteiro pronto. Tento intercalar 1 demo de memória + 1 demo de skill pra mostrar as duas faces. Se algo travar, vira aula — "olha, exatamente o tipo de coisa que o loop de aprendizado corrige sozinho depois."

ATO 8 · 5 MIN

Como começar hoje

Instalação em poucos minutos. Três portas de entrada.

3 hábitos de quem usa Hermes bem

ATO 9 · 3 MIN

Backup automático no iCloud

Tudo o que faz o Hermes ser ele mesmo — memória, preferências, histórico, skills, estado das conversas — está em uma pasta só: ~/.hermes. Se essa pasta desaparece, o agente some junto.

A SOLUÇÃO É PRAGMÁTICA

Sem serviço pago, sem dependência externa, sem interface. Um script compacta esse diretório e joga no iCloud — o mesmo iCloud que você já tem.

A REGRA É SIMPLES

FREQUÊNCIA

1x por semana

sem intervenção

ESTRATÉGIA

Substituição

sempre só o arquivo mais recente

TAMANHO ATUAL

~80 MB

AGENDAMENTO

Sexta, 19h

crontab do macOS

O QUE ESTÁ NO BACKUP

Os dados que realmente importam — o que permite restaurar o agente com identidade e função intactos.

  • ▸ config.yaml, .env, SOUL.md — identidade e configuração
  • ▸ memories/ — memória de longo prazo
  • ▸ skills/, skills-disabled/ — capacidades do agente
  • ▸ state.db — estado atual das sessões
  • ▸ kanban.db — tarefas e quadro
  • ▸ verification_evidence.db — histórico de verificações
  • ▸ cron/ — tarefas agendadas
  • ▸ auth.json — credenciais locais
  • ▸ logs/ — histórico recente
  • ▸ bin/tirith — binário principal, pra não precisar reinstalar

O QUE FICA DE FORA POR DESIGN

Código e caches descartáveis — recuperáveis via instalação, não restauráveis por cópia.

  • ✕ hermes-agent/ — código fonte, node_modules, venv, apps
  • ✕ cache/, audio_cache/, image_cache/
  • ✕ caches de modelos e índice de contexto
# crontab — roda toda sexta às 19h, sem intervenção $ tar -czf hermes-backup-latest.tar.gz ~/.hermes $ mv hermes-backup-latest.tar.gz ~/Library/Mobile\ Documents/com~apple~CloudDocs/ ✓ ~80 MB · sincronizado no próximo ciclo do iCloud

O QUE VOCÊ GANHA

Abre o iCloud em qualquer lugar e tem ali o estado completo do agente. Não tem escolha, não tem configuração extra, não tem ponto de falha esquecido — ou funciona, ou aparece erro no log.

A FILOSOFIA

Menos decisões, menos pontos de falha, mais confiabilidade real.

VARIANTE · REPOSITÓRIO PRIVADO

A mesma pasta em um repositório Git privado troca cópia por histórico: dá para ver o que a memória aprendeu na semana, qual skill mudou e voltar a um estado anterior — não só ao último arquivo. O custo é lembrar que ali dentro há credencial: .env e auth.json pedem repositório privado e, de preferência, exclusão pelo .gitignore.

iCloud resolve "perdi a máquina". Git resolve "quando foi que ele começou a errar isso?". Dá para ter os dois.

☰ GUIA DE REFERÊNCIA · 10-20 MIN

Instalação e primeiros passos

Um passo a passo didático para instalar o Hermes, conectar um modelo de IA, testar os comandos básicos e saber o que fazer quando algo não funcionar. Pensado para passar adiante — amigos, clientes ou parceiros começam sozinhos.

PARA QUEM É

Quem quer começar sem depender de você para cada passo.

TEMPO MÉDIO

10 a 20 minutos, dependendo do provedor de IA escolhido.

VOCÊ VAI PRECISAR

Terminal, internet e uma conta/chave de algum provedor de IA.

PASSO 1

Instalação

O método mais simples é o instalador oficial: ele prepara Python, dependências e o comando hermes. No Windows, use de preferência PowerShell, Windows Terminal ou Git Bash. No macOS/Linux, o Terminal normal.

A · INSTALADOR RECOMENDADO

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

B · ALTERNATIVA VIA PIP

# se você já usa Python $ pip install hermes-agent

⚠ DEPOIS DE INSTALAR

Feche e abra o terminal novamente para o comando hermes entrar no PATH. Em seguida, confirme:

$ hermes --version ✓ se aparecer uma versão, a instalação funcionou
PASSO 2

Primeira configuração

Rode o assistente de setup: ele ajuda a escolher modelo, provedor e ferramentas. Alguns provedores usam chave de API, outros login OAuth.

# assistente de configuração $ hermes setup # trocar ou revisar o modelo depois $ hermes model # adicionar credenciais OAuth ou chaves de provedor $ hermes auth
Opção Quando usar Observação
Nous Portal Configuração mais simples dentro do ecossistema Nous. Pode usar login em vez de gerenciar várias chaves.
OpenAI Codex OAuth Autenticação OAuth com modelos compatíveis. Útil quando já há login configurado.
OpenRouter Acessar vários modelos com uma chave. Exige OPENROUTER_API_KEY.
Anthropic, Google, DeepSeek, xAI… Usar um provedor específico. Normalmente exige chave de API própria.

🔒 SEGURANÇA

Nunca cole chaves de API ou tokens em grupos públicos. Use os fluxos do próprio Hermes ou variáveis de ambiente.

PASSO 3

Primeiros passos no uso

Com tudo instalado e configurado, abra o chat local e faça um teste simples.

# abrir o chat interativo $ hermes você › Explique em 5 linhas o que você consegue fazer neste computador. # modo uma pergunta só (one-shot), direto do terminal $ hermes chat -q "Crie uma lista de 10 ideias de conteúdo sobre IA para negócios" # verificar se está tudo saudável $ hermes doctor ✓ diagnóstico da instalação
OPCIONAL

Usar pelo Telegram

Uma das partes mais úteis é conversar com o agente por Telegram, Discord, Slack, WhatsApp e outros canais — mesma memória, no seu celular.

# configurar o gateway de mensagens $ hermes gateway setup # rodar o gateway $ hermes gateway run # deixar rodando como serviço em segundo plano $ hermes gateway install

OBSERVAÇÃO

Cada plataforma pode pedir tokens, bot ID ou permissões específicas. Siga o passo a passo que o setup mostrar.

Telegram com tópicos — um assunto, uma conversa

Funciona no privado, mas o arranjo que se sustenta no dia a dia é um grupo com tópicos ativados: Financeiro, Conteúdo, Atendimento. Cada assunto na sua raia, sem virar um fio único de mil mensagens.

⚠ O PASSO QUE TODO MUNDO ESQUECE

No @BotFather: /mybots → seu bot → Bot Settings → Group Privacy → desligue. Com a privacidade ligada, o bot simplesmente não enxerga as mensagens do grupo — e você fica achando que o gateway quebrou.

DEPOIS DISSO

Crie o grupo com Tópicos ativados, adicione o agente e abra um tópico por assunto. Dentro de cada tópico novo, marque o bot e peça para ele liberar aquele espaço.

# dentro do tópico recém-criado, mencione o agente você › @seubot reconheça e libere este tópico pra gente trabalhar aqui ✓ a partir daí o tópico vira um canal de trabalho dedicado

TESTE DE SANIDADE

Antes de seguir, confirme que o caminho inteiro está de pé — modelo, gateway e canal — com uma pergunta só:

você › Você está rodando no modelo que configurei e respondendo aqui pelo Telegram? Responda em uma linha e me diga qual modelo está usando agora.
PASSO 4

Do zero ao agente trabalhando

Instalado e conectado, o agente ainda é genérico. Esta sequência de seis prompts transforma uma instalação vazia em algo que conhece você, conhece o negócio e já executa sozinho. Cada um é para colar como está — o agente conduz o resto perguntando.

A LÓGICA DA SEQUÊNCIA

Segurança primeiro, identidade depois, trabalho por último. Os dois primeiros definem o que ele pode fazer sozinho; os dois do meio, quem ele é; os dois últimos transformam uma tarefa avulsa em rotina que roda sem você.

⚠ UMA RESSALVA HONESTA

O prompt de blindagem pede que o agente mexa em firewall e regras de acesso da máquina. Funciona bem em VPS nova, dedicada ao agente. Em máquina de trabalho com serviços rodando, leia o que ele propõe antes de aprovar — e mantenha um segundo caminho de acesso aberto enquanto testa. Autonomia é ótima; ficar trancado para fora do próprio servidor, não.

REFERÊNCIA

Comandos úteis

NO TERMINAL

hermesAbre o chat interativo.
hermes setupAssistente de configuração.
hermes modelEscolhe ou troca o modelo.
hermes authGerencia logins e credenciais.
hermes doctorDiagnóstico da instalação.
hermes toolsAtiva/desativa ferramentas.
hermes skills listLista habilidades instaladas.
hermes gateway setupConfigura Telegram, Discord, Slack…
hermes updateAtualiza o Hermes.
hermes --helpAjuda geral.

DENTRO DO CHAT

/helpMostra comandos disponíveis.
/newComeça uma nova conversa.
/modelMostra ou troca o modelo.
/toolsGerencia ferramentas.
/skillsPesquisa ou carrega habilidades.
/statusInformações da sessão.
/quitSai do Hermes no terminal.
QUANDO O BÁSICO JÁ RODA

Ampliar o alcance

As ferramentas nativas cobrem web, terminal, arquivos e navegador. O que segue amplia o alcance para os apps onde o trabalho realmente acontece. Vale a regra da parte 12 da Master Class: adicione quando houver um fluxo que exija, não antes.

APPS DE TRABALHO

Composio

Gmail, Calendar, Notion, CRM e centenas de apps por uma conexão só.

LEITURA E COLETA

Firecrawl + Apify

Firecrawl para ler páginas inteiras; Apify para raspar perfis, posts e dados de mercado.

NAVEGAÇÃO

Playwright

O agente abre o site e clica por você — para o que não tem API.

VOZ

ElevenLabs

Resposta falada com voz natural. Para entender seus áudios, ele já usa a API do modelo que você configurou.

RECEITAS PRONTAS

Agent Skills

Especificação aberta de skills e catálogo pronto para puxar: agentskills.io.

CÉREBRO VERSIONADO

Backup no GitHub

Repositório privado com a pasta do agente: além de cópia, vira histórico do que mudou e quando.

⚠ ANTES DE PLUGAR QUALQUER UMA

Toda integração externa é um ponto de falha permanente: chave expira, cota acaba, e a ferramenta some do catálogo sem erro nenhum. Rode hermes tools de tempos em tempos para conferir se a superfície continua inteira.

TROUBLESHOOTING

Problemas comuns

PROBLEMA

hermes não é reconhecido

Feche e abra o terminal. Se continuar, reinicie o computador ou verifique se a pasta do Hermes entrou no PATH.

PROBLEMA

Modelo não responde

Confira se o provedor está autenticado com hermes auth ou se a chave de API foi configurada corretamente.

PROBLEMA

Ferramenta não aparece

Rode hermes tools, ative a ferramenta desejada e comece uma nova sessão.

PROBLEMA

Telegram/gateway não funciona

Use hermes gateway status e confira os logs. Costuma ser token incorreto ou permissão faltando.

# comandos de diagnóstico $ hermes doctor $ hermes status --all $ hermes --help
CHECKLIST FINAL

Antes de considerar concluído

  • ✓ O comando hermes --version funciona.
  • ✓ O comando hermes setup foi executado.
  • ✓ Um modelo/provedor foi configurado.
  • ✓ O chat abre com hermes.
  • ✓ O Hermes responde uma pergunta simples.
  • ✓ hermes doctor não mostra erro crítico.
  • ✓ Se for usar Telegram/WhatsApp/Slack, o gateway foi configurado.

✦ PRONTO

A partir daqui, o melhor jeito de aprender é pedir tarefas pequenas: criar um arquivo, resumir um texto, pesquisar um assunto, organizar uma pasta ou preparar uma automação simples.

Para detalhes sempre atualizados, consulte a documentação oficial: hermes-agent.nousresearch.com/docs.

◈ APROFUNDAMENTO · 12 PARTES

Master Class

Como o Hermes funciona por dentro — do loop do agente aos limites que ninguém conta. Síntese da série Hermes Agent Master Class, publicada por Tony Simons entre 5 e 19 de julho de 2026, cruzada com a masterclass em português organizada por Daniel de Morais Gurgel. Cada parte abaixo linka para os dois.

POR QUE ISSO IMPORTA

O resto desta página mostra o que o Hermes faz. Esta seção mostra por que ele se comporta assim — e é isso que separa quem usa o agente como chatbot de quem usa como infraestrutura.

A trilha, em quatro blocos

As 12 partes são independentes, mas foram escritas para serem lidas em sequência — cada bloco só faz sentido depois que o anterior está de pé.

BLOCO 1 · PARTES 01–03

Como ele pensa

O loop, as escolhas de ambiente que se acumulam e o sistema de aprendizado. É a fundação — sem ela o resto não engrena.

BLOCO 2 · PARTES 04–06

Como ganha capacidade

Skills como procedimento executável, a superfície de ferramentas e o cron que tira o agente do modo reativo.

BLOCO 3 · PARTES 07–09

Como vira ambiente

Gateways de mensagem, delegação para subagentes e o salto para interfaces reais — navegador e desktop.

BLOCO 4 · PARTES 10–12

Como opera em escala

Kanban como coordenação, perfis e painel como administração, e a conversa honesta sobre o que quebra.

POR ONDE COMEÇAR, DEPENDE DE VOCÊ

Nunca usou o Hermes. Partes 01, 02 e 03 — e não pule a 02, é ela que evita a instalação que “funciona” mas nunca acumula.

Quer produtividade rápido. Partes 04, 05, 06 e 07 — skills, ferramentas, cron e mensageiro. É o pacote que muda a rotina em uma semana.

Quer automação avançada. Partes 08, 09, 10 e 11 — subagentes, computer use, quadro e perfis.

Já apanhou de contexto ou complexidade. Leia a 12 cedo. Ela é o fechamento da série, mas resolve dor de quem está no meio dela.

Os cinco princípios por trás do desenho

Nada disso aparece na interface, mas explica quase todo comportamento estranho que você vai encontrar.

01

Prompt estável

Quanto mais fixo o começo do prompt, melhor o cache do provedor funciona — e menor a conta. É por isso que memória e skills mudam entre sessões, não durante.

02

Execução observável

O agente não age no escuro: executa, lê o retorno e decide com base no que aconteceu de verdade. Troca plausibilidade por verificação.

03

Interruptível

Agente útil não é caixa-preta impossível de parar. O loop tolera pausa, retomada e correção de rumo no meio do caminho.

04

Núcleo sem plataforma

CLI, desktop, gateway e cron não são produtos diferentes. São superfícies sobre o mesmo motor — por isso a sessão atravessa todas.

05

Acoplamento fraco

Modelo, provedor, ferramenta, perfil e interface trocam sem derrubar a arquitetura. É o que dá longevidade ao sistema.

A CONSEQUÊNCIA PRÁTICA

Você para de pensar em uma pergunta, uma resposta e passa a pensar em um objetivo, várias etapas, com verificação no meio. É a mudança mental que mais rende.

A rota de adoção — e o teste que quase todo mundo erra

Pular direto para a configuração “completa” parece produtivo e gera uma pilha de problemas difíceis de diagnosticar. A ordem abaixo existe para cada camada apoiar na anterior.

1

Local, primeiro

Instale na sua máquina e pegue intimidade com o comportamento do agente. Resposta imediata, fácil de depurar — e o agente dorme quando o laptop dorme.

2

Valide a base

Memória, sessão e ferramentas funcionando. Enquanto isso não estiver de pé, tudo que você montar em cima vai parecer instável sem motivo aparente.

3

Docker ou remoto

Quando quiser disponibilidade contínua. Com volume persistente montado — sem ele, cada reinício parece um Hermes novo, sem lembrança de nada.

4

Gateway e cron

Só no fim. Mensageiro e agendamento multiplicam o alcance do que já funciona — e multiplicam também o que já estava quebrado.

O TESTE ERRADO DO DIA 1

Quase todo mundo pede um poema sobre IA ou uma explicação sobre banco vetorial, vê uma resposta bonita e conclui que está tudo certo.

Isso testa conversa, não operação. Você ainda não sabe se o agente executa comando, lê arquivo, busca na web ou recupera a sessão de ontem — que é justamente a parte que diferencia o sistema.

O TESTE DE FUMAÇA HONESTO

# 1 · o terminal está vivo? > rode `pwd` e me diga em que diretório você está # 2 · a busca na web está configurada? > pesquise algo factual de hoje e cite a fonte # 3 · o sistema de arquivos responde? > crie um arquivo, leia de volta e confirme o conteúdo # 4 · a sessão sobrevive a um restart? $ hermes -c ✓ passou nos quatro: a fundação está pronta

Os quatro números que governam tudo

90

ITERAÇÕES POR TURNO

Cada chamada de ferramenta consome uma. Tarefa com 20 tool calls gasta 20.

50%

GATILHO DE COMPRESSÃO

Passou da metade da janela, o Hermes resume os turnos do meio. No gateway, 85%.

1.300

TOKENS DE MEMÓRIA

MEMORY.md + USER.md somados. Apertado de propósito — memória custa em todo prompt.

90d

ATÉ O ARQUIVAMENTO

Skill sem uso vira stale em 30 dias e é arquivada em 90. Nada é apagado.

Quando não usar o Hermes

A parte que quase ninguém escreve. O loop do agente cobra overhead — em alguns casos ele não se paga.

GERAÇÃO ÚNICA

Escrever um e-mail, explicar um conceito. Uma chamada direta de LLM é mais rápida e mais barata.

TAREFA SEM FERRAMENTA

"Traduza este parágrafo" não precisa de terminal, busca nem arquivo. Um chat comum resolve.

SAÍDA DETERMINÍSTICA

O loop escolhe ferramentas e ordens diferentes a cada execução. Precisa de resultado reproduzível? Script direto.

LATÊNCIA CRÍTICA

Cada tool call soma raciocínio + execução. Tempo real pede API direta, não agente.

O que pular no dia zero

Cinco recursos que são bons e que quase ninguém precisa no começo. Todos resolvem problemas que você ainda não tem — e cada um adiciona superfície de falha antes da base estar validada.

SERVIDORES MCP

Úteis depois. No dia zero, é mais uma camada de integração sobre uma base que ainda está sendo validada.

ROTEAMENTO MULTI-PROVEDOR

Poderoso e caro em complexidade. Primeiro faça um modelo e um provedor funcionarem bem.

PROCESSAMENTO EM LOTE

Rende muito em alguns cenários, mas é péssimo ponto de partida enquanto o fluxo principal está instável.

PLUGINS PRÓPRIOS

Entram quando você já sabe exatamente o que precisa estender. Antes disso, é solução sofisticada para problema mal definido.

INTEGRAÇÃO ACP COM EDITOR

Excelente depois. Não precisa ser prioridade antes de o núcleo operacional estar validado.

A REGRA POR TRÁS

Não transforme vitória pontual em complexidade permanente. Foi assim que muita instalação impressionante virou coisa que cansa em um mês.

AS TRÊS CAMADAS QUE ACUMULAM

A confusão mais comum é tentar resolver os três problemas no mesmo lugar. Cada camada guarda um tipo diferente de valor — e todas as doze partes voltam a esta divisão.

Memória

O QUE É ESTÁVEL

Fatos duráveis sobre você, o ambiente e as convenções. Pago em todo prompt — por isso é curta de propósito.

Skills

COMO EXECUTAR

Procedimento que já provou funcionar, em markdown. Carregado sob demanda, não em toda sessão.

Kanban

O QUE ESTÁ ABERTO AGORA

Trabalho em andamento que sobrevive à conversa. É o que permite mais de um perfil operar sem se atropelar.

O CHECKLIST DE MANUTENÇÃO

Três hábitos que evitam a maior parte das dores descritas na parte 12 — todos levam menos de cinco minutos.

# 1 · a superfície de ferramentas continua inteira? $ hermes tools # chave expirada some do schema sem erro nenhum # 2 · proteja as skills que você mesmo escreveu $ hermes curator pin <nome-da-skill> # 3 · a sessão sobrevive a um restart? $ hermes -c ✓ se a conversa volta, a persistência está de pé

Extra · CUA remoto no Windows, via Tailscale

O apêndice da masterclass em português é um tutorial fora da curva: como fazer um Hermes rodando numa VPS Linux operar o desktop de uma máquina Windows — e depois o navegador dela. É a parte 09 levada até a última consequência.

O CAMINHO DE CONTROLE

# cada salto é um ponto onde a coisa pode quebrar Hermes Gateway (Linux / VPS) └─ MCP stdio: windows-cua └─ wrapper SSH └─ Tailscale (tailnet privada, sem porta exposta) └─ cua-driver na sessão gráfica do Windows └─ list_windows · click · type_text · launch_app

A PEGADINHA CENTRAL

O SSH do Windows executa na Session 0, que não enxerga janela nenhuma. Sem o cua-driver rodando na sessão gráfica do usuário, list_windows volta vazio e parece bug de configuração.

DEVTOOLS SÓ NA TAILNET

O endpoint CDP do Edge é publicado apenas pelo IP da tailnet — nunca em 0.0.0.0. Porta de DevTools aberta na internet é acesso irrestrito ao navegador e às sessões logadas nele.

O QUE ISSO DESTRAVA

Aplicação nativa sem API, sistema legado, ERP em janela Windows. O agente opera a interface real, com o perfil de navegador já autenticado — e você continua usando a máquina.

O tutorial completo cobre chave SSH nos dois sentidos, ACL no Windows em português, portproxy, firewall, o wrapper MCP, as duas skills de operação e o diagnóstico de browser_route_unavailable. É material de laboratório real, com estado validado.

Abrir o tutorial completo ↗

FONTES

Série original: Hermes Agent Master Class, partes 1 a 12, por @tonysimons_, publicada entre 5 e 19 de julho de 2026.

Masterclass em português, com as 12 partes reescritas e o apêndice de CUA remoto: danieldemoraisgurgel/masterclass-hermes-agent.

O texto desta página é síntese das duas fontes, escrita para leitura em uma sentada. Cada parte linka para o material completo — quando for implementar, vá na fonte.

⬢ BOT MODE · 9 PASSOS

Bots

O Bot Mode transforma os profiles do Hermes em um time de colegas com nome, papel e permanência. Não é uma sessão que você abre e fecha: é gente da casa que continua existindo entre um dia e outro.

O QUE CADA BOT TEM DE PRÓPRIO

Oito coisas que pertencem ao Bot, não à conversa. É essa lista que separa um colega de um chat.

Papel

o trabalho dele

Modelo

e provedor fixados

Memória

que não se mistura

Skills

as do ofício dele

Credenciais

acesso só ao que precisa

Histórico

a conversa inteira

Avatar

cara reconhecível

Rotinas

o que ele faz sozinho

Um time de exemplo

Cinco papéis que cobrem quase tudo o que uma operação pequena precisa. Cada um com o próprio modelo, as próprias skills e o próprio acesso.

🔍 PESQUISADOR

Acha fontes, compara opções e prepara relatórios.

⌨️ DESENVOLVEDOR

Lê repositórios, escreve código e roda testes.

🛡️ REVISOR

Revisa pull requests, olha segurança e caça regressão.

📈 OPERAÇÕES

Monitora sistemas, roda checagens agendadas e reporta incidente.

💬 SUPORTE

Lê chamados, classifica o problema e prepara a resposta.

A REGRA DO TIME

Nenhum Bot tenta fazer tudo. Quando precisa de outra especialidade, ele chama o colega.

Rotinas e delegação, na prática

As rotinas do painel são cron jobs normais do Hermes — e o repasse entre Bots é uma menção dentro do chat, nada além disso.

# rotinas que o Bot é dono $ hermes cron list ✓ operacoes · a cada 1h · checar deploys ✓ operacoes · a cada 15min · varrer jobs que falharam ✓ suporte · dias úteis · revisar tickets do Jira ✓ pesquisador · 07h00 · resumir a caixa de entrada # cada resultado cai no chat do próprio Bot
# passar trabalho para um especialista › @pesquisador compare estes três provedores de API # o Bot ativo repassa, espera e devolve com atribuição # chat em grupo: 2 a 6 Bots, até 3 rodadas › @revisor @desenvolvedor vale migrar esse serviço? ⚠ limites rígidos impedem a sala de conversar sem fim

O DESKTOP É A CAMADA VISUAL. O PROFILE É A FUNDAÇÃO.

Nada do que você monta no Bot Mode fica preso ao aplicativo. Todo Bot continua acessível pelo terminal, com os mesmos arquivos.

# conversar com um Bot fora do Desktop $ hermes -p pesquisador chat # onde vivem arquivos, memória e skills dele $ ls ~/.hermes/profiles/pesquisador/ # e as rotinas dele $ hermes cron list ✓ mesmo agente, mesma memória, outra interface
☿

ENCERRAMENTO

Agente que compõe.

Sem memória, todo dia é dia um. Com o loop fechado, todo dia é dia N — e N cresce sozinho.

01

Memória

Local, editável, sua.

02

Skills

Nascem do uso, não do prompt.

03

Autonomia

/goal transforma chat em operação.

Obrigado. · Perguntas?