Hermes Agent é um agente de IA de código aberto da Nous Research que funciona no terminal, conecta-se a diferentes provedores de modelos, mantém contextos úteis entre sessões e pode ser ampliado com ferramentas, skills, gateways de mensagens e automação. Este guia mostra como instalar o Hermes. Você não precisa instalar manualmente o Python nem o Node.js para usar o instalador padrão no macOS ou Windows, pois o instalador oficial cuida das principais dependências.
Antes de instalar o Hermes Agent
Hermes Agent é um software voltado ao terminal, portanto a instalação é feita pela linha de comando. Escolha a seção correspondente ao seu computador:
macOS: abra o Terminal em Aplicativos > Utilitários > Terminal ou pressione Command + Espaço e pesquise por "Terminal".
Windows: primeiro instale o WSL2, abra o terminal da sua distribuição Linux e siga o comando para Linux.
Você também precisa do Git. Verifique se o Git está instalado:
Saída esperada:
Se aparecer git: command not found, instale o Git primeiro:
Se você não tiver o Homebrew no macOS, instale o Git pelas Ferramentas de Linha de Comando da Apple executando:
Etapa 1: instale o Hermes Agent no macOS ou Windows
No terminal, copie e cole o comando do instalador oficial:
O instalador baixa o Hermes Agent, prepara o ambiente Python, instala as dependências necessárias e adiciona o comando hermes ao caminho do shell. Em uma instalação normal de usuário, os dados do Hermes ficam armazenados em ~/.hermes/.
Quando o comando terminar, recarregue o shell:
Se você usa Zsh, comum no macOS, execute:
Resultado esperado:
Agora, confirme que o comando do Hermes Agent está disponível:
Resultado esperado:
O número exato da versão pode mudar à medida que o Hermes Agent é atualizado.
Etapa 2: configure seu provedor de modelos
O Hermes Agent precisa de um provedor de modelos para responder ou usar ferramentas. A configuração interativa é a opção mais fácil para iniciantes:
O assistente permite escolher um provedor, como Kimi/Moonshot. Não configure roteamento, fallback, gateway ou cron até que uma conversa básica funcione.
Selecione o modelo padrão. Kimi K3 é o mais recente modelo principal do Kimi; se o seu foco for programação, kimi-k2.7-code é a melhor opção.
Se você já souber o valor que deseja definir, poderá usar hermes config set. Por exemplo:
Se você não tiver uma api-key, o Kimi pode ser uma boa opção.
Etapa 1: ative sua Kimi API
Antes de usar a Kimi API com o Hermes Agent, ative sua Kimi API Key na Plataforma do Kimi. Recomendamos adicionar US$ 20 ou mais para desbloquear o acesso ao Nível 2, que reduz a latência e oferece desempenho mais estável em tarefas complexas de várias etapas
Etapa 2: crie sua Kimi API Key
Acesse a seção API Keys na Plataforma do Kimi e clique em Create API Key. Lembre-se de copiar sua chave de API e armazená-la em segurança, pois ela é exibida apenas uma vez, no momento da criação.
Etapa 3: insira sua chave de API
Cole sua chave da Kimi API e conecte o Hermes Agent.
Etapa 3: inicie o Hermes Agent
Depois de configurar o modelo, inicie a CLI clássica:
Ou experimente a interface de terminal mais recente:
Você deverá ver uma tela de boas-vindas ou um prompt que mostra o provedor/modelo selecionado. Teste com uma solicitação simples:
O resultado esperado é este:
Se o Hermes Agent abrir, mas responder com erros de modelo ou autenticação, execute:
Depois, escolha seu provedor novamente e verifique a chave de API ou o login OAuth.
Etapa 4: Transforme o Hermes Agent em um bot
Assim como o OpenClaw, o Hermes Agent também pode atuar como bot e se conectar aos seus aplicativos de chat:
Após a configuração, verifique o status do gateway:
Use o gateway somente depois que seu provedor de modelo estiver funcionando no terminal. Se a CLI não conseguir concluir um chat básico, o bot geralmente falhará pelo mesmo motivo.
Problemas comuns na instalação do Hermes Agent
hermes: comando não encontrado
Causa: seu terminal ainda não recarregou a alteração no PATH.
Correção:
Ou:
Em seguida, tente:
git: comando não encontrado
Causa: o Git está ausente.
Correção no Ubuntu, Debian ou WSL2:
Correção no macOS com Homebrew:
Chave de API não configurada
Causa: o Hermes Agent está instalado, mas nenhuma chave de provedor ou login foi configurado.
Correção:
Ou defina uma chave manualmente:
hermes doctor informa configuração ausente ou desatualizada
Causa: seu arquivo de configuração pode estar incompleto após uma atualização.
Correção:
O endpoint personalizado se conecta, mas fornece respostas ruins
Causa: a URL base, o nome do modelo ou o tamanho do contexto está incorreto.
Correção: primeiro teste o endpoint em um cliente separado, confirme que ele é compatível com OpenAI e verifique se o modelo oferece suporte a pelo menos 64K de contexto para fluxos de trabalho normais do Hermes Agent.
Referência rápida de comandos
Conclusão
A maneira mais fácil de instalar o Hermes Agent é usar o instalador oficial de uma linha, recarregar seu shell, executar hermes model e verificar a configuração com um chat real e hermes doctor. Mantenha a primeira configuração simples: uma máquina, um provedor e uma conversa funcional. Quando o assistente base do Hermes Agent estiver estável, você poderá ampliá-lo com segurança usando isolamento com Docker, bots de gateway, habilidades, automações agendadas e provedores de modelo personalizados.
Perguntas frequentes
~/.hermes/ e pode ser ampliada com habilidades, memória, tarefas agendadas e gateways de mensagens.iex (irm https://hermes-agent.nousresearch.com/install.ps1) no PowerShell ou usar o pacote desktop MSIX. O WSL2 continua sendo uma alternativa opcional.hermes model, escolha um provedor, como o Kimi, inicie o hermes, teste uma conversa comum, execute hermes doctor e confirme que hermes --continue retoma sua sessão. Depois disso, adicione isolamento com Docker, skills, servidores MCP, voz, cron ou um gateway de mensagens, conforme necessário.