Your privacy choices

Allow optional cookies for referral attribution, visit analytics, and Google Ads purchase measurement.

Guia de implantação do Hermes

Para cenários de AI Agent no terminal, abrangendo instalação do ambiente, configuração do modelo e solução de problemas.

Cenários indicados: o Hermes Agent é um AI Agent de terminal open source da Nous Research, indicado para quem precisa de linha de comando local, leitura e gravação de arquivos, ferramentas para web, imagens e voz, memória persistente e gateways de mensagens. Este artigo segue a ordem “preparar o ambiente → instalar o Hermes → configurar um modelo com a Guishu Token → iniciar o chat / gateway → solucionar problemas”.

ConfiguraçãoValor recomendadoObservação
ProviderMore Provider / Custom / OpenAI CompatibleO nome varia um pouco entre versões; selecione a opção que permita informar uma URL personalizada.
Base URLhttps://api.llm-token.cn/v1Dê preferência ao caminho raiz com /v1; se não funcionar, tente https://api.llm-token.cn.
API Keysk-xxxxxxxxÉ normal que o terminal não mostre o texto ao colar.
Modelo recomendadoclaude-sonnet-4-6Responde rapidamente e oferece suporte a Agent, reconhecimento de imagens e contexto amplo; você também pode escolher outro modelo da lista.

1. O que é o Hermes

O Hermes Agent pode conversar pelo terminal, executar comandos, ler e gravar arquivos, pesquisar arquivos, usar ferramentas web e multimodais e salvar preferências de longo prazo por meio de memória persistente. Você pode entendê-lo como um AI Agent capaz de trabalhar continuamente no seu computador ou servidor.

Recomendação para iniciantes: primeiro, faça o chat pela linha de comando funcionar. Depois, configure canais de mensagens como Telegram, Discord e WeChat. Validar primeiro o fluxo mínimo facilitará muito a solução de problemas nas etapas seguintes.

2. Escolha do método de instalação

SistemaMétodo recomendadoComando / observação
Usuários comuns de Windows / macOSHermes DesktopDê preferência ao instalador para desktop: é a opção mais simples.
Linux / macOS / WSL2 / TermuxScript oficial de instalação com um clique
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
PowerShell nativo do WindowsScript oficial para PowerShell
iex (irm https://hermes-agent.nousresearch.com/install.ps1)
Opção mais estável para WindowsWSL2 + UbuntuSe a instalação nativa no Windows não funcionar bem, use o WSL2.

3. Etapas de instalação no Windows com WSL2

  1. Abra o PowerShell como administrador.
  2. Execute o comando de instalação do WSL.
wsl --install

Se a instalação travar em 0%, tente este comando:

wsl --install --web-download -d Ubuntu
  1. Reinicie o computador quando solicitado.
  2. Ao abrir o Ubuntu pela primeira vez, defina o nome de usuário e a senha do Linux.
  3. Pressione a tecla Win e pesquise por WSL ou Ubuntu; se a opção aparecer, está tudo certo.

A imagem mostra o ícone do Windows Subsystem for Linux (WSL). Ele tem fundo vermelho, um pinguim azul no canto superior esquerdo e o texto branco “Sistema WSL” à direita. A imagem aparece após a etapa “Pressione a tecla Win e pesquise por WSL ou Ubuntu; se a opção aparecer, está tudo certo” e ajuda você a confirmar visualmente que o WSL foi instalado com sucesso.A imagem mostra o ícone do Windows Subsystem for Linux (WSL). Ele tem fu…

Verifique se o WSL foi instalado corretamente:

wsl --version

4. Instalar o Git e o Hermes

Execute no terminal do WSL2 / Ubuntu:

sudo apt update
sudo apt install git -y
git --version

Depois, instale o Hermes:

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

Quando a instalação terminar, recarregue a configuração do terminal e verifique o resultado:

source ~/.bashrc
hermes version
hermes doctor

A imagem mostra o resultado do comando hermes --version executado no terminal do WSL2/Ubuntu. Ela informa que a versão do Hermes Agent é v0.8.0, executada em 8 de abril de 2026, com o projeto em /home/omen/.hermes/hermes-agent, Python 3.11.15 e OpenAI SDK 2.30.0, além de indicar que está atualizado. A imagem serve como exemplo da verificação bem-sucedida após a instalação do Hermes.A imagem mostra o resultado do comando hermes --version executado no ter…

Atenção: hermes updata, presente em documentos antigos, está escrito incorretamente. O comando correto para atualizar é hermes update.

5. Configurar um modelo com a Guishu Token

  1. No terminal em que o Hermes foi instalado, execute:
hermes setup

A imagem mostra o terminal em que o Hermes foi instalado executando o comando “hermes setup”. Depois da execução, o prompt “omen@LAPTOP-VMJ1GE8P:~” aparece no terminal, indicando que o comando terminou. A imagem corresponde à configuração do modelo com a Guishu Token, incluindo a seleção da configuração rápida ou do modelo, de “More Provider” / provedor personalizado e de OpenAI Compatible ou outro protocolo que aceite uma URL personalizada.A imagem mostra o terminal em que o Hermes foi instalado executando o co…

  1. Selecione a configuração rápida ou a configuração do modelo.
  2. Selecione More Provider / provedor personalizado.
  3. Selecione OpenAI Compatible ou outro protocolo que aceite uma URL personalizada.

A imagem mostra o terminal durante a configuração do Hermes, com fundo escuro e o ambiente hermes-chat indicado no topo. A interface apresenta instruções de configuração: a primeira linha pede que você selecione a plataforma de mensagens correspondente, como Telegram ou Discord. Abaixo há opções que incluem “set up messaging one (recommended)”. Essa tela orienta a configuração de mensagens durante o fluxo de implantação do Hermes.A imagem mostra o terminal durante a configuração do Hermes, com fundo e…

A imagem mostra a tela de seleção de provedor no terminal durante a instalação do Hermes. No topo aparece “Select provider:”, seguido de opções como Nous Portal e OpenRouter. Uma seta verde aponta para “More providers...”. A imagem corresponde à etapa “Selecione More Provider / provedor personalizado” e orienta você a escolher um provedor personalizado para configurar o modelo com a Guishu Token.A imagem mostra a tela de seleção de provedor no terminal durante a inst…

A imagem mostra a tela de seleção de provedor no terminal durante a instalação do Hermes. No topo aparece “Select provider:”, seguido de opções como GitHub Copilot ACP e Google AI Studio. Uma seta verde destaca “Custom endpoint (enter URL manually)”, que permite inserir uma URL manualmente. A imagem corresponde à etapa de selecionar um provedor personalizado para informar a URL desejada.A imagem mostra a tela de seleção de provedor no terminal durante a inst…

Ao informar a URL, dê preferência a:

https://api.llm-token.cn/v1

Se a validação falhar na versão atual, tente:

https://api.llm-token.cn

A imagem mostra a tela de configuração de um endpoint personalizado compatível com OpenAI durante a configuração do modelo com a Guishu Token no Hermes. O destaque é “Custom OpenAI-compatible endpoint configuration”, com o campo API base URL e o formato de exemplo https://api.example.com/v1, enquanto o endereço personalizado preenchido é https://api.llm-token.cn/v1, nessa tela exibida depois que você seleciona um provedor personalizado e o protocolo compatível com OpenAI.A imagem mostra a tela de configuração de um endpoint personalizado comp…

  1. Cole a API Key. É normal que o terminal não exiba o texto; pressione Enter depois de colar.
  2. Para o primeiro teste, recomendamos selecionar o modelo claude-sonnet-4-6.
  3. Se o sistema perguntar o tamanho do contexto, você pode informar um contexto amplo ao usar claude-sonnet-4-6. Se o cliente tiver limites mais rígidos, comece com 32000 para validar o funcionamento e aumente gradualmente.
  4. Na primeira vez, você pode pular a configuração dos canais de chat e configurar o gateway apenas depois que o chat do terminal estiver funcionando.

A imagem mostra o terminal depois da configuração do modelo com a Guishu Token no Hermes. Na parte superior, API base URL aparece como https://api.example.com/v1, a API key é opcional e o endpoint foi validado. Abaixo estão 33 modelos disponíveis, incluindo claude-sonnet-4-6 e claude-sonnet-4-6-thinking. Na parte inferior, você deve selecionar um modelo pelo número correspondente: por exemplo, 1 é claude-sonnet-4-6 e 33 é glm-4.6v.A imagem mostra o terminal depois da configuração do modelo com a Guishu…

A imagem mostra a tela exibida antes de entrar no chat, depois que a configuração do Hermes foi concluída. A interface pergunta “Connect a messaging platform? (Telegram, Discord, etc.)” e oferece duas opções: “Set up messaging now (recommended)” e “Skip — set up later with 'hermes setup gateway'”. A opção “Skip” está selecionada e é apontada por uma seta. Você pode escolher configurar a plataforma imediatamente ou deixar para depois.A imagem mostra a tela exibida antes de entrar no chat, depois que a con…

6. Iniciar o chat e o gateway

Depois de concluir a configuração, você pode entrar diretamente no chat. Se a interface perguntar se deseja iniciá-lo, digite Y.

A imagem mostra a tela do terminal após a implantação do Hermes. Na parte superior aparece “Ready to go!”. Abaixo são exibidos três comandos e suas finalidades: “hermes” para iniciar o chat, “hermes gateway” para iniciar os canais de mensagens e “hermes doctor” para verificar problemas. Na última linha, “Launch hermes chat now? [Y/n]:” pergunta se você quer iniciar o chat do Hermes imediatamente, aceitando Y/n como resposta.A imagem mostra a tela do terminal após a implantação do Hermes. Na part…

Se você configurou um canal de mensagens, mas ele não responde, inicie ou verifique o gateway:

hermes gateway
hermes gateway status

7. Referência rápida de comandos comuns

ComandoFinalidade
hermesIniciar o chat.
hermes setupAbrir novamente o assistente completo de configuração.
hermes modelTrocar o modelo ou o provedor.
hermes doctorDiagnosticar dependências, configurações e o status dos serviços.
hermes updateAtualizar o Hermes.
hermes --continueRetomar a sessão anterior.

8. Problemas comuns

ProblemaSolução
hermes: command not foundExecute source ~/.bashrc ou abra o terminal novamente. Se ainda não funcionar, verifique o PATH.
Falha ao validar o modeloVerifique a URL, a API Key e o ID do modelo. Dê preferência a https://api.llm-token.cn/v1.
Respostas interrompidas ou contexto pequeno demaisVolte a hermes setup ou ajuste o context length no arquivo de configuração. Primeiro valide o funcionamento e depois aumente o contexto.
O WSL2 não acessa um serviço local do WindowsNo Windows 11, tente o WSL mirrored networking; no Windows 10, use o IP do gateway padrão do WSL no lugar de localhost.
Configuração perdida após uma atualizaçãoExecute hermes config check e hermes config migrate.
[wsl2]
networkingMode=mirrored
wsl --shutdown

Guia de implantação do Codex

Explica a instalação da ferramenta CLI, a integração da API e a configuração do ambiente de desenvolvimento.

Guia de configuração do modelo de geração de imagens gpt-image-2

Tutorial de geração de imagens para integração com o Cherry Studio, pacotes de skills e scripts.

Seções desta página

1. O que é o Hermes2. Escolha do método de instalação3. Etapas de instalação no Windows com WSL24. Instalar o Git e o Hermes5. Configurar um modelo com a Guishu Token6. Iniciar o chat e o gateway7. Referência rápida de comandos comuns8. Problemas comuns