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

> Verbinde Hermes mit Novitas OpenAI-kompatiblem LLM-API-Endpunkt.

Hermes ist ein Agent-Tool von Nous Research. Es kann eine Verbindung zu einem benutzerdefinierten OpenAI-kompatiblen Endpunkt herstellen, sodass du Novita-LLM-Modelle in Hermes für lokale Agent-Workflows verwenden kannst.

## Voraussetzungen

Bereite vor dem Start die folgenden Werte vor:

* **API key**: Erstelle oder kopiere einen API-Schlüssel in der [Key Management](https://novita.ai/settings/key-management).
* **Base URL**: `https://api.novita.ai/openai/v1`
* **Model ID**: Kopiere die Modell-ID, die du verwenden möchtest, aus dem Model Hub, zum Beispiel `deepseek/deepseek-v3.1`.

<Tip>
  Hermes speichert Endpunkt- und API-Schlüsseleinstellungen lokal. Committe keine generierte Konfiguration, die deinen API-Schlüssel enthält.
</Tip>

## Hermes installieren

Hermes bietet Installationsoptionen für Terminal und Desktop. Wähle die Option, die zu deinem Workflow passt.

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

Du kannst Hermes Desktop auch hier herunterladen:

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

## Den Novita-Endpunkt konfigurieren

Führe nach der Installation den Hermes-Einrichtungsablauf aus. Der genaue Befehl kann je nach Hermes-Version variieren. Folge daher den Terminal-Eingabeaufforderungen deiner installierten Version.

Verwende während der Einrichtung die folgenden Auswahlmöglichkeiten und Werte:

1. Wähle **Custom endpoint** oder die Option, mit der du eine Anbieter-URL manuell eingeben kannst.
2. Setze die Base URL auf `https://api.novita.ai/openai/v1`.
3. Gib deinen Novita-API-Schlüssel ein.
4. Behalte für den API-Typ die Standardoption zur automatischen Erkennung bei. Wenn du manuell auswählen musst, wähle den OpenAI-kompatiblen oder Chat Completions-Modus.
5. Wähle ein Modell aus der Liste aus oder gib eine Novita-Modell-ID manuell ein, zum Beispiel `deepseek/deepseek-v3.1`.
6. Lege max tokens basierend auf der Kontextlänge des Modells fest. Wenn du dir nicht sicher bist, behalte den Standardwert oder den automatisch erkannten Wert bei.
7. Gib der Modellkonfiguration einen leicht erkennbaren Namen, zum Beispiel `novita-deepseek-v3.1`.
8. Wenn du Hermes nur lokal ausführen möchtest, wähle die standardmäßige Local-Laufzeitumgebung.
9. Wenn du keine Kanäle wie Telegram, Slack oder Matrix benötigst, überspringe die Integrationskanäle.

## Deine Shell neu laden

Wenn Hermes dich auffordert, deine Shell neu zu laden, führe Folgendes aus:

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

## Hermes starten

Starte Hermes über dein Terminal:

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

Sende eine Testnachricht, zum Beispiel:

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

Wenn die Anfrage fehlschlägt, überprüfe Folgendes:

* Dein API-Schlüssel ist korrekt.
* Die Base URL lautet `https://api.novita.ai/openai/v1`.
* Die Modell-ID stimmt mit der im Model Hub von Novita angezeigten überein.
* Der ausgewählte API-Typ ist mit einem OpenAI-kompatiblen Endpunkt kompatibel.