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

# Hermes Agent

> Usa Venice AI come provider di modelli in Hermes Agent

[Hermes Agent](https://hermes-agent.nousresearch.com) è un agente AI open source e self-hosted costruito da [Nous Research](https://nousresearch.com). Offre memoria persistente, creazione autonoma di skill e un loop di apprendimento integrato che diventa più capace più a lungo viene eseguito. Puntalo all'API Venice e il tuo agente ottiene accesso a oltre 230 modelli e strumenti per testo, immagini, video, audio, embeddings e altro.

<Card title="Documentazione Hermes Agent" icon="arrow-up-right-from-square" href="https://hermes-agent.nousresearch.com/docs/">
  Documentazione completa, configurazione del provider e opzioni di configurazione nei doc ufficiali di Hermes Agent.
</Card>

## Perché Venice + Hermes Agent?

L'API Venice offre al tuo Hermes Agent l'accesso all'intera piattaforma Venice tramite un singolo endpoint compatibile con OpenAI.

| Capacità         | Cosa ottieni                                                    |
| ---------------- | --------------------------------------------------------------- |
| **Testo e chat** | Modelli privati e anonimizzati (GLM, Qwen, Claude, GPT e altri) |
| **Immagini**     | Generazione, editing, upscaling e rimozione dello sfondo        |
| **Video**        | Generazione e trascrizione                                      |
| **Audio**        | Sintesi vocale (TTS), generazione musicale e speech-to-text     |
| **Embeddings**   | Vector embeddings per RAG e ricerca semantica                   |
| **Strumenti**    | Web scraping, web search, text parsing e crypto RPC             |

<CardGroup cols={3}>
  <Card title="Inferenza privata" icon="shield-halved">
    Zero data retention. I prompt non vengono mai memorizzati o registrati
  </Card>

  <Card title="Memoria persistente" icon="brain">
    Hermes ricorda il contesto tra sessioni e riavvii
  </Card>

  <Card title="Oltre 15 piattaforme" icon="comments">
    Raggiungi il tuo agente su Telegram, Discord, Slack, WhatsApp e altri
  </Card>
</CardGroup>

## Configurazione

### 1. Installa Hermes Agent

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

  <Tab title="WSL2 (Windows)">
    Installa prima [WSL2](https://learn.microsoft.com/en-us/windows/wsl/install), poi esegui lo stesso comando:

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

Dopo l'installazione, ricarica la shell:

```bash theme={"dark"}
source ~/.zshrc   # oppure: source ~/.bashrc
```

### 2. Configura Venice come provider

Esegui la procedura guidata di configurazione del modello:

```bash theme={"dark"}
hermes model
```

Seleziona **Custom endpoint (self-hosted / VLLM / etc.)** e inserisci quanto segue quando richiesto:

| Campo            | Valore                               |
| ---------------- | ------------------------------------ |
| **API base URL** | `https://api.venice.ai/api/v1`       |
| **API key**      | La tua API key Venice                |
| **Model name**   | Un ID di modello Venice (vedi sotto) |

Ottieni una API key da [venice.ai/settings/api](https://venice.ai/settings/api) se non ne hai già una.

<Tip>
  Puoi anche configurare Venice direttamente in `~/.hermes/config.yaml`:

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

  E imposta la chiave in `~/.hermes/.env`:

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

### 3. Scegli un modello

Quando la procedura guidata chiede un modello, scegline uno in base al tuo caso d'uso:

| Caso d'uso        | Modello                 | Privacy    |
| ----------------- | ----------------------- | ---------- |
| Generale          | `zai-org-glm-5`         | Private    |
| Ragionamento      | `kimi-k2-6`             | Private    |
| Coding            | `claude-opus-4-7`       | Anonymized |
| Vision            | `z-ai-glm-5v-turbo`     | Anonymized |
| Senza restrizioni | `venice-uncensored-1-2` | Private    |

Cambia il modello in qualsiasi momento, senza riavvio:

```bash theme={"dark"}
hermes model              # procedura guidata completa
```

Oppure cambialo a sessione in corso:

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

### 4. Inizia a chattare

Apri la CLI classica o la TUI moderna:

```bash theme={"dark"}
hermes            # CLI classica
hermes --tui      # TUI moderna (consigliata)
```

Prova un prompt per verificare che tutto funzioni:

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

## Collega piattaforme di messaggistica

Una volta che la CLI funziona, collega le tue app di messaggistica tramite il gateway:

```bash theme={"dark"}
hermes gateway setup
```

Ti guiderà nella connessione di Telegram, Discord, Slack, WhatsApp, Signal e altre piattaforme. Il tuo agente diventa raggiungibile da qualsiasi canale connesso, tutto alimentato da Venice.

```bash theme={"dark"}
hermes gateway      # avvia il gateway di messaggistica
```

## Modalità di privacy

I modelli Venice in Hermes Agent seguono gli stessi [tier di privacy](/overview/privacy) dell'API Venice:

* I modelli **Private** (GLM, Qwen, DeepSeek, Llama, Venice Uncensored) vengono eseguiti sulla flotta GPU di Venice. I prompt non vengono mai memorizzati o registrati.
* I modelli **Anonymized** (Claude, GPT, Gemini, Grok) vengono inoltrati tramite Venice con tutte le informazioni identificative rimosse. Il provider di terze parti vede Venice come cliente, non te.

## Venice API skills

Hermes Agent dispone di un sistema di skill integrato compatibile con il formato [Agent Skills](https://github.com/veniceai/skills). Venice pubblica skill ufficiali che insegnano al tuo agente come usare ogni endpoint Venice (chat, generazione immagini, video, audio, embeddings, strumenti augment e altri).

Installa le skill Venice direttamente da GitHub:

```bash theme={"dark"}
hermes skills install veniceai/skills
```

Oppure cerca skill individuali:

```bash theme={"dark"}
hermes skills search venice
```

Hermes scoprirà ciascuna skill tramite il frontmatter di `SKILL.md` e la caricherà su richiesta.

## Comandi chiave

| Comando             | Descrizione                              |
| ------------------- | ---------------------------------------- |
| `hermes`            | Avvia la chat                            |
| `hermes model`      | Cambia provider o modello                |
| `hermes tools`      | Configura quali strumenti sono abilitati |
| `hermes gateway`    | Avvia il gateway di messaggistica        |
| `hermes --continue` | Riprendi la tua ultima sessione          |
| `hermes doctor`     | Diagnostica i problemi                   |
| `hermes update`     | Aggiorna all'ultima versione             |

## Risorse

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

  <Card title="GitHub" icon="github" href="https://github.com/NousResearch/hermes-agent">
    Codice sorgente e release
  </Card>

  <Card title="Catalogo modelli Venice" icon="list" href="/models/text">
    Sfoglia i modelli disponibili
  </Card>

  <Card title="Privacy di Venice" icon="shield-halved" href="/overview/privacy">
    Come Venice protegge i tuoi dati
  </Card>
</CardGroup>