> ## Documentation Index
> Fetch the complete documentation index at: https://veniceai-mintlify-d2fddb8a.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Hermes Agent

> Richten Sie Venice als Modellanbieter in Hermes Agent ein — für private, unzensierte KI mit persistentem Gedächtnis, eigenen Skills und Multi-Plattform-Messaging.

[Hermes Agent](https://hermes-agent.nousresearch.com) ist ein quelloffener, selbstgehosteter KI-Agent von [Nous Research](https://nousresearch.com). Er bietet persistentes Memory, autonomes Skill-Erstellen und einen eingebauten Lern-Loop, der mit der Laufzeit immer fähiger wird. Richte ihn auf die Venice-API aus, und dein Agent erhält Zugriff auf über 230 Modelle und Tools für Text, Bild, Video, Audio, Embeddings und mehr.

<Card title="Hermes Agent Docs" icon="arrow-up-right-from-square" href="https://hermes-agent.nousresearch.com/docs/">
  Vollständige Dokumentation, Provider-Setup und Konfigurationsoptionen in den offiziellen Hermes Agent-Docs.
</Card>

## Warum Venice + Hermes Agent?

Die Venice-API gibt deinem Hermes Agent über einen einzigen OpenAI-kompatiblen Endpoint Zugriff auf die gesamte Venice-Plattform.

| Fähigkeit         | Was du bekommst                                                  |
| ----------------- | ---------------------------------------------------------------- |
| **Text und Chat** | Private und anonymized Modelle (GLM, Qwen, Claude, GPT und mehr) |
| **Image**         | Generierung, Bearbeitung, Upscaling und Hintergrundentfernung    |
| **Video**         | Generierung und Transkription                                    |
| **Audio**         | Sprachsynthese (TTS), Musikgenerierung und Speech-to-Text        |
| **Embeddings**    | Vektor-Embeddings für RAG und semantische Suche                  |
| **Tools**         | Web-Scraping, Web-Suche, Text-Parsing und Crypto RPC             |

<CardGroup cols={3}>
  <Card title="Private Inference" icon="shield-halved">
    Zero Data Retention. Prompts werden niemals gespeichert oder geloggt
  </Card>

  <Card title="Persistentes Memory" icon="brain">
    Hermes erinnert sich an Kontext über Sessions und Neustarts hinweg
  </Card>

  <Card title="15+ Plattformen" icon="comments">
    Erreiche deinen Agenten auf Telegram, Discord, Slack, WhatsApp und mehr
  </Card>
</CardGroup>

## Einrichtung

### 1. Hermes Agent installieren

<Tabs>
  <Tab title="macOS / Linux">
    ```bash theme={null}
    curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
    ```
  </Tab>

  <Tab title="WSL2 (Windows)">
    Installiere zuerst [WSL2](https://learn.microsoft.com/en-us/windows/wsl/install) und führe dann denselben Befehl aus:

    ```bash theme={null}
    curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
    ```
  </Tab>
</Tabs>

Lade deine Shell nach der Installation neu:

```bash theme={null}
source ~/.zshrc   # oder: source ~/.bashrc
```

### 2. Venice als Provider konfigurieren

Starte den Modell-Setup-Wizard:

```bash theme={null}
hermes model
```

Wähle **Custom endpoint (self-hosted / VLLM / etc.)** und gib bei Aufforderung Folgendes an:

| Feld              | Wert                                |
| ----------------- | ----------------------------------- |
| **API Base URL**  | `https://api.venice.ai/api/v1`      |
| **API-Schlüssel** | Dein Venice API-Schlüssel           |
| **Modellname**    | Eine Venice-Modell-ID (siehe unten) |

Hol dir einen API-Schlüssel unter [venice.ai/settings/api](https://venice.ai/settings/api), falls noch nicht vorhanden.

<Tip>
  Du kannst Venice auch direkt in `~/.hermes/config.yaml` konfigurieren:

  ```yaml theme={null}
  model:
    default: zai-org-glm-5
    provider: custom
    base_url: https://api.venice.ai/api/v1
    api_key: ${VENICE_API_KEY}
  ```

  Und den Schlüssel in `~/.hermes/.env` setzen:

  ```bash theme={null}
  VENICE_API_KEY=your-key-here
  ```
</Tip>

### 3. Modell auswählen

Wenn der Wizard nach einem Modell fragt, wähle eins passend zu deinem Anwendungsfall:

| Anwendungsfall | Modell                  | Privacy    |
| -------------- | ----------------------- | ---------- |
| Allgemein      | `zai-org-glm-5`         | Private    |
| Reasoning      | `kimi-k2-6`             | Private    |
| Coding         | `claude-opus-4-7`       | Anonymized |
| Vision         | `z-ai-glm-5v-turbo`     | Anonymized |
| Uncensored     | `venice-uncensored-1-2` | Private    |

Modell jederzeit ohne Neustart wechseln:

```bash theme={null}
hermes model              # vollständiger Wizard
```

Oder mitten in der Session umschalten:

```text theme={null}
/model custom:claude-opus-4-7
```

### 4. Chatten

Öffne die klassische CLI oder die moderne TUI:

```bash theme={null}
hermes            # klassische CLI
hermes --tui      # moderne TUI (empfohlen)
```

Teste mit einem Prompt, ob alles funktioniert:

```text theme={null}
Summarize this repo in 5 bullets and tell me what the main entrypoint is.
```

## Messaging-Plattformen verbinden

Sobald die CLI läuft, verbinde deine Messaging-Apps über das Gateway:

```bash theme={null}
hermes gateway setup
```

Das führt dich durch die Verbindung mit Telegram, Discord, Slack, WhatsApp, Signal und weiteren Plattformen. Dein Agent wird über jeden verbundenen Kanal erreichbar – betrieben mit Venice.

```bash theme={null}
hermes gateway      # Messaging-Gateway starten
```

## Privacy-Modi

Venice-Modelle in Hermes Agent folgen denselben [Privacy-Stufen](/overview/privacy) wie die Venice-API:

* **Private**-Modelle (GLM, Qwen, DeepSeek, Llama, Venice Uncensored) laufen auf Venices GPU-Flotte. Prompts werden niemals gespeichert oder geloggt.
* **Anonymized**-Modelle (Claude, GPT, Gemini, Grok) werden über Venice geproxied, wobei alle identifizierenden Informationen entfernt werden. Der Drittanbieter sieht Venice als Kunden, nicht dich.

## Venice API-Skills

Hermes Agent hat ein integriertes Skills-System, das mit dem [Agent Skills](https://github.com/veniceai/skills)-Format kompatibel ist. Venice veröffentlicht offizielle Skills, die deinem Agent beibringen, wie er jeden Venice-Endpoint (Chat, Image Generation, Video, Audio, Embeddings, Augment-Tools und mehr) verwendet.

Venice-Skills direkt aus GitHub installieren:

```bash theme={null}
hermes skills install veniceai/skills
```

Oder nach einzelnen Skills suchen:

```bash theme={null}
hermes skills search venice
```

Hermes erkennt jeden Skill anhand seines `SKILL.md`-Frontmatters und lädt ihn bei Bedarf.

## Wichtige Befehle

| Befehl              | Beschreibung                           |
| ------------------- | -------------------------------------- |
| `hermes`            | Chat starten                           |
| `hermes model`      | Provider oder Modell ändern            |
| `hermes tools`      | Konfigurieren, welche Tools aktiv sind |
| `hermes gateway`    | Messaging-Gateway starten              |
| `hermes --continue` | Letzte Session fortsetzen              |
| `hermes doctor`     | Probleme diagnostizieren               |
| `hermes update`     | Auf die neueste Version aktualisieren  |

## Ressourcen

<CardGroup cols={2}>
  <Card title="Hermes Agent Docs" icon="book" href="https://hermes-agent.nousresearch.com/docs/">
    Offizielle Dokumentation
  </Card>

  <Card title="GitHub" icon="github" href="https://github.com/NousResearch/hermes-agent">
    Quellcode und Releases
  </Card>

  <Card title="Venice-Modellkatalog" icon="list" href="/models/text">
    Verfügbare Modelle durchsuchen
  </Card>

  <Card title="Venice Privacy" icon="shield-halved" href="/overview/privacy">
    Wie Venice deine Daten schützt
  </Card>
</CardGroup>