> ## Documentation Index
> Fetch the complete documentation index at: https://novita.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Hermes

> Conecte o Hermes ao endpoint da API de LLM compatível com OpenAI da Novita.

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](https://novita.ai/settings/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`.

<Tip>
  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.
</Tip>

## 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

```bash theme={"system"}
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
```

### Windows PowerShell

```bash theme={"system"}
iex (irm https://hermes-agent.nousresearch.com/install.ps1)
```

### Desktop

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

```text theme={"system"}
https://hermes-agent.nousresearch.com/desktop
```

## 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:

```bash theme={"system"}
source ~/.zshrc
```

## Iniciar o Hermes

Inicie o Hermes pelo terminal:

```bash theme={"system"}
hermes
```

Envie uma mensagem de teste, por exemplo:

```text theme={"system"}
Hello, briefly describe what coding tasks you can help with.
```

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.