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

> Verbind Hermes met Novita's OpenAI-compatibele LLM API-endpoint.

Hermes is een agenttool van Nous Research. Het kan verbinding maken met een aangepast OpenAI-compatibel endpoint, zodat je Novita LLM-modellen binnen Hermes kunt gebruiken voor lokale agentworkflows.

## Vereisten

Bereid de volgende waarden voor voordat je begint:

* **API key**: Maak of kopieer een API key via [Key Management](https://novita.ai/settings/key-management).
* **Base URL**: `https://api.novita.ai/openai/v1`
* **Model ID**: Kopieer de model-ID die je wilt gebruiken uit de Model Hub, zoals `deepseek/deepseek-v3.1`.

<Tip>
  Hermes slaat endpoint- en API key-instellingen lokaal op. Commit geen gegenereerde configuratie die je API key bevat.
</Tip>

## Hermes installeren

Hermes biedt installatieopties voor terminal en desktop. Kies de optie die bij je workflow past.

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

Je kunt Hermes Desktop ook downloaden via:

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

## Het Novita-endpoint configureren

Voer na de installatie de Hermes-installatiestroom uit. De exacte opdracht kan per Hermes-versie verschillen, dus volg de terminalprompts van je geïnstalleerde versie.

Gebruik tijdens de configuratie de volgende keuzes en waarden:

1. Selecteer **Custom endpoint** of de optie waarmee je handmatig een provider-URL kunt invoeren.
2. Stel de Base URL in op `https://api.novita.ai/openai/v1`.
3. Voer je Novita API key in.
4. Behoud voor API-type de standaardoptie voor automatische detectie. Als je handmatig moet kiezen, selecteer dan de OpenAI-compatibele modus of Chat Completions-modus.
5. Selecteer een model uit de lijst, of voer handmatig een Novita model-ID in, zoals `deepseek/deepseek-v3.1`.
6. Stel max tokens in op basis van de contextlengte van het model. Als je het niet zeker weet, behoud dan de standaardwaarde of de automatisch gedetecteerde waarde.
7. Geef de modelconfiguratie een herkenbare naam, zoals `novita-deepseek-v3.1`.
8. Als je Hermes alleen lokaal wilt uitvoeren, kies dan de standaard Local runtime.
9. Als je geen kanalen zoals Telegram, Slack of Matrix nodig hebt, sla dan integratiekanalen over.

## Je shell opnieuw laden

Als Hermes je vraagt om je shell opnieuw te laden, voer dan uit:

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

## Hermes starten

Start Hermes vanuit je terminal:

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

Stuur een testbericht, bijvoorbeeld:

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

Als de aanvraag mislukt, controleer dan of:

* Je API key correct is.
* De Base URL `https://api.novita.ai/openai/v1` is.
* De model-ID overeenkomt met degene die wordt weergegeven in Novita's Model Hub.
* Het geselecteerde API-type compatibel is met een OpenAI-compatibel endpoint.