Hermes Agent + DeepSeek sulla rete Gonka — agente autonomo a costi irrisori

Installazione di Hermes (Linux, macOS, WSL2). L'installer ufficiale scarica automaticamente 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 ricarica la shell e verifica che parta:

source ~/.bashrc   # or ~/.zshrc
hermes             # interactive CLI

Chiave API di JoinGonka: se non ne hai ancora una, registrati su gate.joingonka.ai/register, conferma l'indirizzo — sul conto arriveranno 3M token gratuiti — e crea una chiave con prefisso jg- nella Dashboard. Una sola chiave e un solo saldo funzionano subito per tutti i modelli.

Hermes funziona con qualsiasi endpoint compatibile con OpenAI: se il server risponde su /v1/chat/completions, puoi indirizzare Hermes verso di esso. Il gateway JoinGonka è proprio così. Ci sono tre modi per configurarlo.

Modo 1: il nostro installer (un solo comando, consigliato). Scrive il provider nel config di Hermes, imposta DeepSeek V4 Flash come modello predefinito e verifica con una richiesta reale che il gateway accetti la chiave e il modello:

npx @joingonka/setup --tool hermes

Modo 2: procedura guidata. Avvia nel terminale fuori da una sessione attiva:

hermes model

Nell'elenco dei provider scegli «Custom endpoint (self-hosted / VLLM / etc.)» e inserisci tre valori:

• API base URL: https://gate.joingonka.ai/v1
• API key: jg-your-key
• Model name: deepseek-ai/DeepSeek-V4-Flash-0731

Modo 3: modifica del config. Hermes conserva le impostazioni dei modelli in ~/.hermes/config.yaml (nella build nativa per Windows — %LOCALAPPDATA%\hermes\config.yaml) — è l'unica fonte di verità. Aggiungi la sezione:

# ~/.hermes/config.yaml
model:
  provider: custom
  default: deepseek-ai/DeepSeek-V4-Flash-0731
  base_url: https://gate.joingonka.ai/v1
  api_key: jg-your-key

Il nome del modello va inserito nella chiave default — è la chiave canonica di Hermes. La riga model: all'interno del blocco è solo un alias di riserva: non ha effetto se default è già impostato (ad esempio dalla procedura guidata), quindi quando modifichi a mano cambia proprio default.

⚠️ La chiave va solo in model.api_key. La documentazione di Hermes ammette OPENAI_API_KEY in ~/.hermes/.env, ma per un endpoint personalizzato non funziona: Hermes legge la chiave solo da model.api_key, e con la chiave in .env il gateway risponderà 401 Invalid API key. Verificato su Hermes v0.20.4.

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

Cambio al volo: all'interno della sessione con il comando /model custom:deepseek-ai/DeepSeek-V4-Flash-0731. E /model custom senza nome recupererà automaticamente il modello dall'endpoint, se ce n'è uno solo.

Hermes è uno strumento basato su agenti con memoria e competenze. Non risponde solo con una battuta: legge file, scrive codice, esegue comandi, comprime il contesto e gestisce lunghe attività in background tramite scheduler. Ogni azione è una chiamata API e in una giornata di lavoro autonomo si accumulano decine di milioni di token. Confrontiamo i costi delle sessioni tipiche:

Con il gateway JoinGonka, Hermes può essere tenuto attivo 24 ore su 24: report notturni, audit settimanali, attività in background tramite cron, senza preoccuparsi dei costi. Con i prezzi di Anthropic, ogni esecuzione dovrebbe essere calcolata manualmente. Il credito iniziale al momento della registrazione è sufficiente per testare l'agente su un compito reale e vedere i propri consumi prima della prima ricarica.

Tramite il Gateway, l'utente ha accesso immediato a tre modelli Gonka. Tutti supportano il tool calling nativo (OpenAI function calling), quindi le competenze e gli strumenti di Hermes funzionano in modo affidabile, senza dover analizzare le risposte testuali:

Informazioni sui limiti di token in Hermes. Nel file config.yaml, il campo context_length indica la finestra di contesto totale (input + output), mentre max_tokens è il limite massimo per la sola lunghezza della risposta. È preferibile non impostare nessuno dei due: Hermes determinerà automaticamente i valori corretti dal provider. Se imposti max_tokens manualmente, mantienilo entro i limiti del modello: tramite Gateway sono 32768 per DeepSeek V4 Flash e 8192 per MiniMax M2.7 e GLM-5.3 Flash. 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.