Hermes Agent é um agente de IA de código aberto da Nous Research que roda a partir do seu terminal, se conecta a diferentes provedores de modelos, lembra de contexto útil entre sessões e pode ser estendido com ferramentas, skills, gateways de mensagens e automações. Este guia ajuda você a saber como instalar o Hermes. Você não precisa instalar manualmente Python ou Node.js para o instalador padrão no macOS ou Windows, pois o instalador oficial cuida das principais dependências para você.
Antes de Instalar o Hermes Agent
O Hermes Agent é um software voltado para terminal, então você vai instalá-lo a partir de uma linha de comando. Escolha a seção que corresponde ao seu computador:
macOS: abra o Terminal em Aplicativos > Utilitários > Terminal, ou pressione Command + Espaço e busque por "Terminal".
Windows: instale o WSL2 primeiro, abra o terminal da sua distribuição Linux e siga o comando do Linux.
Você também precisa do Git. Verifique se o Git está instalado:
Saída esperada:
Se você vir git: command not found, instale o Git primeiro:
Se você não tiver o Homebrew no macOS, instale o Git a partir das Apple Command Line Tools executando:
Etapa 1: Instalar o Hermes Agent no macOS ou Windows
No seu terminal, copie e cole o comando oficial de instalação:
O instalador baixa o Hermes Agent, prepara seu ambiente Python, instala as dependências necessárias e adiciona o comando hermes ao caminho do seu shell. Em uma instalação normal de usuário, os dados do Hermes ficam armazenados em ~/.hermes/.
Quando o comando terminar, recarregue seu 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 conforme o Hermes Agent é atualizado.
Etapa 2: Configurar Seu Provedor de Modelo
O Hermes Agent precisa de um provedor de modelo antes de poder responder ou usar ferramentas. A configuração mais fácil para iniciantes é interativa:
O assistente permite escolher um provedor como Kimi/Moonshot. Não configure roteamento, fallback, gateway ou cron até que um chat básico funcione.
Selecione o modelo padrão. kimi-k2.6 é o modelo mais avançado do Kimi até agora.
Se você já souber o valor que deseja definir, pode usar hermes config set. Por exemplo:
Se você não tiver uma api-key, o Kimi pode ser uma boa escolha.
Etapa 1: Ativar sua API do Kimi
Antes de usar a Kimi API com o Hermes Agent, ative sua Chave da Kimi API na Plataforma Aberta Kimi. Recomendamos US$ 20 ou mais para desbloquear o acesso Tier 2, o que reduz a latência e oferece um desempenho mais estável para tarefas complexas e de várias etapas
Etapa 2: Criar sua Chave da Kimi API
Acesse a seção Chaves de API na Plataforma Aberta Kimi e clique em Criar Chave de API. Lembre-se de copiar sua chave de API e armazená-la com segurança, pois ela só é exibida 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: Iniciar o Hermes Agent
Depois que o modelo estiver configurado, inicie a CLI clássica:
Ou experimente a nova interface de terminal:
Você deve ver uma tela de boas-vindas ou um prompt mostrando o provedor/modelo selecionado. Teste com uma solicitação simples:
O sucesso se parece com isto:
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 um 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 funcionar 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: command not found
Causa: seu terminal ainda não recarregou a alteração do PATH.
Correção:
Ou:
Depois tente:
git: command not found
Causa: o Git não está instalado.
Correção no Ubuntu, Debian ou WSL2:
Correção no macOS com Homebrew:
Chave de API não definida
Causa: o Hermes Agent está instalado, mas nenhuma chave de provedor ou login foi configurado.
Correção:
Ou defina uma chave manualmente:
hermes doctor relata configuração ausente ou desatualizada
Causa: seu arquivo de configuração pode estar incompleto após uma atualização.
Correção:
Endpoint personalizado conecta, mas dá respostas ruins
Causa: a URL base, o nome do modelo ou o tamanho de contexto estão errados.
Correção: teste o endpoint primeiro em um cliente separado, confirme que ele é compatível com OpenAI e certifique-se de que o modelo suporte pelo menos 64K de contexto para os fluxos 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 mais o hermes doctor. Mantenha sua primeira configuração simples: uma máquina, um provedor, uma conversa funcionando. Depois que o assistente base do Hermes Agent estiver estável, você pode expandir com segurança usando isolamento com Docker, bots de gateway, skills, automações agendadas e provedores de modelo personalizados.
Perguntas frequentes
~/.hermes/ e pode ser estendido com skills, memória, tarefas agendadas e gateways de mensagens.hermes model, escolha um provedor, como o Kimi, inicie hermes, teste uma conversa normal, 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.