🌱 Fundamentos do Hermes

Hermes Agent é um projeto open source da Noose Research, distribuído sob licença MIT. É um dos agentes IA open source que mais cresceu no GitHub recentemente.

Entender a origem ajuda a calibrar expectativa: comunidade ativa, ritmo de releases rápido, sem vendor lock-in. Você pode rodar offline, modificar, vendê-lo embutido em produto.

Open source ≠ gratuito de operar (você ainda paga inferência e hosting). MIT permite uso comercial. Noose Research é a mantenedora principal, mas a contribuição é distribuída.

Hermes já vem com 91 skills instaladas por padrão e acesso a um hub com mais de 520 skills da comunidade, incluindo 16 skills oficiais da Anthropic.

Você não começa do zero. Boa parte do que precisa para tarefas comuns já está pronto: GitHub auth, gerenciamento de repos, abertura de dashboard, automação de navegador, geração de imagens.

Skill = procedimento reutilizável em Markdown. Hub = catálogo público. Você instala uma skill colando o link e pedindo ao agente para usar.

O agente já entende imagens, automatiza navegador, gera imagens, fala (TTS), executa comandos no terminal, planeja tarefas e responde com áudio no Telegram.

Saber o que ele já faz evita reinventar a roda. Você pede a tarefa em linguagem natural e ele decide qual ferramenta usar. Não precisa codar integração para o básico.

Voice notes pelo Telegram são úteis para resumos longos. Browser automation funciona pra preencher formulários e raspar páginas. TTS substitui leitura quando você está dirigindo.

Hermes pode receber e responder em Telegram, Discord, Slack, WhatsApp ou iMessage. Telegram é o caminho recomendado para começar pela facilidade do BotFather.

Mensageria é o que transforma o agente de "ferramenta no terminal" em "assistente sempre comigo". Sem isso, você só usa quando está no computador.

Cada plataforma tem fricção própria. Telegram = bot token via BotFather. Discord = bot token via developer portal. WhatsApp = mais complicado, geralmente via gateway tipo Whapi.

Hermes melhora quando o aprendizado é persistido como memória, skills e histórico pesquisável. Não é mágico — você tem que corrigir, salvar processos e refinar.

Esse é o diferencial frente a chatbots stateless. Quanto mais você usa, mais alinhado fica. Tarefas repetidas viram skills, preferências viram memória, sessões antigas viram contexto pesquisável.

"Memória = o que lembrar. Skill = como fazer." Sessões ficam em SQLite. Você precisa nudgar: "salva isso na memória", "transforma em skill", "não repete esse erro".

Hermes não substitui Claude Code; eles se complementam. Claude Code é o cockpit do código (terminal + projeto). Hermes é o controle remoto (Telegram + crons). OpenCode fica entre os dois.

Escolher a ferramenta errada gera atrito. Tentar usar Hermes para hardcore coding é frustrante. Tentar usar Claude Code para agendar tarefas no celular também.

Use Claude Code sentado no PC, com tempo. Use Hermes em movimento, via Telegram. Mantenha um GitHub repo central com contexto, skills e configs — qualquer agente aponta pra ele.

Quando você pede algo que ele não sabe fazer, ele pode pesquisar na própria documentação, em links de X/Twitter ou em URLs que você fornecer.

Reduz drasticamente a curva de aprendizado. Você não precisa decorar comandos, sintaxe de cron ou estrutura de skills. Pergunta e ele acha.

Frase mágica: "Pesquise como fazer X e me diga o que você precisa de mim." Ele lê, planeja e te faz as perguntas certas no caminho.

Você cola um link de post no X, de um repositório ou de uma doc, e pede para ele ler e tentar implementar a ideia ou ferramenta no seu ambiente.

Esse fluxo "vi uma demo legal → cola → testa" acelera experimentação. Você converte conteúdo em capacidade real do seu agente em minutos.

Sempre revise antes de aprovar permissões permanentes. Nem tudo o que aparece no X é seguro ou aplicável ao seu setup.

Quando algo quebra (Telegram não responde, .env errado, cron falha), você cola o erro ou descreve o sintoma e pede pra ele diagnosticar.

Não vire refém de tutoriais. Boa parte dos problemas comuns o próprio Hermes resolve checando processos, reiniciando serviços ou consultando a doc.

Quanto melhor você descreve o sintoma (qual comando, qual mensagem, em qual contexto), melhor o diagnóstico. "Não funciona" raramente basta.

Não tente configurar tudo no primeiro dia. Suba o agente, conecte Telegram, crie um cron simples (backup) e use por alguns dias antes de empilhar mais.

Configuração ambiciosa de uma vez vira frankenstein difícil de debugar. Cada peça nova testada isoladamente é mais fácil de manter.

Princípio: "primeiro que funcione, depois que melhore." MVP do agente: Telegram + GitHub + 1 cron de backup. Resto vem com uso real.

Mentalidade de onboarding: você não dá acesso total a um estagiário no dia 1. Mesma coisa com o Hermes — comece com escopos limitados, expanda conforme confiança aumenta.

Reduz blast radius se algo der errado. Tokens com escopo apertado, contas separadas, IPs travados, permissões revogáveis.

Princípio do menor privilégio. Cada agente com sua chave nomeada. AgentMail ou Gmail dedicado. Nunca a sua conta principal.

O agente não termina de ser configurado. Cada erro é oportunidade de atualizar memória ou skill. Cada acerto é candidato a virar processo reutilizável.

Quem trata Hermes como ferramenta estática nunca aproveita o melhor dele. Quem trata como colega que aprende, vê o agente ficar mais útil mês a mês.

Regra dos 2 erros: errou duas vezes → atualiza skill ou memória. Repetiu instrução → vira skill. Tom errado → ajusta soul.

VPS é um computador alugado na nuvem com IP público, ligado 24/7. Hostinger tem auto-deploy de Hermes em 1 clique. Hetzner e DigitalOcean são alternativas mais cruas.

É o ambiente padrão para crons confiáveis. Sua máquina pode dormir, o VPS não. Você acessa de qualquer lugar via SSH ou Telegram.

KVM 2 do Hostinger (~$100/ano) cabe múltiplos agentes. Ubuntu 24.04 LTS é o padrão. Backup automático diário é praticamente obrigatório.

Docker isola o Hermes em um container, com seu próprio .env, suas próprias chaves e seu próprio sistema de arquivos. O VPS é o prédio, o container é a sala.

É o caminho recomendado. Você roda múltiplos agentes (pessoal, marketing, financeiro) sem misturar chaves nem memória. Atualizações são mais limpas.

.env do container ≠ .env do VPS. O Hermes lê o do container. Comando: hermes config set GITHUB_TOKEN xxx escreve em /opt/data/.env.

Você instala localmente no Mac/Linux. Funciona quando o laptop está ligado, conectado à internet e desbloqueado.

Bom pra desenvolvimento, teste de skills e exploração inicial. Ruim pra crons sérios — o agente "morre" toda vez que você fecha a tampa.

Use o laptop pra prototipar. Quando o agente provar valor, migre para VPS. Skills, memória e configs são só Markdown — migração é commit + clone.

Um Mac Mini barato (M1/M2 usado) ligado 24/7 em casa funciona como mini-VPS. Você acessa via SSH/Tailscale e tem performance local boa para modelos pequenos.

Custo de operação tende a zero (já tem energia em casa). Excelente pra rodar Qwen ou LLaMA local sem pagar cloud GPU.

Atenção a quedas de luz, internet residencial instável e dynamic DNS. Tailscale resolve a parte de rede sem expor IP público.

Termux é um emulador de terminal Linux pra Android. Dá pra rodar o Hermes literalmente dentro do celular, sem cloud.

Cenários offline, viagem, baixa privacidade exigida. Útil pra demos rápidas ou ambientes restritos sem acesso a VPS.

Não substitui VPS pra produção. Bateria, kill de background pelo Android e limites de recurso são reais.

Crons importantes? VPS+Docker. Só dev e teste? Laptop. Privacidade extrema + modelo local? Mac Mini ou desktop com GPU. Edge case offline? Termux.

90% dos casos terminam em VPS+Docker. Saber isso evita perder dia tentando viabilizar laptop pessoal pra coisas que precisam de uptime.

Comece simples (laptop), valide o uso, migre pra VPS quando o uso virar parte da rotina. Migração é trivial: skills e memória são só Markdown versionado.

Resumo diário de prioridades às 8h, lembretes contextuais ("avisa eu de X amanhã às 14h"), pesquisas rápidas, leitura assistida de textos longos.

É o caso de uso de menor risco e maior retorno percebido. O agente fica útil em 1 dia. Você cria hábito.

Crons curtos (manhã, fim do dia, sextas). Tudo via Telegram. Sem precisar GPU local.

Cron monitorando comentários de YouTube/Instagram, sugerindo respostas dentro do tom da marca, mantendo um calendário editorial vivo.

Marketing é onde "agente proativo" mais economiza tempo. Você vira revisor, não criador-do-zero.

Soul.md fica mais importante aqui — define o tom da marca. Skills específicas: "responder comentário tipo X", "sugerir thread sobre Y".

Cron lendo planilhas, banco ou API financeira, gerando resumo semanal, alertando sobre vencimentos e anomalias de custo.

Substitui muita planilha manual. Reduz "esqueci de pagar X" a zero. Cabe perfeitamente em agente separado pelo princípio do menor privilégio.

Agente financeiro deve ter chaves diferentes do agente pessoal. Permissões mínimas. Alertas via Telegram em canal privado.

Hermes lendo email/tickets, classificando, sugerindo resposta com base em FAQ ou histórico de cliente, escalando o que for crítico.

Volume alto de mensagem repetida é o pior gargalo de operação pequena. O agente filtra e sobra tempo pra casos não-padrão.

Soul deve ser empático e profissional. Memória deve carregar FAQ. Agente nunca responde sozinho sem revisão no início.

Cron de auditoria semanal: portas abertas, processos suspeitos, espaço em disco, logs anormais. Backup diário automático.

Você não esquece de manter o ambiente saudável. Fica mais seguro sem precisar virar SRE.

Skill "auditoria de segurança" é uma das mais úteis. Combine com firewall em camada externa (Hostinger Upguard ou ufw).

Skills para revisar texto no seu estilo, gerar variações para A/B, sugerir tópicos baseados em conteúdo passado, montar newsletter semanal.

Reduz a fricção do "página em branco". Mantém consistência de voz. Cron transforma "fazer newsletter" em "revisar a newsletter que o agente já preparou".

Soul.md = sua voz. Memory.md carrega exemplos de bons textos seus. Skill "revisar texto" deve preservar voz, não homogeneizar.