Hermes Agent + Gonka AI — agente autonomo a basso costo

Installazione di Hermes (Linux, macOS, WSL2). L'installer ufficiale recupererà Python, Node.js, ripgrep e ffmpeg:

# Linux / macOS / WSL2
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

# Windows (PowerShell)
iex (irm https://hermes-agent.nousresearch.com/install.ps1)

Dopo l'installazione, riavvia la shell e verifica l'avvio:

source ~/.bashrc   # o ~/.zshrc
hermes             # CLI interattiva

Chiave API JoinGonka: se non hai ancora un account, registrati su gate.joingonka.ai/register, ottieni 10M token gratuiti e crea una chiave con il prefisso jg- nella Dashboard. Una singola chiave e un singolo saldo funzionano immediatamente per tutti i modelli.

Hermes funziona con qualsiasi endpoint compatibile con OpenAI: se il server risponde a /v1/chat/completions – Hermes può essere indirizzato lì. Il Gateway JoinGonka è proprio così. Ci sono due metodi di configurazione.

Metodo 1: wizard di configurazione (consigliato). Esegui nel terminale fuori da una sessione attiva:

hermes model

Nella lista dei provider, scegli «Custom endpoint (self-hosted / VLLM / etc.)» e inserisci tre valori:

• URL base API: https://gate.joingonka.ai/v1
• Chiave API: jg-la-tua-chiave
• Nome modello: Qwen/Qwen3-235B-A22B-Instruct-2507-FP8

Metodo 2: modifica della configurazione. Hermes salva le impostazioni dei modelli in ~/.hermes/config.yaml – questa è l'unica fonte di verità. Aggiungi la sezione:

# ~/.hermes/config.yaml
model:
  provider: custom
  default: Qwen/Qwen3-235B-A22B-Instruct-2507-FP8
  base_url: https://gate.joingonka.ai/v1
  api_key: jg-la-tua-chiave

Verifica: esegui hermes e scrivi «Crea un file hello.py con la funzione hello world». L'agente dovrebbe creare il file e mostrare il risultato. Lo stato della configurazione attuale è visibile tramite hermes config show | grep '^model\.' e hermes status.

Cambio al volo: all'interno della sessione con il comando /model custom:Qwen/Qwen3-235B-A22B-Instruct-2507-FP8. E /model custom senza nome caricherà il modello dall'endpoint, se ce n'è solo uno.

Hermes è uno strumento agente con memoria e capacità. Non risponde con un'unica replica: legge file, scrive codice, esegue comandi, comprime il contesto, gestisce attività in background a lungo termine tramite il pianificatore. Ogni azione è una chiamata API e in un giorno di lavoro autonomo si accumulano decine di milioni di token. Confrontiamo il costo delle sessioni tipiche:

Con JoinGonka Gateway Hermes può essere tenuto in funzione 24 ore su 24: report notturni, audit settimanali, attività in background tramite il pianificatore cron, senza preoccuparsi del costo. Ai prezzi di Anthropic, ogni avvio di questo tipo dovrebbe essere calcolato manualmente. I 10M di token gratuiti alla registrazione saranno sufficienti per decine di sessioni complete.

Tramite il Gateway l'utente ha immediatamente accesso a tre modelli Gonka – tutti supportano il tool calling nativo (OpenAI function calling), quindi le abilità e gli strumenti di Hermes funzionano in modo affidabile, senza parsing delle risposte testuali:

Riguardo ai limiti dei token in Hermes. Nel file config.yaml il campo context_length è la finestra di contesto completa (input + output), mentre max_tokens è il limite solo per la lunghezza della risposta. È meglio non impostare entrambi: Hermes determinerà automaticamente i valori corretti dal provider. Se imposti max_tokens manualmente, mantienilo entro i limiti del modello – per Qwen3-235B il massimo tramite Gateway è 8192. Puoi cambiare modello in qualsiasi momento con il comando hermes model o direttamente nella sessione tramite /model.

Strumenti terminali simili nella nostra base di conoscenza: Claude Code, Cline.