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 è esattamente così. Esistono due modi per configurarlo.

Metodo 1: wizard di configurazione (consigliato). Esegui nel terminale fuori da una 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: MiniMaxAI/MiniMax-M2.7

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

# ~/.hermes/config.yaml
model:
  provider: custom
  default: MiniMaxAI/MiniMax-M2.7
  base_url: https://gate.joingonka.ai/v1
  api_key: jg-tua-chiave

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 tramite il comando /model custom:MiniMaxAI/MiniMax-M2.7. E /model custom, senza nome, prenderà automaticamente il modello dall'endpoint se è l'unico presente.

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

Con JoinGonka Gateway, Hermes può rimanere in funzione 24 ore su 24: report notturni, audit settimanali, attività in background tramite cron-scheduler, senza preoccuparsi della bolletta. Con i prezzi di Anthropic, ogni esecuzione dovrebbe essere calcolata manualmente. I 10M di token gratuiti alla registrazione bastano per decine di sessioni complete.

Tramite il Gateway, l'utente ha subito a disposizione due modelli Gonka — entrambi supportano il native tool calling (OpenAI function calling), quindi le abilità e gli strumenti di Hermes funzionano in modo affidabile, senza bisogno di analizzare le risposte testuali:

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

Strumenti da terminale simili nella nostra knowledge base: Claude Code, Cline.