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

Installazione di Hermes (Linux, macOS, WSL2). L'installer ufficiale scaricherà 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, riavvia la shell e verifica il funzionamento:

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

Chiave API JoinGonka: se non ne hai ancora una, registrati su gate.joingonka.ai/register, conferma il tuo indirizzo — riceverai 3M di token gratuiti sul conto — e crea una chiave con il prefisso jg- nella Dashboard. Una singola chiave e un unico 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 di JoinGonka è esattamente così. Esistono tre modi per configurarlo.

Metodo 1: il nostro installer (un unico comando, consigliato). Configurerà il provider nel file di configurazione di Hermes, imposterà DeepSeek V4 Flash come modello predefinito e verificherà con una richiesta live che il gateway accetti la chiave e il modello:

npx @joingonka/setup --tool hermes

Metodo 2: wizard di configurazione. Esegui nel terminale fuori dalla sessione attiva:

hermes model

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

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

Metodo 3: modifica del file di configurazione. Hermes conserva le impostazioni dei modelli in ~/.hermes/config.yaml: è l'unica fonte di verità. Aggiungi la sezione:

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

⚠️ La chiave va solo in model.api_key. La documentazione di Hermes consente 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 nel .env il gateway risponderà 401 Invalid API key. Testato su Hermes v0.20.4.

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

Passaggio al volo: all'interno della sessione con il comando /model custom:deepseek-ai/DeepSeek-V4-Flash-0731. E /model custom senza nome caricherà automaticamente il modello dall'endpoint, se è l'unico presente.

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.