Hermes Agent do zero: instalando e testando na prática

O que é o Hermes, um agente de IA open source com memória persistente, as três formas de rodar ele e o passo a passo para instalar numa VPS, conectar no Telegram e no Gmail e deixar tarefas automatizadas rodando 24 horas por dia.

tecnico ia 6 min de leitura

Toda manhã já tenho um resumo das maiores novidades do mundo da IA separadas para mim, os e-mails mais importantes organizados e ideias de vídeo que estão bombando no YouTube prontas na minha frente, sem precisar fazer nada além de sentar e tomar café. Quem faz isso todos os dias é o Hermes, um agente de IA que trabalha 24 horas por dia. Neste post eu explico o que ele é e como instalar o seu do zero, mesmo sem nunca ter mexido com nada disso.

O que é o Hermes

O Hermes é um agente open source desenvolvido pela Nous Research, disponibilizado de forma gratuita. Além dessa vantagem, ele tem memória persistente: diferente de um chatbot comum, ele lembra do contexto entre sessões, lembra do que você gosta e de como você prefere as respostas. Fechar uma conversa e abrir outra não apaga o que já foi combinado.

Isso permite o que considero a parte mais interessante dele: o aprendizado com o uso. Quanto mais você usa, melhor ele fica, porque vai entendendo como você quer a entrega, como você trabalha, seus horários, e vai guardando tudo isso na memória persistente e nas skills que ele mesmo cria.

Ele também é fácil de operar porque a conversa acontece em linguagem natural, em português inclusive, e pode ser conectado a canais como o Telegram. Isso significa que, esteja você onde estiver, dá para mandar uma mensagem de texto ou áudio pelo celular e ele executa a tarefa de forma autônoma. E como pode rodar 24 horas por dia, dá para programar tarefas específicas para horários combinados e simplesmente confiar que serão entregues.

As três formas de rodar o Hermes

Para usar o Hermes, é preciso instalá-lo, e existem três formas de fazer isso.

Direto no computador. É gratuito e funciona, mas é a forma mais sensível: o agente passa a ter acesso a todas as suas pastas, incluindo arquivos e documentos sensíveis. Também exige manter o computador ligado e com internet o tempo todo para conseguir rodar tarefas programadas, o que nem sempre é prático.

No computador, mas isolado via Docker. O agente roda localmente, só que dentro de um contêiner isolado, sem acesso direto às suas pastas a menos que você libere explicitamente. É mais seguro, mas ainda depende do computador ficar ligado o tempo todo para funcionar 24 horas por dia.

Numa VPS (a que eu recomendo). Uma VPS é um computador alugado rodando na nuvem, disponível 24 horas por dia sem depender da sua internet ou energia elétrica ficarem estáveis. Junta segurança (sem acesso aos seus arquivos locais) com disponibilidade constante, e a instalação nesse formato já vem praticamente pronta, sem precisar mexer muito no terminal.

Passo a passo: instalando numa VPS

O primeiro passo é contratar a VPS. Ao escolher o plano, um de configuração intermediária já entrega poder de processamento suficiente para o agente funcionar bem, sem precisar do plano mais caro disponível.

Na etapa de aplicações, a maioria dos provedores de VPS oferece deploy de aplicações via Docker prontas para uso, incluindo o Hermes Agent como uma delas. Selecionando essa opção, o agente já vem implantado automaticamente junto com o servidor, então só falta configurar.

Depois de concluir a contratação, o provedor entrega um usuário e uma senha de administrador, que devem ser guardados para o login inicial no painel do Hermes. Em poucos minutos a VPS termina de configurar e o painel fica disponível para acesso, já com o dashboard oficial do projeto funcionando, sem precisar praticamente usar o terminal para nada.

Configurando o modelo de IA

O Hermes é a estrutura, mas ele precisa de um modelo de IA como motor. É possível escolher entre modelos da OpenAI, Google, Anthropic e outros provedores.

Uma forma prática de ter acesso a centenas de modelos diferentes com uma única chave de API é usando um agregador como o OpenRouter. Depois de criar uma conta e garantir créditos disponíveis, basta gerar uma chave de API nova, colar essa chave no painel do Hermes na seção de providers e escolher o modelo padrão que o agente vai usar. Modelos mais baratos servem bem para tarefas simples, e modelos mais caros e completos podem ser reservados para tarefas mais específicas ou complexas.

Conectando ao Telegram

Para conversar com o Hermes pelo celular, é preciso criar um bot no Telegram através do BotFather, o assistente oficial para criação de bots. Basta enviar /newbot, escolher um nome e um username terminado em "bot". O BotFather devolve um token de API, que precisa ser colado no painel do Hermes, no campo do token do bot do Telegram.

Um ponto crítico dessa configuração é a lista de usuários autorizados a interagir com o bot. Sem restringir isso, qualquer pessoa que descubra o bot no Telegram poderia mandar comandos para o seu agente. O ID do próprio usuário do Telegram pode ser descoberto conversando com um bot utilitário como o "userinfobot", que devolve o ID numérico da conversa. Esse ID deve ser cadastrado como usuário permitido e também como canal de resposta, para o Hermes saber exatamente para quem responder.

Depois de salvar essas configurações, é preciso reiniciar o gateway do sistema, o serviço responsável por manter o agente escutando o Telegram. Com o gateway ativo, abrir a conversa com o bot criado e mandar uma mensagem simples já confirma que a conexão está funcionando.

Testando na prática

Tarefa programada. Um pedido simples, como pesquisar as cinco notícias mais relevantes sobre inteligência artificial das últimas 24 horas todo dia às 7 da manhã, resumir em tópicos com fonte e link, e enviar pelo Telegram, já é suficiente para o Hermes criar um cron job sozinho, usando as skills que já vêm com o modelo. A partir daí, mesmo que o computador esteja desligado no horário programado, a tarefa roda porque o agente está numa VPS ativa 24 horas por dia.

Integração com e-mail. Também é possível conectar o Hermes ao Gmail via SMTP, usando uma senha de aplicativo gerada nas configurações de segurança da conta Google (em vez da senha principal). Com essa conexão configurada, dá para pedir para o agente escrever, ler, organizar ou responder e-mails automaticamente.

Pesquisa e curadoria. Outro uso prático é pedir para o agente pesquisar canais de referência sobre um assunto específico e trazer ideias de conteúdo com base no que está performando bem no momento, retornando um resumo com fontes e sugestões concretas em poucos minutos.

Resumindo

O Hermes funciona como um assistente pessoal que aprende com o uso, guarda contexto entre conversas e pode ser acessado de qualquer lugar pelo Telegram. Rodando numa VPS, ele fica disponível 24 horas por dia para executar tarefas programadas, buscar informação, gerenciar e-mail e muito mais, sem depender do seu computador estar ligado nem colocar seus arquivos locais em risco.