Hermes Agent: como instalar e usar do zero

O Hermes Agent fica interessante quando deixa de ser chat e ganha memória, ferramentas e uma rotina. Ele pode pesquisar, trabalhar com arquivos, conversar pelo Telegram, consultar serviços conectados e executar tarefas em horários definidos.

Mas eu não começaria ligando tudo.

Minha leitura é simples: um agente pessoal precisa crescer por camadas. Primeiro responde. Depois usa uma ferramenta. Em seguida aprende preferências. Só então recebe uma integração e uma automação. Essa ordem parece mais lenta durante a instalação e economiza muito tempo quando algo quebra.

Este guia foi construído a partir do curso para iniciantes publicado por Tech With Tim em 5 de junho de 2026 e conferido na documentação oficial do Hermes Agent em 9 de setembro de 2026. O vídeo usa uma VPS, Telegram, browser, GitHub, Composio e tarefas agendadas. Eu mantive o que continua útil e ajustei os pontos em que segurança e verificação precisam ser mais rigorosas.

O que é o Hermes Agent?

O Hermes Agent é um agente de IA pessoal e extensível desenvolvido pela Nous Research. Ele pode rodar no computador, em uma máquina virtual privada, a VPS, ou em outros ambientes de execução. Se o conceito ainda parece abstrato, eu expliquei também o que são agentes de IA e como skills dão procedimentos a esses agentes.

Um chatbot recebe uma pergunta e produz uma resposta. O Hermes também pode escolher ferramentas e avançar uma tarefa. Para isso, o sistema combina seis peças:

• modelo: interpreta o pedido e decide os próximos passos;
• ferramentas: permitem usar terminal, arquivos, pesquisa, browser e serviços externos;
• memória: preserva fatos importantes entre sessões;
• skills: guardam procedimentos reutilizáveis;
• SOUL.md: define identidade, princípios e estilo do agente;
• cron: agenda tarefas e cria comportamento proativo.

Eu gosto de pensar no Hermes como um profissional novo entrando na empresa. O modelo é a capacidade de raciocínio. As ferramentas são os sistemas aos quais ele tem acesso. A memória é o que ele aprendeu. As skills são os procedimentos. O SOUL.md descreve a postura. As tarefas agendadas são a rotina.

Dar todas as senhas no primeiro dia seria estranho com uma pessoa. Também deveria ser estranho com um agente.

É melhor instalar no computador ou em uma VPS?

Para aprender e testar, eu começaria no computador. É mais fácil observar o que acontece, interromper uma ação e corrigir a configuração.

Uma VPS faz sentido quando o objetivo é manter o Hermes disponível 24 horas por dia, receber mensagens pelo Telegram e executar rotinas mesmo com o notebook desligado. O vídeo demonstra esse caminho usando a Hostinger, mas o Hermes não depende desse fornecedor. Qualquer servidor compatível pode funcionar.

Minha comparação prática fica assim:

• Computador local: bom para aprendizado, testes e arquivos locais; para quando a máquina desliga.
• Hermes Desktop: bom para uso local com interface gráfica; continua dependente da máquina local.
• VPS: boa para Telegram e automações 24/7; exige segurança e manutenção do servidor.
• Contêiner: bom para isolar melhor as ações de terminal; adiciona uma camada de configuração.

Eu não escolheria a VPS pela promessa de “agente autônomo”. Eu escolheria pela necessidade concreta de disponibilidade.

Como instalar o Hermes Agent

A documentação oficial de instalação oferece um instalador para macOS, Linux, WSL2 e Windows nativo.

macOS, Linux ou WSL2

Abra o terminal e execute:

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

Depois, recarregue o shell. No macOS com Zsh:

source ~/.zshrc

Com Bash:

source ~/.bashrc

Windows

Abra o PowerShell e execute:

iex (irm https://hermes-agent.nousresearch.com/install.ps1)

Abra um novo terminal quando o instalador terminar.

Hermes Desktop

Quem prefere interface gráfica pode usar o instalador do Hermes Desktop. Se o CLI já estiver instalado, o comando atual é:

hermes desktop

Valide antes de configurar mais coisas

hermes --version
hermes doctor

O primeiro comando confirma que o executável está disponível. O segundo procura dependências e configurações quebradas.

Eu não considero a instalação pronta porque o script terminou com código zero. A validação real acontece quando o modelo responde e uma ferramenta executa uma tarefa simples.

Como escolher o modelo e concluir a configuração

O caminho completo é:

hermes setup

Quem usa o Nous Portal pode seguir o fluxo rápido:

hermes setup --portal

Para trocar apenas o modelo ou o provedor:

hermes model

O quickstart oficial lista provedores como Nous Portal, OpenAI Codex, Anthropic, OpenRouter, Google AI Studio, xAI, DeepSeek, Hugging Face e endpoints compatíveis com OpenAI. A lista muda com o produto, então eu consultaria o menu atual em vez de copiar uma combinação antiga de vídeo.

Para a primeira configuração, use um provedor. Não ative fallback, roteamento e múltiplos modelos antes de provar o caminho básico.

Inicie o chat:

hermes

Ou a interface moderna no terminal:

hermes --tui

Eu faria três testes:

1. Responda apenas: Hermes funcionando.
2. Liste as ferramentas disponíveis nesta sessão.
3. Crie um arquivo teste-hermes.txt com a frase instalação validada e confirme o caminho.

O aceite é objetivo: resposta do modelo, ferramenta disponível e arquivo realmente criado.

Como configurar memória e personalidade

O vídeo acerta ao destacar memória e skills como parte central do Hermes. Sem contexto persistente, o agente volta a ser um chat que precisa reaprender tudo.

Há três camadas que eu separaria.

USER.md

Guarda preferências estáveis do usuário: idioma, fuso, formato de relatório e estilo de comunicação.

MEMORY.md

Guarda fatos operacionais e aprendizados que precisam atravessar sessões. A documentação de memória recomenda uma memória curta e curada, não um depósito de transcrições e tarefas temporárias.

SOUL.md

Define a identidade e os princípios do agente. Um exemplo inicial:

# Identidade
Você é um assistente prático, cuidadoso e direto. # Estilo
Responda em português brasileiro e comece pelo resultado. # Princípios
Não invente dados.
Separe sugestão de ação executada.
Peça confirmação antes de enviar, publicar, comprar ou apagar.

Uma boa primeira conversa seria:

Faça dez perguntas curtas para entender meu trabalho, minhas prioridades,
meu estilo de comunicação e meus limites de autonomia. Depois, proponha
atualizações separadas para USER.md e SOUL.md. Mostre antes de salvar.

Eu não colocaria regras de um projeto específico no SOUL.md. Identidade é uma coisa. Contexto de projeto é outra.

Como conectar o Hermes ao Telegram

O Telegram transforma o Hermes em um assistente acessível pelo celular.

No Telegram, abra a conta oficial @BotFather, envie /newbot, escolha o nome e um username terminado em bot. O BotFather devolverá um token.

Esse token controla o bot. Não publique, não inclua em prints e não coloque no GitHub.

No terminal, execute:

hermes gateway setup

Selecione Telegram, informe o token e restrinja o acesso ao seu ID por allowlist ou pairing. Depois:

hermes gateway start
hermes gateway status

Se o gateway já estiver sendo supervisionado pelo macOS ou Linux, eu não abriria uma segunda instância em primeiro plano. Usaria:

hermes gateway restart

A configuração oficial do Telegram também explica grupos, modo de privacidade, voz, webhooks e tópicos.

O teste mínimo é enviar /start, pedir uma resposta curta e confirmar que uma conta não autorizada não consegue acionar o agente.

Como habilitar browser, imagens e voz

O browser permite abrir páginas, pesquisar, capturar telas e interagir com sites. Comece com leitura:

Abra https://example.com, capture uma tela e descreva o título e o conteúdo.
Não clique em links e não envie formulários.

Se o runtime do navegador estiver ausente, rode hermes doctor e siga o diagnóstico. A versão atual também pode oferecer browser em nuvem pelo Tool Gateway.

Com um modelo multimodal, o Hermes pode analisar imagens. No Telegram, ele também pode transcrever mensagens de voz e responder em áudio, dependendo do mecanismo de speech-to-text e text-to-speech configurado.

Eu testaria voz assim:

Transcreva esta mensagem, identifique os pedidos e não execute nenhuma ação.

O final da frase importa. Transcrever é leitura. Executar é outra alçada.

Como conectar Gmail, agenda e outras ferramentas

O vídeo usa o Composio para ligar Gmail, Google Calendar e outros aplicativos ao Hermes. A ideia é criar uma ponte de ferramentas sem implementar cada API manualmente.

Aqui eu mudaria uma recomendação do vídeo. O autor sugere conceder todas as permissões e restringir depois. Para uso real, eu faria o contrário: menor privilégio desde a primeira autenticação.

Se o objetivo é resumir e-mails, comece com leitura. Enviar, apagar ou arquivar só deve aparecer quando houver um caso real e uma confirmação humana.

Minha sequência de teste seria:

1. listar os assuntos dos dois e-mails mais recentes, sem abrir anexos;
2. mostrar os próximos três compromissos, sem alterar a agenda;
3. preparar um rascunho de evento, sem salvar nem convidar ninguém;
4. informar qual ferramenta e qual conta foram usadas.

O agente só deveria ganhar escrita depois de acertar leitura, identidade da conta e tratamento de erro.

Como criar uma automação útil

O principal exemplo do vídeo é uma triagem diária de e-mail. Eu escreveria o pedido assim:

Crie uma tarefa agendada para todos os dias às 7h no fuso America/Sao_Paulo. Leia os e-mails recebidos nas últimas 24 horas e produza um resumo curto com:
- mensagens que exigem ação minha;
- prazos explícitos;
- remetentes prioritários;
- riscos ou bloqueios. Não envie, responda, arquive nem exclua mensagens. Não abra anexos.
Entregue o resumo no Telegram. Se a conta estiver indisponível, informe falha
de acesso em vez de gerar um resumo vazio. Faça um teste manual e mostre a
definição do agendamento antes de ativar.

Esse prompt tem horário, fuso, fonte, janela, formato, destino, limites e comportamento de falha. Isso faz a diferença entre uma demo e uma rotina verificável.

Outros bons primeiros casos:

• briefing matinal com agenda e tarefas;
• revisão semanal de pendências;
• relatório diário do que o agente realmente executou;
• auditoria da VPS;
• quiz de aprendizado;
• monitoramento que avisa somente quando algo muda.

Eu começaria com leitura e resumo. Depois passaria para rascunho. Envio, alteração e exclusão ficariam por último.

Como fazer backup sem vazar credenciais

O vídeo sugere um repositório privado no GitHub para versionar memória, skills, configuração e tarefas agendadas. A recuperação fica mais fácil, mas “backup de tudo” é uma instrução perigosa.

Podem entrar SOUL.md, skills próprias, definições de automação e configurações sem credenciais.

Não devem entrar .env, tokens, chaves de API, auth.json, cookies, sessões, credenciais OAuth, arquivos de pairing e transcrições sensíveis.

Eu usaria um repositório privado e uma credencial limitada a esse repositório. Antes do primeiro push, buscaria padrões como TOKEN, KEY, SECRET, PASSWORD e AUTH.

As seis travas antes de deixar o Hermes rodar sozinho

Meu framework para colocar um Hermes em produção é a escada R.A.S.T.R.O.:

1. R de resultado pequeno: uma tarefa com saída verificável.
2. A de acesso mínimo: só os dados e ferramentas necessários.
3. S de simulação manual: executar agora antes de agendar.
4. T de trava humana: aprovação antes de enviar, pagar, publicar ou apagar.
5. R de registro: guardar evidência de entrada, ação e resultado.
6. O de observação: acompanhar as primeiras execuções antes de ampliar.

Se eu não consigo ver o rastro, eu não chamo de autonomia. Chamo de falta de supervisão.

A documentação de segurança recomenda controles como allowlists, pairing, isolamento por contêiner e proteção de credenciais. Para o terminal, uma opção é:

hermes config set terminal.backend docker

Contêiner reduz o alcance de algumas ações, mas não corrige uma credencial ampla nem impede uma integração externa de fazer exatamente o que foi autorizado.

Também trataria e-mails, páginas e documentos como dados, não como instruções. Um texto externo pode tentar convencer o agente a ignorar regras. Isso é prompt injection.

Checklist final

• Hermes responde com o modelo escolhido.
• hermes doctor não mostra erro crítico.
• Uma ferramenta simples foi testada de ponta a ponta.
• Telegram aceita somente usuários autorizados.
• USER.md, MEMORY.md e SOUL.md têm papéis separados.
• A primeira integração começa em modo de leitura.
• Nenhuma credencial foi versionada.
• A automação foi executada manualmente antes do agendamento.
• Falha de fonte aparece como falha, não como resultado vazio.
• Ações externas sensíveis param para aprovação.

Perguntas frequentes

Preciso saber programar para usar o Hermes Agent?

Não para o fluxo básico. O instalador, o assistente de configuração e a interface conversacional cobrem boa parte do trabalho. Conhecimento de terminal ajuda no diagnóstico, principalmente em VPS, integrações e automações.

Preciso de uma VPS?

Não. O Hermes funciona localmente. A VPS é útil quando você quer disponibilidade contínua, Telegram e tarefas agendadas com o computador desligado.

O Hermes Agent é gratuito?

O projeto é aberto, mas o uso pode gerar custos de VPS, provedor de modelos, browser em nuvem, voz e integrações. Consulte os preços atuais de cada serviço antes de automatizar em volume.

O Hermes pode acessar meu Gmail e minha agenda?

Pode, por meio de ferramentas e integrações autorizadas. Eu começaria com leitura, uma conta de teste e escopos mínimos. Envio, exclusão e alteração exigem mais controle.

O Hermes aprende sozinho?

Ele pode registrar memórias e criar ou aprimorar skills. Isso não significa que todo aprendizado está correto. Memória e skills precisam de revisão, principalmente quando afetam decisões futuras.

Qual é a primeira automação que vale testar?

Um resumo diário somente de leitura. É fácil de observar, tem baixo risco e mostra rapidamente se fontes, fuso, canal e formato estão configurados direito.

Minha conclusão

Eu não instalaria o Hermes para “ter um agente de IA”. Isso é uma motivação fraca.

Eu instalaria para retirar uma tarefa repetitiva concreta do caminho, mantendo limite e evidência. O primeiro sucesso não é o bot responder no Telegram. É uma rotina real terminar melhor, no horário certo e sem criar um risco novo.

A sequência que eu recomendo é:

chat → ferramenta → memória → Telegram → uma integração → uma automação

Se cada camada passa no teste antes da próxima, o Hermes deixa de ser uma demo bonita e começa a funcionar como sistema de trabalho.

Se você quer levar essa discussão para sua empresa, eu também faço palestras sobre inteligência artificial, inovação e futuro do trabalho. Para acompanhar os próximos testes e ferramentas, assine minha newsletter.

Fontes e data de corte

Data de corte: 9 de setembro de 2026.

• Vídeo-base: Hermes Agent — Full Course & Setup Guide, Tech With Tim
• Documentação oficial do Hermes Agent
• Quickstart oficial
• Instalação oficial
• Configuração oficial do Telegram
• Segurança
• Memória persistente
• Sistema de skills
• Repositório oficial da Nous Research