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

# Hermes Agent

> Configura Venice come provider in Hermes Agent di Nous Research per AI privata con memoria persistente, skill personalizzate e oltre 230 modelli.

[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, editing, upscaling e analisi con modelli di chat compatibili con i video |
| **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={null}
    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={null}
    curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
    ```
  </Tab>
</Tabs>

Dopo l'installazione, ricarica la shell:

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

### 2. Configura Venice come provider

Esegui la procedura guidata di configurazione del modello:

```bash theme={null}
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?utm_source=venice-api-documentation) se non ne hai già una.

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

  ```yaml theme={null}
  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={null}
  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={null}
hermes model              # procedura guidata completa
```

Oppure cambialo a sessione in corso:

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

### 4. Inizia a chattare

Apri la CLI classica o la TUI moderna:

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

Prova un prompt per verificare che tutto funzioni:

```text theme={null}
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={null}
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={null}
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={null}
hermes skills install veniceai/skills
```

Oppure cerca skill individuali:

```bash theme={null}
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>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.