Pi + JoinGonka Gateway — agente terminale con inferenza economica

Pi è un coding-agent minimale da terminale, uno degli open harness a più rapida crescita nel 2026. I provider in esso sono descritti in modo dichiarativo in ~/.pi/agent/models.json, ed è adatto qualsiasi endpoint che parli OpenAI Completions o Anthropic Messages — il che significa che il JoinGonka Gateway si collega in entrambi i modi. I modelli della rete decentralizzata Gonka costano centinaia di volte meno dei prezzi delle GPU dei vendor, e i 3M token iniziali sono gratuiti.

Pi stesso si installa da npm: npm install -g --ignore-scripts @earendil-works/pi-coding-agent. Il nome del pacchetto è nuovo: il progetto si è trasferito nel repository earendil-works/pi, e il vecchio pacchetto @mariozechner/pi-coding-agent è stato dichiarato obsoleto e non viene più aggiornato. Se hai installato Pi con il vecchio nome, reinstallalo; la directory delle impostazioni ~/.pi/agent è rimasta la stessa dopo il trasferimento.

Percorso rapido: installer

Il metodo più breve è il nostro installer:

npx @joingonka/setup --tool pi

Questo configurerà il provider con i modelli di rete aggiornati in ~/.pi/agent/models.json, imposterà il modello predefinito in ~/.pi/agent/settings.json (non sovrascrive un modello scelto da te; questo viene modificato solo da un flag esplicito --model minimax|deepseek|glm) e verificherà con una richiesta live che il gateway accetti la chiave e il modello. Se la directory delle impostazioni è stata spostata tramite la variabile PI_CODING_AGENT_DIR, l'installer scriverà lì. La chiave viene inserita come literal nel file di configurazione con permessi 0600 — non è necessario esportare una variabile d'ambiente.

Configurazione manuale: provider in models.json

Ottieni la chiave jg-… alla registrazione e aggiungi il provider in ~/.pi/agent/models.json:

`baseUrl`	`https://gate.joingonka.ai/v1`
`api`	`openai-completions`
`apiKey`	la tua chiave `jg-…` come letterale. Pi accetta anche i riferimenti `$VAR`/`${VAR}` e `!command`, ma il letterale funziona senza variabile esportata — mantieni il file con permessi `0600`
`models`	array: `id`, `name`, `contextWindow`, `maxTokens`

Valori corretti per i modelli della rete: deepseek-ai/DeepSeek-V4-Flash-0731 — contextWindow 380000, maxTokens 32768; MiniMaxAI/MiniMax-M2.7 — contextWindow 200000, maxTokens 8192; zai-org/GLM-5.3-Flash — contextWindow 390000, maxTokens 8192. I default di Pi (128000/16384) non coincidono con i limiti reali della rete, quindi specifica entrambi i campi esplicitamente. Il modello predefinito vive in un ALTRO file — ~/.pi/agent/settings.json, campi defaultProvider e defaultModel. Verifica: pi --list-models deve mostrare i modelli aggiunti.

Il percorso Anthropic come alternativa

Il gateway supporta anche Anthropic Messages: provider con api: "anthropic-messages" e baseUrl: "https://gate.joingonka.ai" — senza il percorso /v1/messages, il client lo aggiungerà da solo. Per il lavoro quotidiano basta il percorso OpenAI; l'opzione Anthropic è utile se le tue estensioni di Pi sono ottimizzate per il formato Messages.

Nota sulla sicurezza

Pi per impostazione predefinita non ha un layer di permessi completo: l'agente esegue i comandi nel terminale senza le conferme passo-passo presenti in harness più complessi. Eseguilo in una sandbox — un container o un account separato — specialmente in attività autonome multi-step. Questa è una caratteristica di Pi, non del gateway.

Quale modello scegliere e quanto costa

Tutti e tre i modelli della rete supportano tool calling e streaming. Per sessioni lunghe e repository di grandi dimensioni, DeepSeek V4 Flash (uno dei contesti più lunghi della rete e output fino a 32768). MiniMax M2.7 è l'opzione versatile, GLM-5.3 Flash è il modello di reasoning con il contesto di rete più lungo (390K): ragiona prima di rispondere, quindi non impostare maxTokens troppo bassi. La tariffa è unica, i prezzi in tempo reale sono nel listino del gateway.

Se il minimalismo di Pi non ti basta, dai un'occhiata al suo fork omp (Oh My Pi): stessa idea di provider dichiarativi, ma con ruoli dei modelli, language server e sub-agent. Le configurazioni sono diverse, quindi omp va configurato a parte.

Pi si collega al JoinGonka Gateway con una singola voce nel file ~/.pi/agent/models.json: baseUrl gate.joingonka.ai/v1, api openai-completions, chiave letterale, modelli con contextWindow/maxTokens corretti. Ancora più veloce — npx @joingonka/setup --tool pi. Avvia l'agente nella sandbox e inizia con i token gratuiti iniziali.

← Zed + JoinGonka Gateway — inferenza economica nell'editor Codex CLI: la tua chiave invece dell'abbonamento →

Vuoi saperne di più?

Esplora altre sezioni o inizia a guadagnare GNK subito.

Ricevi token gratuiti →