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

O Hermes é um assistente capaz de preservar conversas e experiências de tarefas. O trabalho já realizado pode ser organizado como habilidades para uso posterior. Ele também pode se conectar ao Telegram, Discord, Slack, WhatsApp, Signal e ao terminal por meio do mesmo Gateway. O Gateway funciona como um ponto de entrada unificado para receber e encaminhar mensagens. Você pode enviar revisões de código, registros de incidentes ou materiais de clientes pelo aplicativo de mensagens que costuma usar e, depois, fazer com que ele continue o trabalho no repositório.

Preparação antes da instalação

Primeiro, escolha o método de instalação de acordo com o sistema do computador. No macOS e no Windows, você pode usar diretamente o instalador com interface gráfica. No Linux, macOS e WSL2, pode usar o script pelo terminal. O WSL2 é um recurso que permite executar um ambiente Linux dentro do Windows. O Termux em celulares Android e o Docker também têm métodos próprios de instalação, mas este guia aborda apenas a instalação em computadores comuns.

Se você quer uma interface

macOS, Windows

macOS: abra o DMG
Windows: abra o instalador
Instale o aplicativo no sistema

Se você só quer o terminal

Linux, macOS, WSL2

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

Evite por enquanto

pip, brew, AUR

Essas formas de instalação não têm suporte oficial
Também dificultam as atualizações
Use uma das duas opções à esquerda

Este guia aborda dois caminhos: o instalador com interface gráfica e o script de terminal. pip, brew e AUR não estão entre os métodos de instalação com suporte.

Antes de começar, prepare um computador com macOS, Windows ou Linux e confirme que ele consegue abrir o terminal e acessar o GitHub. Caso pretenda instalar em uma unidade externa, conecte-a primeiro e confirme que há espaço suficiente.

Instalação e primeira inicialização

Para usar uma interface gráfica

Acesse a área de downloads do site do Hermes e baixe o instalador correspondente ao seu sistema. O instalador já inclui o ambiente de execução, portanto não é necessário compilar o programa no computador ao abri-lo pela primeira vez.

macOS: abra o DMG e mova Hermes.app para “Aplicativos”. DMG é um formato de imagem de instalação usado com frequência no macOS. Esse instalador oferece suporte apenas a chips Apple; Macs com processador Intel não são compatíveis.
Windows: abra o arquivo .appinstaller usando o Instalador de Aplicativo do Windows. Ele instala um MSIX assinado, que é um dos formatos de pacote de aplicativos usados pelo Windows.
Linux: o instalador para desktop é destinado ao macOS e ao Windows. No Linux, use o comando de terminal abaixo. Após a instalação, você poderá executar hermes desktop.

Para usar somente o terminal

Se estiver usando Linux, macOS ou WSL2, execute no terminal:

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

No PowerShell incluído no Windows, execute:

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

O instalador baixará o código do Hermes e os programas necessários para executá-lo. Se o download for interrompido, execute novamente o mesmo comando. Após concluir a instalação, feche o terminal atual, abra uma nova janela e digite:

hermes

Se o prompt do Hermes aparecer, o comando já está disponível. Em seguida, você pode executar hermes doctor. Essa verificação da instalação informará o que ainda está faltando.

Programa instalado em uma unidade externa

Em 9 de outubro de 2026, o Hermes Agent v0.21.6 foi instalado em uma unidade externa conectada a um Mac. O programa ficou em /Volumes/AItools/tools/hermes-agent, o comando de inicialização em ~/.local/bin/hermes, e as configurações e conversas continuaram armazenadas em ~/.hermes.

Se o nome da sua unidade for diferente, altere o caminho após --dir para a pasta correspondente. A unidade precisa permanecer conectada durante a execução do Hermes.

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
O código fica aqui

Comando

~/.local/bin/hermes

Digite hermes no terminal
A alteração entra em vigor em uma nova janela

Configurações e conversas

~/.hermes

config.yaml fica aqui
Feche o programa antes de desconectar o disco

Essa foi a organização usada naquele Mac. A instalação padrão coloca o programa no diretório do usuário, mas o resultado é o mesmo: abra um novo terminal e digite hermes.

Obter os parâmetros de conexão no OmniProxy

Nesta configuração, o Hermes se conecta ao OmniProxy, e não diretamente ao Grok ou ao Gemini. Os endereços dos serviços Grok e Gemini são configurados no OmniProxy. Não os informe diretamente no Hermes.

Seu computador

Hermes

Gateway local

OmniProxy

O endereço deve terminar em /v1

Grok

grok-4.7

Gemini

gemini-3.8-flash

O Hermes se comunica com o OmniProxy. O OmniProxy encaminha as solicitações ao Grok e ao Gemini.

O ID do modelo é o nome exato usado pela API para identificar o modelo. Use os seguintes nomes para os dois modelos:

Para o Grok, informe grok-4.7. A API da xAI fica em https://api.x.ai/v1, e as solicitações de chat usam /v1/chat/completions. Consulte a documentação dos modelos Grok.
Para o Gemini, informe gemini-3.8-flash. A API da Google compatível com OpenAI fica em https://generativelanguage.googleapis.com/v1beta/openai/. Consulte as instruções de compatibilidade do Gemini com a OpenAI.

Para mudar para o Gemini no Hermes, basta alterar o nome do modelo para gemini-3.8-flash. O endereço da API continua sendo o endereço do OmniProxy.

Copie o endereço da API e a chave no OmniProxy e informe 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 API para o qual o Hermes enviará as solicitações. Neste caso, ele deve terminar em /v1. API Key é a chave fornecida pelo OmniProxy ao Hermes. Substitua-a pela sua própria chave e não a publique em páginas públicas.

Se o OmniProxy local não exigir uma chave, o campo API Key poderá ficar vazio. Se outras pessoas puderem acessar o endereço, será necessário definir uma chave. Confirme também que esse endereço pode ser acessado pelo ambiente em que o Hermes está sendo executado. Quando o Hermes e o OmniProxy estiverem no mesmo computador, você poderá usar um endereço local.

Preencher a configuração da ferramenta

Primeiro, encerre o chat atual e execute no terminal:

hermes model

Selecione Custom endpoint (self-hosted / VLLM / etc.). Custom endpoint significa endpoint personalizado e faz com que o Hermes se conecte ao endereço de serviço especificado por você, em vez de usar um provedor predefinido.

O assistente de configuração solicitará, em sequência, o endereço da API, a chave e o nome do modelo. Preencha os três itens com os valores da seção anterior. Para usar o Gemini, informe gemini-3.8-flash como nome do modelo.

Você também pode editar diretamente ~/.hermes/config.yaml. YAML é um formato de texto que usa indentação para representar relações entre configurações. 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 usar o Gemini, altere default para gemini-3.8-flash e mantenha os outros três itens sem alterações:

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

Após salvar, execute hermes novamente e inicie um novo chat. Em uma sessão já aberta, /model permite apenas alternar entre provedores já salvos. Ele não pode ser usado para adicionar essa configuração.

Verificar com uma tarefa real

hermes doctor

A verificação da instalação foi concluída

Envie uma mensagem curta

Confira a resposta do Hermes

Abra os registros de chamadas

Confira o nome do modelo

A configuração só poderá ser considerada utilizável depois que as três etapas forem concluídas.

Execute hermes doctor para verificar se a instalação está completa.
Execute hermes e peça que ele explique em uma frase o que consegue fazer. Uma resposta deverá ser exibida.
Abra os registros de chamadas do OmniProxy, confirme que a solicitação veio do Hermes e verifique se o nome do modelo é grok-4.7 ou gemini-3.8-flash.

Ver apenas a confirmação de que o assistente de configuração salvou os dados ou de que a API retornou sucesso não comprova que o Hermes já consegue executar tarefas para você. O nome do modelo nos registros de chamadas precisa ser idêntico ao valor informado.

Para conversar pelo navegador, execute localmente:

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

Depois, abra http://127.0.0.1:9119. Esse endereço funciona somente no computador atual.

Erros comuns

Ao digitar hermes, aparece uma mensagem informando 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á no PATH. O PATH é a lista de diretórios em que o sistema procura comandos. No Windows, confirme se o diretório de inicialização adicionado pelo instalador está no PATH.
O download da instalação foi interrompido: execute novamente o mesmo comando de instalação. As partes já baixadas serão reutilizadas.
O Hermes não responde ou informa que não consegue estabelecer conexão: confirme se o OmniProxy está em execução e se a Base URL termina em /v1. Se o Hermes estiver sendo executado no Docker e o OmniProxy estiver no host, não use 127.0.0.1, pois esse endereço funciona apenas dentro do contêiner.
Aparece uma mensagem informando que a chave está incorreta: atualize a chave do OmniProxy e depois altere o api_key em config.yaml. As chaves da xAI ou da Google pertencem às configurações de provedores do OmniProxy e não devem ser informadas nesse campo do Hermes.
Aparece uma mensagem informando 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 na lista.
O Hermes responde, mas não consegue realizar ações como ler arquivos ou executar comandos: escolha outro modelo no OmniProxy que tenha esses recursos e abra uma nova sessão do Hermes.
O programa está em uma unidade externa e hermes doctor apresenta um erro de armazenamento depois que ela é desconectada: reconecte a unidade primeiro. Não deixe o Hermes criar outro conjunto de configurações enquanto a unidade estiver desconectada.

Referências

Consulte a documentação de instalação do Hermes e a página de compatibilidade com plataformas para ver as etapas de instalação. A configuração de Custom endpoint está na documentação de provedores do Hermes. Os IDs dos modelos podem ser consultados na documentação dos modelos Grok e nas instruções de compatibilidade do Gemini com a OpenAI.

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

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

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

Fontes oficiais · Hermes ↗