Instalação do Hermes e configuração do OmniProxy

O Hermes é um assistente capaz de preservar conversas e experiência adquirida em tarefas, organizando o trabalho já realizado em competências que podem voltar a ser utilizadas. Também pode ligar-se ao Telegram, Discord, Slack, WhatsApp, Signal e ao terminal através do mesmo Gateway. O Gateway funciona como um ponto de entrada comum para receber e encaminhar mensagens. Pode atribuir-lhe revisões de código, registos de incidentes ou materiais de clientes a partir da ferramenta de conversação que utiliza habitualmente e, depois, deixá-lo continuar o trabalho no repositório.

Preparação antes da instalação

Comece por escolher o método de instalação adequado ao sistema do computador. No macOS e Windows, pode utilizar diretamente um instalador com interface gráfica. No Linux, macOS e WSL2, pode utilizar um script no terminal. O WSL2 permite executar um ambiente Linux no Windows. O Termux em telemóveis Android e o Docker também têm métodos de instalação próprios, mas este guia aborda apenas a instalação em computadores convencionais.

Se quiser uma janela

macOS, Windows

macOS: abra o DMG
Windows: abra o pacote de instalação
Instale a aplicação no sistema

Se só precisar do terminal

Linux, macOS, WSL2

Um único install.sh
No Windows, use install.ps1
Após a instalação, introduza hermes

Não use por enquanto

pip, brew, AUR

Estes métodos de instalação não são oficialmente suportados
Também dificultam as atualizações
Use uma das duas opções à esquerda

Este guia utiliza duas opções: o instalador com interface gráfica e o script de terminal. pip, brew e AUR não fazem parte dos métodos de instalação oficialmente suportados.

Antes de começar, prepare um computador com macOS, Windows ou Linux e confirme que consegue abrir o terminal e aceder ao GitHub. Se pretender instalar o programa num disco externo, ligue primeiro o disco e confirme que tem espaço suficiente.

Instalar e iniciar pela primeira vez

Se quiser uma interface gráfica

Aceda à área de transferências do site do Hermes e transfira o instalador correspondente ao seu sistema. O instalador já inclui o ambiente de execução, pelo que não é necessário compilar o programa localmente ao abri-lo pela primeira vez.

macOS: abra o DMG e coloque Hermes.app em «Aplicações». Um DMG é um ficheiro de imagem de instalação habitualmente utilizado no macOS. Este instalador suporta apenas processadores Apple; os Mac com processador Intel não são suportados.
Windows: abra o ficheiro .appinstaller com o Instalador de Aplicações do Windows. Este instala um MSIX assinado, um formato de pacote utilizado para instalar aplicações no Windows.
Linux: os instaladores para ambiente de trabalho destinam-se ao macOS e Windows. No Linux, utilize o comando de terminal apresentado abaixo. Depois da instalação, pode executar hermes desktop.

Se só precisar do terminal

Se utilizar Linux, macOS ou WSL2, execute no terminal:

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

Se utilizar o PowerShell incluído no Windows, execute:

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

O instalador transfere o código do Hermes e os programas necessários à sua execução. Se a transferência for interrompida, volte a executar o mesmo comando. Quando a instalação terminar, feche o terminal atual, abra uma nova janela e introduza:

hermes

Se vir o prompt do Hermes, o comando já está disponível. Em seguida, pode executar hermes doctor. Esta verificação da instalação indica o que ainda estiver em falta.

Instalar o programa num disco externo

Em 9 de outubro de 2026, o Hermes Agent v0.21.6 foi instalado num disco externo ligado a um Mac. O programa ficou em /Volumes/AItools/tools/hermes-agent, o comando de arranque em ~/.local/bin/hermes e a configuração e as conversas continuaram guardadas em ~/.hermes.

Se o seu disco tiver outro nome, substitua o caminho depois de --dir pela pasta correspondente. O disco tem de permanecer ligado enquanto o Hermes estiver em execução.

curl -fsSL https://hermes-agent.nousresearch.com/install.sh -o install.sh
bash install.sh --dir /Volumes/AItools/tools/hermes-agent --non-interactive

Programa

Disco externo

tools/hermes-agent
Guarde aqui o código

Comando

~/.local/bin/hermes

Introduza hermes no terminal
Fica ativo após abrir uma nova janela

Configuração e conversas

~/.hermes

O config.yaml fica aqui
Saia antes de desligar o disco

Esta foi a organização utilizada nesse Mac. A instalação predefinida coloca o programa no diretório do utilizador, mas o resultado é o mesmo: depois de abrir um novo terminal, introduza hermes.

Obter os parâmetros de ligação no OmniProxy

Nesta configuração, o Hermes liga-se ao OmniProxy, não diretamente ao Grok ou ao Gemini. Os endereços dos serviços Grok e Gemini são configurados no OmniProxy e não devem ser introduzidos diretamente no Hermes.

O seu computador

Hermes

Gateway local

OmniProxy

O endereço deve terminar em /v1

Grok

grok-4.7

Gemini

gemini-3.8-flash

O Hermes vê o OmniProxy. O encaminhamento para o Grok e o Gemini é efetuado pelo OmniProxy.

O ID do modelo é o nome exato utilizado pela interface para identificar o modelo. Utilize os seguintes nomes para os dois modelos:

Para o Grok, introduza grok-4.7. A interface da xAI encontra-se em https://api.x.ai/v1 e os pedidos de conversação utilizam /v1/chat/completions. Consulte a documentação dos modelos Grok.
Para o Gemini, introduza gemini-3.8-flash. A interface da Google compatível com OpenAI encontra-se em https://generativelanguage.googleapis.com/v1beta/openai/. Consulte as informações sobre compatibilidade do Gemini com OpenAI.

Para mudar para o Gemini no Hermes, basta substituir o nome do modelo por gemini-3.8-flash. O endereço da interface continua a ser o endereço do OmniProxy.

Copie o endereço da interface e a chave do OmniProxy e, depois, introduza o ID do modelo correspondente:

Base URL: https://your-omniproxy-origin.example/v1
API Key:  <YOUR_OMNIPROXY_API_KEY>
Model ID: grok-4.7

Base URL é o endereço da interface para onde o Hermes envia os pedidos e, neste caso, deve terminar em /v1. API Key é a chave fornecida pelo OmniProxy ao Hermes. Substitua-a pelo seu próprio valor e não a publique numa página acessível ao público.

Se o OmniProxy local não exigir uma chave, pode deixar API Key em branco. Se o endereço estiver acessível a outras pessoas, deve utilizar uma chave. Confirme também que o endereço está acessível a partir do ambiente onde o Hermes é executado. Se o Hermes e o OmniProxy estiverem no mesmo computador, pode utilizar um endereço local.

Preencher a configuração da ferramenta

Comece por sair da conversa em curso e execute no terminal:

hermes model

Selecione Custom endpoint (self-hosted / VLLM / etc.). Custom endpoint significa interface personalizada e indica ao Hermes que deve ligar-se ao endereço de serviço especificado, em vez de utilizar um fornecedor predefinido.

O assistente de configuração pede, por esta ordem, o endereço da interface, a chave e o nome do modelo. Preencha estes três campos com os valores da secção anterior. Para utilizar o Gemini, introduza gemini-3.8-flash como nome do modelo.

Também pode editar diretamente ~/.hermes/config.yaml. YAML é um formato de texto que utiliza indentação para representar relações de configuração. Esta é a configuração para o Grok:

model:
  default: grok-4.7
  provider: custom
  base_url: https://your-omniproxy-origin.example/v1
  api_key: <YOUR_OMNIPROXY_API_KEY>

Para utilizar o Gemini, substitua default por gemini-3.8-flash e mantenha os outros três campos inalterados:

model:
  default: gemini-3.8-flash
  provider: custom
  base_url: https://your-omniproxy-origin.example/v1
  api_key: <YOUR_OMNIPROXY_API_KEY>

Depois de guardar, volte a executar hermes e inicie uma nova conversa. Numa sessão já aberta, /model apenas permite alternar entre fornecedores já guardados; não pode ser utilizado para adicionar esta configuração.

Verificar com uma tarefa real

hermes doctor

A verificação da instalação foi concluída com êxito

Envie uma mensagem curta

Confirme que recebe uma resposta do Hermes

Abra o registo de chamadas

Confirme o nome do modelo

A configuração só deve ser considerada operacional depois de concluir os três passos.

Execute hermes doctor para verificar se a instalação está completa.
Execute hermes e peça-lhe que explique numa frase o que consegue fazer. Deverá receber uma resposta.
Abra o registo de chamadas do OmniProxy, confirme que este pedido teve origem no Hermes e verifique se o nome do modelo é grok-4.7 ou gemini-3.8-flash.

Ver apenas uma confirmação de que o assistente de configuração guardou os dados, ou de que a interface devolveu uma resposta com êxito, não demonstra que o Hermes já consegue executar tarefas por si. O nome do modelo no registo de chamadas tem de corresponder ao valor introduzido.

Para conversar através do navegador, execute localmente:

hermes dashboard --no-open --host 127.0.0.1 --port 9119

Depois, abra http://127.0.0.1:9119. Este endereço só funciona no computador atual.

Erros comuns

Ao introduzir hermes, aparece uma indicação de que o comando não foi encontrado: feche o terminal e abra uma nova janela. Se o comando continuar indisponível, confirme que ~/.local/bin está incluído em PATH. PATH é a lista de diretórios onde o sistema procura comandos. No Windows, confirme que o diretório de arranque adicionado pelo instalador está incluído em PATH.
A ligação é interrompida a meio da transferência da instalação: volte a executar o mesmo comando de instalação. As partes já transferidas serão reutilizadas.
O Hermes não responde ou indica que não consegue estabelecer ligação: confirme que o OmniProxy está em execução e verifique se Base URL termina em /v1. Se o Hermes estiver a ser executado no Docker e o OmniProxy estiver no sistema anfitrião, não utilize 127.0.0.1, pois esse endereço só é válido dentro do contentor.
É apresentado um erro de chave: atualize a chave do OmniProxy e altere o valor de api_key em config.yaml. As chaves da xAI ou da Google pertencem às definições de fornecedor do OmniProxy e não devem ser introduzidas neste campo do Hermes.
É indicado que o modelo não existe: abra a lista atual de modelos do OmniProxy e copie grok-4.7 ou gemini-3.8-flash exatamente como aparece nessa lista.
O Hermes responde, mas não consegue ler ficheiros, executar comandos ou realizar tarefas semelhantes: mude para outro modelo do OmniProxy que tenha essas capacidades e inicie uma nova sessão do Hermes.
O programa está num disco externo e hermes doctor apresenta um erro de armazenamento depois de o disco ser desligado: volte a ligar primeiro esse disco. Não permita que o Hermes crie outra configuração enquanto o disco estiver desligado.

Referências oficiais

Para os passos de instalação, consulte a documentação de instalação do Hermes e a página de compatibilidade com plataformas. Para configurar Custom endpoint, consulte a documentação de fornecedores do Hermes. Para os IDs dos modelos, consulte a documentação dos modelos Grok e as informações sobre compatibilidade do Gemini com OpenAI.

A instalação no macOS foi concluída em 2026-10-09 com o Hermes Agent v0.21.6. grok-4.7 e gemini-3.8-flash eram, nessa data, os IDs de modelo padrão apresentados na documentação da xAI e da Google. Ao preencher a configuração, utilize o nome apresentado no OmniProxy.

Substitua todos os espaços reservados por valores da sua própria configuração do OmniProxy. Nunca publique uma chave real.

Um resultado guardado ou HTTP 200 sozinho não prova a compatibilidade total do Agente. Verifique a origem e o modelo no registo de chamadas do OmniProxy.

Fontes oficiais · Hermes ↗