Hermes Agent: o que é, como instalar e configurar

Claude Code, Codex, Cursor, OpenClaw — cada um destes agentes de IA tem o seu papel. Se precisa de um agente que funcione no seu servidor, se lembre de si entre sessões e lhe responda no Telegram enquanto vai de táxi, o Hermes Agent é indicado para esse papel.

O Hermes Agent é um projeto aberto da Nous Research e é muito mais fácil de instalar do que muitas pessoas pensam. Neste artigo, explicamos o que é, quanto custa, como o instalar no Windows, macOS ou Linux e como lhe ligar um modelo e um bot do Telegram. Tudo se baseia na documentação oficial.

O que é o Hermes Agent, em linguagem simples?#

O Hermes pertence à mesma categoria que o Claude Code ou o Codex: é um agente de IA que não se limita a escrever respostas; abre ficheiros, executa comandos no terminal e utiliza um navegador. A diferença está na forma como foi concebido: o Claude Code está associado aos modelos da Anthropic, enquanto o Hermes funciona com qualquer fornecedor de modelos — do Claude e do GPT aos modelos locais executados no seu equipamento.

O projeto é recente: o seu repositório no GitHub foi criado a 22 de julho de 2025. Ainda assim, a 22 de agosto de 2026, já conta com mais de 234 000 estrelas e 47 000 forks, o que faz dele um dos projetos abertos de crescimento mais rápido nesta categoria. O código é totalmente aberto ao abrigo da licença MIT: pode lê-lo, modificá-lo e utilizá-lo nos seus produtos sem pagar royalties.

Dois mecanismos específicos estão na base deste «autoaperfeiçoamento»: as competências e a memória. As competências são procedimentos que o agente regista depois de tarefas complexas e aplica da próxima vez. A memória é um ficheiro com informações sobre si e o seu ambiente, carregado em cada nova conversa. Ambos os mecanismos são abordados abaixo numa secção própria.

Em que difere o Hermes Agent do Claude Code e do Codex?#

As principais diferenças estão resumidas nesta tabela:

A tabela deixa claro o principal. O Claude Code é indicado para tarefas que exigem o modelo mais avançado e trabalho num repositório — a Anthropic continua a oferecer a melhor combinação de modelo e ferramentas neste contexto. O Hermes serve quando precisa de um agente «sempre ativo»: funciona num servidor, executa uma tarefa todas as manhãs segundo um horário, responde-lhe no Telegram e lembra-se da conversa do dia anterior.

Se estiver a comparar ferramentas básicas, existem guias separados sobre como instalar o Claude Code, o que é o Codex da OpenAI e o panorama das ferramentas de IA para programação em 2026.

Quanto custa o Hermes Agent em 2026?#

A opção mais simples é o Nous Portal, a subscrição nativa dos programadores do Hermes. Inclui mais de trezentos modelos e também serviços prontos a utilizar: pesquisa na Web, geração de imagens, síntese de voz e um navegador na nuvem. A 22 de agosto de 2026, os planos são:

A segunda opção, que muitas pessoas não conhecem, é que não precisa de subscrever um novo plano. O Hermes pode iniciar sessão através de OAuth, ou seja, através de uma conta que já tem. São suportadas as subscrições do ChatGPT e do Codex, Claude Max, SuperGrok da xAI, Qwen, MiniMax e GitHub Copilot. Escolha um fornecedor durante a configuração, confirme o início de sessão no navegador e continuará a pagar exatamente o mesmo que pagava antes.

A terceira opção consiste em utilizar as suas próprias chaves API. Anthropic, OpenAI, Google, DeepSeek, Z.AI, Kimi, Alibaba e cerca de mais uma dúzia de fornecedores: introduza uma chave e a utilização será faturada diretamente na respetiva conta.

A quarta opção não custa dinheiro, mas exige equipamento: um modelo local através do Ollama ou do LM Studio. É uma opção adequada se tiver um computador potente e não quiser enviar dados para fora dele. Há uma condição: o modelo tem de ter uma janela de contexto de pelo menos 64 000 tokens; caso contrário, o Hermes recusar-se-á a iniciar com esse modelo — o agente precisa de memória de trabalho suficiente para tarefas longas.

As condições de pagamento dos serviços estrangeiros não são abordadas aqui — são um tema separado, com regras próprias, discutido neste guia, com o Claude Code como exemplo.

Como instalar o Hermes Agent no Windows#

Se não estiver familiarizado com o terminal, comece pelo instalador. O site hermes-agent.nousresearch.com tem botões de transferência para macOS 12+, Windows 10/11 e Linux. O ficheiro transferido instala as duas aplicações ao mesmo tempo: a linha de comandos hermes e o Hermes Desktop — uma janela normal com chat, ficheiros e definições.

Se está habituado a utilizar comandos, instale através do PowerShell:

1. Abra o PowerShell

   Prima Win, escreva PowerShell e abra-o. Não são necessários privilégios de administrador.

2. Execute o instalador

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

   O script transfere tudo o que é necessário: Python 3.11, Node.js 22, o gestor de pacotes uv, ripgrep e ffmpeg. Se não tiver Git, instala a sua própria versão isolada do MinGit, guardada separadamente e sem interferir com os programas do sistema.

3. Reinicie o terminal e verifique

   hermes doctor
   

   O comando mostra o que está instalado, o que falta e como resolver. Se vir marcas de verificação verdes, está tudo instalado.

Com este método de instalação, os ficheiros são guardados em %LOCALAPPDATA%\hermes. Se utilizar o WSL2, também pode executar lá o comando Linux da secção seguinte — escolha a opção que lhe for mais conveniente.

Como instalar o Hermes Agent no macOS e Linux#

O Hermes instala-se com um único comando — num portátil ou num servidor. Eis o processo completo:

1. Verifique se o Git está instalado

   git --version
   

   Se o comando devolver um número de versão, continue. No Linux, verifique também se tem curl e xz-utils: no Debian e Ubuntu, instale-os com sudo apt install curl xz-utils.

2. Execute o instalador

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

   O script clona o repositório para ~/.hermes/hermes-agent, cria um ambiente virtual e instala o comando hermes em ~/.local/bin. Para um servidor sem interface gráfica e automatização do navegador, existe uma opção mais leve: acrescente bash -s -- --skip-browser no fim.

3. Volte a carregar a shell e inicie

   source ~/.zshrc   # no macOS; no Linux, mais frequentemente: source ~/.bashrc
   hermes
   

Quando a instalação é feita como root, os ficheiros são colocados em caminhos do sistema — /usr/local/lib/hermes-agent e /usr/local/bin/hermes —, o que é prático num servidor utilizado por várias contas. As definições, as chaves e a memória continuam a estar na pasta pessoal ~/.hermes de cada utilizador.

Uma nota sobre o Hermes Desktop no Linux: para compilar a aplicação no Debian e Ubuntu, precisa dos compiladores incluídos no pacote build-essential (sudo apt install build-essential). E, se instalou o Hermes através do comando, não precisa de um instalador separado — execute hermes desktop e a aplicação será iniciada com as suas definições, sessões e competências atuais.

Como ligar um modelo ao Hermes Agent#

O modelo é o motor do Hermes: o agente não pensa por si próprio; contacta o modelo que escolher. Por isso, o primeiro passo depois da instalação é escolher a que serviço se vai ligar:

hermes model

O assistente de configuração pergunta qual é o fornecedor, o método de início de sessão e o modelo. Há muitas opções; as principais são:

Se escolher o Nous Portal, um único comando faz tudo ao mesmo tempo:

hermes setup --portal

É aberta uma página de início de sessão no navegador. Depois de confirmar, o Nous fica definido como fornecedor e o Tool Gateway é ativado — pesquisa na Web, geração de imagens e síntese de voz sem chaves separadas para cada serviço.

O Hermes guarda as chaves e as definições separadamente, e é importante perceber isso desde o início. Os segredos — chaves API e tokens — são guardados em ~/.hermes/.env. As definições normais estão em ~/.hermes/config.yaml. Não precisa de editar estes ficheiros manualmente: hermes config set coloca automaticamente cada valor no ficheiro certo:

Encontrar guias de ferramentas na documentação do Ailoot

O assistente de configuração completo é hermes setup. Tem três modos: configuração rápida através do Nous Portal, configuração completa, em que configura manualmente cada fornecedor e ferramenta, e Blank Slate — uma instalação limpa com tudo desativado, exceto o essencial, para ativar apenas o que precisa.

Como verificar se o Hermes Agent está a funcionar#

Depois de escolher um modelo, inicie uma conversa:

hermes          # interface clássica
hermes --tui    # interface moderna, com suporte para rato e janelas pop-up

O banner de boas-vindas mostra o modelo selecionado, as ferramentas ativadas e as competências. A seguir, em vez de perguntar «olá, quem és?», dê-lhe uma tarefa com um resultado visível: «mostra-me as cinco maiores pastas do disco» ou «vê a pasta atual e diz-me qual é o ficheiro principal do projeto». Se o agente executar um comando no terminal e devolver uma resposta útil, a configuração básica está a funcionar.

A última verificação diz respeito às sessões. Saia da conversa e volte a entrar:

hermes --continue   # ou, de forma abreviada: hermes -c

Deverá encontrar-se na mesma conversa. Isto confirma que a memória da sessão está a ser guardada no disco — mais tarde, o bot e as tarefas agendadas dependerão dela.

Quando algo não funciona, siga esta ordem: hermes doctor (diagnóstico geral), hermes model (volte a verificar o modelo e o início de sessão), hermes setup (recrie a configuração), hermes sessions list e hermes --continue (verifique as sessões), hermes gateway status (estado do gateway). Esta sequência pode ajudá-lo a passar de «está tudo avariado» para uma situação clara em poucos minutos.

O que são as competências e a memória no Hermes Agent?#

Uma competência do Hermes é um ficheiro SKILL.md com um nome, uma descrição e um procedimento passo a passo: como compilar um documento, abrir um pedido de pull ou preparar uma campanha de correio eletrónico. O agente lê descrições breves de todas as competências e só carrega o texto completo quando a tarefa corresponde — por isso, cem competências instaladas não aumentam o tamanho de cada pedido. A norma é aberta, agentskills.io, e os mesmos ficheiros funcionam noutros agentes.

As competências encontram-se na pasta ~/.hermes/skills/. Chegam lá de três formas: um conjunto básico é instalado juntamente com a aplicação, as competências prontas podem ser adicionadas a partir do catálogo com hermes skills install e o agente cria novas competências para si próprio depois de tarefas complexas. Cada competência transforma-se automaticamente num comando com barra: instale a competência gif-search e /gif-search funcionará em qualquer chat. A instalação a partir do catálogo passa por uma verificação de segurança para impedir que os procedimentos de terceiros introduzam comandos maliciosos.

A memória é ainda mais simples. Dois ficheiros em ~/.hermes/memories/: MEMORY.md — as notas do próprio agente sobre o seu ambiente e as suas conclusões, até 2 200 caracteres — e USER.md — o seu perfil: como lhe responder, de que gosta e de que não gosta, até 1 375 caracteres. No início de cada conversa, os dois ficheiros são adicionados ao prompt de sistema, por isso o agente começa por já saber algumas coisas sobre si. Os limites são intencionalmente rigorosos: a memória não cresce sem controlo e o agente decide o que guardar e o que descartar.

Estas duas componentes — competências e memória — formam um Second Brain: um agente que se lembra do contexto e acumula procedimentos, trabalhando visivelmente melhor a cada semana do que no dia em que foi instalado. Para obter orientações sobre como escolher estas competências e impedir que o agente se torne um depósito de informações, consulte este guia, com o Claude Code como exemplo — os princípios são os mesmos.

Como ligar o Hermes Agent ao Telegram#

O Telegram é o canal mais popular do Hermes e a integração está bem desenvolvida: texto, mensagens de voz com transcrição, imagens e ficheiros, além de respostas em grupos. Eis o processo:

1. Crie um bot com o BotFather

   Abra o @BotFather no Telegram, envie /newbot, escolha um nome e um nome de utilizador único terminado em bot. Receberá um token como 123456789:ABCdef... — esta é a chave do seu bot, por isso guarde-a como uma palavra-passe. Se o token for divulgado, revogue-o enviando /revoke ao mesmo BotFather.

2. Descubra o seu ID de utilizador

   Encontre o seu ID numérico, por exemplo 123456789. Este é o número da sua conta; não o confunda com o seu nome de utilizador. Vai precisar dele para a lista de acesso.

3. Execute o assistente de configuração do gateway

   hermes gateway setup
   

   Selecione Telegram e introduza o token e o ID. O assistente guardará as definições. Também pode fazê-lo manualmente, com duas linhas em ~/.hermes/.env: TELEGRAM_BOT_TOKEN=... e TELEGRAM_ALLOWED_USERS=123456789.

4. Inicie o gateway

   hermes gateway
   

   O bot ficará online em poucos segundos. Envie-lhe uma mensagem e verifique a resposta.

Por predefinição, o acesso está fechado: o bot só responde aos IDs incluídos na lista. Pode dar a uma nova pessoa um código de emparelhamento — funciona durante uma hora e depois expira. A lista de utilizadores pendentes e aprovados está disponível através de hermes pairing list.

Há uma armadilha nos chats de grupo de que muitas pessoas se esquecem. Por predefinição, os bots do Telegram têm o modo de privacidade ativado: num grupo, um bot só vê comandos e respostas às próprias mensagens. Para que leia tudo, desative o modo através do @BotFather (Bot Settings - Group Privacy) ou, mais simplesmente, torne o bot administrador do grupo.

Por predefinição, o gateway consulta diretamente os servidores do Telegram — o que funciona bem num computador doméstico ou num servidor sempre ligado. Para plataformas na nuvem que colocam a máquina em suspensão quando não há tráfego de entrada, existe o modo webhook, em que o Telegram envia mensagens para o seu endereço.

O que mais pode fazer o Hermes Agent depois da instalação?#

Eis o que pode ativar, por esta ordem:

1. Tarefas agendadas. O gateway tem um agendador integrado: «Todas as manhãs às 8, prepara um resumo das notícias sobre os meus temas e envia-mo pelo Telegram.» Defina o horário com uma frase normal e os resultados chegarão ao mesmo chat.
2. Hermes Desktop. O comando hermes desktop abre a aplicação para macOS, Windows e Linux com o mesmo agente: respostas em fluxo contínuo, pré-visualizações de ficheiros junto ao chat, arrastar e largar documentos e um contador de contexto. As sessões são partilhadas — pode começar no terminal e continuar na janela.
3. Painel Web. hermes dashboard abre no navegador um painel para canais, memória, webhooks e perfis. É útil quando o Hermes funciona num servidor.
4. Subagentes. Pode delegar uma tarefa grande a agentes auxiliares isolados — cada um tem a sua própria conversa e terminal, por isso não consomem o seu contexto.
5. Voz. O modo de voz funciona no terminal, no Telegram e no Discord — pode ditar uma tarefa e receber uma resposta falada.
6. Editor de código. Através do protocolo ACP, o Hermes liga-se ao VS Code, Zed e JetBrains como agente diretamente no editor.

As ferramentas podem ser ativadas e desativadas uma a uma com hermes tools, para que o agente não tenha de carregar tudo consigo. Quando chegar a altura de mudar para outro computador, hermes backup agrupa toda a instalação num arquivo e hermes import extrai-a na nova localização.

A quem se destina o Hermes Agent e quem deve esperar?#

Faz sentido instalar o Hermes quando perceber o que quer pedir a um agente: organizar documentos, criar um protótipo, gerir correspondência ou preparar resumos matinais. A ferramenta em si não é o mais importante — são as tarefas que lhe atribui. Existe um guia sobre tarefas para um agente de IA dedicado a este tema.

Pode não ser indicado em dois casos. Primeiro, se espera «registar-se e começar logo a utilizar»: é preciso instalar o Hermes e ligá-lo a um modelo. Só demora um comando, mas continua a ser necessário abrir o terminal. Segundo, se não tiver um modelo adequado e não quiser perceber como funcionam uma subscrição ou as chaves API.

Todos os outros devem começar com pouco: instalá-lo, escolher um modelo, ter uma conversa sem problemas, depois adicionar um bot do Telegram — e só então tarefas agendadas e subagentes.

Que outras perguntas fazem sobre o Hermes Agent?#

Encontre mais recursos na Ailoot.