Skip to main content
Hermes é uma ferramenta de agente da Nous Research. Ele pode se conectar a um endpoint personalizado compatível com OpenAI, para que você possa usar modelos de LLM da Novita dentro do Hermes em fluxos de trabalho locais de agentes.

Pré-requisitos

Antes de começar, prepare os seguintes valores:
  • Chave de API: Crie ou copie uma chave de API em Key Management.
  • URL base: https://api.novita.ai/openai/v1
  • ID do modelo: Copie do Model Hub o ID do modelo que você deseja usar, como deepseek/deepseek-v3.1.
O Hermes armazena localmente as configurações de endpoint e chave de API. Não faça commit de nenhuma configuração gerada que contenha sua chave de API.

Instalar o Hermes

O Hermes oferece opções de instalação via terminal e desktop. Escolha a que melhor se adapta ao seu fluxo de trabalho.

Linux / macOS / WSL2

Windows PowerShell

Desktop

Você também pode baixar o Hermes Desktop em:

Configurar o endpoint da Novita

Após a instalação, execute o fluxo de configuração do Hermes. O comando exato pode variar de acordo com a versão do Hermes, portanto siga as instruções do terminal da versão instalada. Durante a configuração, use as seguintes escolhas e valores:
  1. Selecione Custom endpoint ou a opção que permite inserir manualmente uma URL de provedor.
  2. Defina a URL base como https://api.novita.ai/openai/v1.
  3. Insira sua chave de API da Novita.
  4. Para o tipo de API, mantenha a opção padrão de detecção automática. Se precisar escolher manualmente, selecione o modo compatível com OpenAI ou Chat Completions.
  5. Selecione um modelo na lista ou insira manualmente um ID de modelo da Novita, como deepseek/deepseek-v3.1.
  6. Defina o máximo de tokens com base no tamanho de contexto do modelo. Se não tiver certeza, mantenha o valor padrão ou detectado automaticamente.
  7. Dê à configuração do modelo um nome reconhecível, como novita-deepseek-v3.1.
  8. Se você quiser executar o Hermes apenas localmente, escolha o runtime padrão Local.
  9. Se você não precisar de canais como Telegram, Slack ou Matrix, pule os canais de integração.

Recarregar seu shell

Se o Hermes solicitar que você recarregue seu shell, execute:

Iniciar o Hermes

Inicie o Hermes pelo terminal:
Envie uma mensagem de teste, por exemplo:
Se a solicitação falhar, verifique se:
  • Sua chave de API está correta.
  • A URL base é https://api.novita.ai/openai/v1.
  • O ID do modelo corresponde ao exibido no Model Hub da Novita.
  • O tipo de API selecionado é compatível com um endpoint compatível com OpenAI.
Última modificação em 10 de agosto de 2026