Pi + JoinGonka Gateway — agente terminale con inferenza economica

Pi è un coding-agente da terminale minimalista, uno dei più in rapida crescita nel 2026. I provider al suo interno sono descritti in modo dichiarativo nel file ~/.pi/agent/models.json, e qualsiasi endpoint che parli OpenAI Completions o Anthropic Messages può andare bene — quindi JoinGonka Gateway si collega in entrambi i modi. I modelli della rete decentralizzata Gonka costano centinaia di volte meno rispetto ai prezzi dei vendor, e i 10M di token iniziali sono gratuiti.

Percorso rapido: installer

L'opzione più veloce è il nostro installer:

npx @joingonka/setup --tool pi

Configurerà il provider con i modelli di rete correnti in ~/.pi/agent/models.json, imposterà il modello predefinito in ~/.pi/agent/settings.json (senza sovrascrivere le scelte esistenti) e verificherà con una richiesta live che il gateway accetti la chiave e il modello. La chiave viene inserita come letterale nel file di configurazione con permessi 0600 — non è necessario esportare variabili d'ambiente.

Configurazione manuale: provider in models.json

Ottieni la chiave jg-… durante la 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 supporta sia i riferimenti `$VAR`/`${VAR}` che `!comando`, ma il letterale funziona senza esportare variabili — tieni il file con permessi `0600`
`models`	array: `id`, `name`, `contextWindow`, `maxTokens`

Valori corretti per i modelli di rete: deepseek-ai/DeepSeek-V4-Flash-0731 — contextWindow 380000, maxTokens 32768; moonshotai/Kimi-K2.6 e MiniMaxAI/MiniMax-M2.7 — maxTokens 8192. I valori predefiniti di Pi (128000/16384) non coincidono con i limiti reali della rete, quindi specifica entrambi i campi esplicitamente. Il modello predefinito si trova in un ALTRO file — ~/.pi/agent/settings.json, campi defaultProvider e defaultModel. Verifica: pi --list-models dovrebbe 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 di rete supportano il tool calling e lo streaming. Per sessioni lunghe e repository di grandi dimensioni, si consiglia DeepSeek V4 Flash (il contesto di rete più lungo, output fino a 32768). Kimi K2.6 è efficace nel lavoro multi-step tramite agenti, mentre MiniMax M2.7 è un'opzione universale. La tariffa è unica; i prezzi in tempo reale sono disponibili nel listino prezzi del gateway.

Pi si connette al JoinGonka Gateway con una sola voce in ~/.pi/agent/models.json: baseUrl gate.joingonka.ai/v1, api openai-completions, chiave come letterale, modelli con contextWindow/maxTokens corretti. Ancora più veloce — npx @joingonka/setup --tool pi. Avvia l'agente in una sandbox e inizia con 10M di token gratuiti.

← Zed + JoinGonka Gateway — inferenza economica nell'editor

Vuoi saperne di più?

Esplora altre sezioni o inizia a guadagnare GNK subito.

pi.cta.text →