Hermes Agent with Venice | Venice API Docs

Hermes Agent è un agente AI open source e self-hosted costruito da Nous Research. 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.

Documentazione Hermes Agent

Documentazione completa, configurazione del provider e opzioni di configurazione nei doc ufficiali di Hermes Agent.

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

Inferenza privata

Zero data retention. I prompt non vengono mai memorizzati o registrati

Memoria persistente

Hermes ricorda il contesto tra sessioni e riavvii

Oltre 15 piattaforme

Raggiungi il tuo agente su Telegram, Discord, Slack, WhatsApp e altri

Configurazione

1. Installa Hermes Agent

macOS / Linux
WSL2 (Windows)

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

Installa prima WSL2, poi esegui lo stesso comando:

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

Dopo l’installazione, ricarica la shell:

source ~/.zshrc   # oppure: source ~/.bashrc

2. Configura Venice come provider

Esegui la procedura guidata di configurazione del modello:

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 se non ne hai già una.

Puoi anche configurare Venice direttamente in ~/.hermes/config.yaml:

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:

VENICE_API_KEY=your-key-here

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:

hermes model              # procedura guidata completa

Oppure cambialo a sessione in corso:

/model custom:claude-opus-4-7

4. Inizia a chattare

Apri la CLI classica o la TUI moderna:

hermes            # CLI classica
hermes --tui      # TUI moderna (consigliata)

Prova un prompt per verificare che tutto funzioni:

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:

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.

hermes gateway      # avvia il gateway di messaggistica

Modalità di privacy

I modelli Venice in Hermes Agent seguono gli stessi tier di 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. 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:

hermes skills install veniceai/skills

Oppure cerca skill individuali:

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

Documentazione Hermes Agent

Documentazione ufficiale

GitHub

Codice sorgente e release

Catalogo modelli Venice

Sfoglia i modelli disponibili

Privacy di Venice

Come Venice protegge i tuoi dati

Guides

Getting Started

Text & Chat

Image & Video

Agents & Integrations

Agent Tooling

Coding Tools

SDKs & Frameworks

Projects

Hermes Agent

Documentazione Hermes Agent

Perché Venice + Hermes Agent?

Inferenza privata

Memoria persistente

Oltre 15 piattaforme

Configurazione

1. Installa Hermes Agent

2. Configura Venice come provider

3. Scegli un modello

4. Inizia a chattare

Collega piattaforme di messaggistica

Modalità di privacy

Venice API skills

Comandi chiave

Risorse

Documentazione Hermes Agent

GitHub

Catalogo modelli Venice

Privacy di Venice

Documentazione Hermes Agent

​Perché Venice + Hermes Agent?

Inferenza privata

Memoria persistente

Oltre 15 piattaforme

​Configurazione

​1. Installa Hermes Agent

​2. Configura Venice come provider

​3. Scegli un modello

​4. Inizia a chattare

​Collega piattaforme di messaggistica

​Modalità di privacy

​Venice API skills

​Comandi chiave

​Risorse

Documentazione Hermes Agent

GitHub

Catalogo modelli Venice

Privacy di Venice

Perché Venice + Hermes Agent?

Configurazione

1. Installa Hermes Agent

2. Configura Venice come provider

3. Scegli un modello

4. Inizia a chattare

Collega piattaforme di messaggistica

Modalità di privacy

Venice API skills

Comandi chiave

Risorse