Verificando acesso...

Início / Trilha 1 / Módulo 1.1
MÓDULO 1.1

🤖 O que é Hermes Agent

O agente que aprende com você — persistência, memória e automação em background para ampliar o que você faz.

7
Tópicos
~35
Minutos
Básico
Nível
Teoria
Tipo
Hermes + DeepSeek V4 — sistema multi-cérebro com Triad, soul.md, OpenRouter e Gemini CLI.
1

⚡ Hermes vs ferramentas comuns de IA

ChatGPT, Claude.ai, Gemini — todos compartilham uma limitação invisível: cada conversa começa do zero. Hermes Agent inverte essa lógica. Ele lembra de você entre sessões, executa fora do chat e acumula contexto à medida que trabalha.

O que é

Hermes Agent é um agente pessoal persistente — um processo que vive no seu sistema (não numa aba de navegador), mantém memória entre conversas, é orquestrado por um arquivo de identidade (soul.md) e executa tarefas em background sem precisar do seu chat aberto.

✗ Chatbot comum (stateless)

  • Cada conversa começa do zero — sem histórico real
  • Só roda quando você está digitando
  • Você precisa reexplicar contexto toda vez
  • Não aprende com decisões passadas
  • Vive na nuvem do fornecedor, não no seu sistema

✓ Hermes Agent (persistente)

  • Memória real entre sessões em ~/.hermes/memory/
  • Roda em background via cron — mesmo de madrugada
  • Conhece quem você é pelo soul.md
  • Aprende com cada tarefa concluída
  • Vive no seu sistema — você controla tudo

🔑 Conceitos-chave

Stateless vs stateful

Chatbots não retêm estado entre sessões; Hermes retém

Processo local

Hermes roda no seu sistema, não numa aba de navegador remota

Identidade orquestrada

O soul.md define quem o agente acha que você é

Execução em background

Não precisa do chat aberto para o agente trabalhar

2

🧠 Persistência — por que importa que o agente lembre

Persistência não é só "lembrar do nome". É acumular contexto operacional — decisões tomadas, preferências de tom, projetos em andamento, padrões que funcionam para você. Cada interação fica mais útil que a anterior.

O que é

Persistência em Hermes é a capacidade de manter e consultar arquivos de memória de longo prazo — armazenados em ~/.hermes/memory/ — que sobrevivem ao fim da sessão e são automaticamente trazidos para o contexto da próxima execução.

🗂️ Onde a memória mora

  • ~/.hermes/soul.md — quem você é, missão, voz, hard nos
  • ~/.hermes/memory/decisions/ — log datado de escolhas estratégicas tomadas
  • ~/.hermes/memory/observations/ — coisas que o agente notou sobre seu trabalho
  • ~/.hermes/memory/projects/ — estado vivo de cada projeto ativo
  • ~/.hermes/memory/preferences.md — tom, formato, ferramentas preferidas

💡 O que persistência habilita

Você diz "redige no meu tom" e ele sabe o que é seu tom. Você pede "como decidimos o preço daquele plano?" e ele cita a decisão registrada três semanas atrás. Você fala "continue o que parou ontem" e ele continua — sem você reexplicar.

🔑 Conceitos-chave

Memória como arquivos locais

Texto simples no seu disco — auditável, editável, portável

Contexto operacional acumulado

Não é só fatos — são decisões, padrões e preferências em uso

Log de decisões datado

Permite revisitar e auditar o raciocínio por trás de escolhas passadas

Continuidade sem reexplicação

O agente retoma do ponto onde parou na sessão anterior

3

🔀 Hermes vs Claude Code — papéis distintos

Claude Code e Hermes Agent são complementares, não substitutos. Claude Code é o operário do código; Hermes é o agente da sua vida e do seu negócio. Confundir os dois é o erro mais comum de quem começa.

O que é

Claude Code é uma CLI focada em sessões de desenvolvimento com contexto de projeto (código, arquivos, repositório). Hermes é um agente sempre-ligado, focado em decisões, conhecimento pessoal e automações de longo prazo — usa Claude Code como ferramenta quando precisa codar.

🛠️ Claude Code

  • Escopo: repositório / projeto de código
  • Duração: sessão (você invoca, ele roda, termina)
  • Memória: CLAUDE.md por projeto
  • Gatilho: você digita um comando
  • Otimizado para: escrever, ler, editar código

🤖 Hermes Agent

  • Escopo: sua vida, negócio, conhecimento
  • Duração: contínua (cron + on-demand)
  • Memória: soul.md + ~/.hermes/memory/
  • Gatilho: hora, evento, ou você
  • Otimizado para: decisões, pesquisa, conteúdo, rotinas

💡 Como eles se combinam

Hermes pode invocar Claude Code como ferramenta. Exemplo: às 6h da manhã, Hermes acorda, lê seus emails de produto, decide que há um bug crítico reportado e chama Claude Code dentro do repo certo para investigar — quando você acorda, tem o diagnóstico pronto.

🔑 Conceitos-chave

Sessão vs sempre-ligado

Claude Code roda quando chamado; Hermes vive em background

Escopo de projeto vs vida

Claude Code conhece o repo; Hermes conhece você

Hermes invoca Claude Code

O agente usa Claude Code como ferramenta quando código entra em cena

CLAUDE.md vs soul.md

Documentos de identidade em escopos diferentes — projeto vs pessoa

4

📈 Como Hermes aprende com cada tarefa

Hermes não fica mais inteligente sozinho — ele fica mais útil porque escreve observações sobre seu trabalho e essas observações entram no contexto da próxima execução. É um loop fechado: tarefa, execução, reflexão, memória atualizada.

O que é

O loop de aprendizado de Hermes é um ciclo em quatro fases — receber tarefa, executar, refletir sobre o que funcionou ou não, atualizar arquivos de memória — que faz cada tarefa subsequente ter mais contexto que a anterior, sem treinamento de modelo.

1

Recebe a tarefa

Você fala ou um trigger dispara. Hermes carrega soul.md, memórias relevantes e contexto recente antes de pensar no que fazer.

2

Executa

Usa ferramentas (browser, shell, Claude Code, APIs) para realizar a tarefa. Cada passo é registrado num log temporário da execução.

3

Reflete

Ao final, Hermes gera uma observação curta: o que funcionou, o que falhou, qual padrão emergiu, qual preferência ficou clara. Essa reflexão é o sinal de aprendizado.

4

Atualiza a memória

A observação vira um arquivo datado em ~/.hermes/memory/observations/. Se for uma preferência consolidada, é promovida ao soul.md. A próxima execução já consulta esses arquivos.

🔑 Conceitos-chave

Aprendizado sem fine-tuning

O modelo não muda — o contexto carregado a cada execução muda

Reflexão como sinal

O passo de reflexão é o que separa execução de aprendizado

Observações datadas

Cada aprendizado tem timestamp — permite auditar evolução

Promoção ao soul.md

Padrões repetidos sobem da observação para a identidade do agente

5

🌙 Agendamento em background — trabalhe enquanto dorme

O diferencial mais subestimado de Hermes: ele não precisa de você acordado. Cron jobs disparam o agente em horários definidos. Quando você abre o laptop pela manhã, o trabalho noturno já está esperando — briefings, pesquisas, drafts, alertas.

O que é

Agendamento em background é a capacidade de Hermes ser disparado por cron (ou systemd timer / launchd) em horários ou intervalos definidos, executar tarefas longas usando modelos baratos como DeepSeek, e deixar o resultado pronto para sua revisão na próxima vez que olhar.

Exemplo de crontab

# briefing matinal — 6h da manhã, todo dia

0 6 * * * hermes morning-briefing

# resumo dos emails da noite — 23h

0 23 * * * hermes inbox-digest

# pesquisa profunda noturna — 2h, segunda a sexta

0 2 * * 1-5 hermes deep-research --topic-from queue

# revisão semanal — domingo 19h

0 19 * * 0 hermes weekly-review

🌙 O que cabe rodar de madrugada

  • Pesquisa profunda: 200 fontes lidas por DeepSeek em horas, sintetizadas em relatório curto. Custo: dólares, não dezenas.
  • Drafts de conteúdo: 5 versões de post, newsletter ou ensaio prontos para você editar pela manhã.
  • Monitoramento: mudanças em preços de concorrentes, menções da sua marca, novos commits em repos que você acompanha.
  • Tarefas chatas de código: migração de dependência, refatoração de testes, upgrade de versão — Hermes chama Claude Code.
  • Briefings personalizados: calendário do dia, notícias filtradas, lembretes acionáveis — entregues às 6h.

💡 Por que isso é uma virada de chave

Sua produtividade deixa de ser limitada pelo seu tempo desperto. 8 horas de sono viram 8 horas de trabalho do agente. Ao acordar, você não começa um dia — você continua um.

🔑 Conceitos-chave

Cron como gatilho

Hermes não precisa de chat aberto — qualquer scheduler do SO o dispara

Modelo barato para tarefa longa

DeepSeek e similares deixam pesquisas de horas viáveis em custo

Resultado pronto pela manhã

Você consome trabalho terminado, não inicia trabalho do zero

ScheduleWakeup e similares

Em macOS/Linux, é possível acordar a máquina só para a tarefa

6

👤 O modelo profundo de quem você é

Sem o soul.md, Hermes é só mais um LLM bem embrulhado. Com ele, vira um agente que entende sua missão, seu jeito de falar e o que você se recusa a fazer. É o multiplicador silencioso do sistema.

O que é

O soul.md é um arquivo markdown vivo — geralmente em ~/.hermes/soul.md — que descreve identidade, missão atual, voz/tom, valores não-negociáveis e contexto operacional do usuário. É carregado automaticamente em todo prompt do agente.

📜 Anatomia de um soul.md

  • Identidade: quem você é em uma frase honesta — não título de LinkedIn, papel real.
  • Missão atual: o que você está construindo agora, com prazo e critério de sucesso.
  • Voz: como você escreve — exemplos de frases suas, palavras que você nunca usa.
  • Hard nos: o que o agente jamais deve fazer em seu nome — limites éticos, formatos proibidos, decisões fora do escopo.
  • Contexto operacional: negócios ativos, ferramentas usadas, pessoas-chave, restrições.

💡 Tip crítico

O soul.md é o multiplicador — sem ele, Hermes é só mais um LLM. Invista uma tarde escrevendo-o como se fosse o briefing para um chefe-de-gabinete novo. Atualize-o quando perceber o agente errando o tom: o erro está no soul.md, não no prompt da tarefa.

🔑 Conceitos-chave

Identidade explicitada

O que está implícito na sua cabeça precisa estar escrito para o agente

Hard nos como guard-rails

Lista explícita do que o agente nunca deve fazer em seu nome

Documento vivo

Atualizado conforme você evolui e o agente desafina — não é estático

Multiplicador silencioso

Sem soul.md, todo o resto do sistema produz resultado genérico

7

💼 Casos de uso reais

Teoria sem cenário concreto evapora. Aqui estão cinco aplicações reais que pessoas estão rodando com Hermes hoje — cada uma combinando persistência, agendamento e o soul.md de formas diferentes.

O que é

Casos de uso reais são padrões de aplicação de Hermes — cada um materializa um arranjo específico de trigger (cron, evento, comando), modelo (DeepSeek para volume, Claude para nuance) e memória (qual subconjunto carregar) — que resolvem uma fricção recorrente da vida ou do negócio.

A

Briefing matinal personalizado

Às 6h, Hermes lê calendário, inbox e feeds escolhidos, filtra pelo soul.md (o que importa para sua missão atual) e entrega um documento de 1 página: 3 prioridades do dia, 2 conflitos de agenda, 1 alerta. Acende a tela e seu dia começa com mira.

B

Pesquisa profunda noturna

Você joga um tópico na fila antes de dormir. Às 2h, Hermes dispara DeepSeek contra 100–300 fontes, sintetiza num relatório com citações e marca pontos onde precisa do seu julgamento. De manhã, 6 horas de pesquisa custaram poucos dólares.

C

Drafts de social e newsletter

Hermes lê suas observações da semana, cruza com a voz definida no soul.md e produz 5 drafts de post + 1 esqueleto de newsletter — todos atravessados pelo seu tom, não pelo tom genérico do modelo. Você só edita.

D

Decisão de negócio com histórico

Você pergunta "vale aumentar o preço do plano Pro?". Hermes consulta decisões anteriores sobre pricing, observações sobre churn recente, dados de uso e devolve um memo curto com 3 cenários. Cita as fontes internas — você confere a memória dele.

E

Code review e manutenção

Hermes monitora repositórios escolhidos. Quando um PR encosta no que ele sabe que é frágil (registrado em observações passadas), invoca Claude Code para revisar e comenta no PR — você só aprova ou refuta.

🎯 O padrão por trás dos cinco

Cada caso combina três peças: memória (sabe quem você é e o que já decidiu), trigger (alguma coisa que não é você acorda o agente) e delegação correta de modelo (Claude para nuance, DeepSeek para volume, Claude Code para código). Toda aplicação interessante de Hermes encaixa nesse padrão.

🔑 Conceitos-chave

Padrão memória + trigger + modelo

Toda aplicação útil de Hermes combina essas três peças

Briefing como ritual

Trocar o feed infinito por um briefing focado às 6h

Pesquisa noturna barata

Volume durante o sono usando modelo de baixo custo

Decisão com memória citável

O agente justifica respostas com pedaços do seu próprio histórico

Resumo do Módulo

Hermes é um agente persistente — não um chatbot. Vive no seu sistema, lembra entre sessões e roda em background
Memória em ~/.hermes/memory/ — soul.md, decisões, observações e projetos como arquivos locais auditáveis
Hermes ≠ Claude Code — Claude Code cuida do repo; Hermes cuida da vida e do negócio. Hermes invoca Claude Code quando precisa codar
Loop de aprendizado — recebe, executa, reflete, atualiza memória. Cada tarefa torna a próxima mais útil
Agendamento via cron — pesquisas e drafts durante o sono usando modelos baratos como DeepSeek
soul.md é o multiplicador — sem ele, Hermes é só mais um LLM. Identidade, missão, voz e hard nos definem a diferença

Próximo Módulo:

1.2 — O problema de um único modelo