Sections de la base de connaissances ▾

Navigation

▸ Commencez ici Par rôles

Catégories

Outils 36
Glossaire 12

pi.tag

Pi + JoinGonka Gateway — agent de terminal sur inférence à bas prix

Pi est un coding-agent terminal minimaliste, l'un des outils open source à la croissance la plus rapide en 2026. Les fournisseurs y sont décrits de manière déclarative dans ~/.pi/agent/models.json, et n'importe quel endpoint parlant OpenAI Completions ou Anthropic Messages convient — le JoinGonka Gateway se connecte donc via les deux méthodes. Les modèles du réseau décentralisé Gonka coûtent des centaines de fois moins cher que les prix des fournisseurs propriétaires, et les 10M de jetons de départ sont offerts.

Voie rapide : installateur

L'option la plus courte est notre installateur :

npx @joingonka/setup --tool pi

Il configurera le fournisseur avec les modèles réseau actuels dans ~/.pi/agent/models.json, définira le modèle par défaut dans ~/.pi/agent/settings.json (sans intercepter le choix des autres) et vérifiera par une requête en direct que la passerelle accepte la clé et le modèle. La clé est placée en tant que littéral dans la configuration avec des droits 0600 — il n'est pas nécessaire d'exporter de variable d'environnement.

Configuration manuelle : fournisseur dans models.json

Obtenez une clé jg-… lors de l'inscription et ajoutez le fournisseur dans ~/.pi/agent/models.json :

baseUrlhttps://gate.joingonka.ai/v1
apiopenai-completions
apiKeyvotre clé jg-… en tant que littéral. Pi comprend aussi les liens $VAR/${VAR}, et !commande, mais le littéral fonctionne sans variable exportée — gardez le fichier avec des droits 0600
modelstableau : id, name, contextWindow, maxTokens

Valeurs correctes pour les modèles réseau : deepseek-ai/DeepSeek-V4-Flash-0731 — contextWindow 380000, maxTokens 32768 ; moonshotai/Kimi-K2.6 et MiniMaxAI/MiniMax-M2.7 — maxTokens 8192. Les valeurs par défaut de Pi (128000/16384) ne correspondent pas aux limites réelles du réseau, donc définissez les deux champs explicitement. Le modèle par défaut réside dans un AUTRE fichier — ~/.pi/agent/settings.json, champs defaultProvider et defaultModel. Vérification : pi --list-models devrait afficher les modèles ajoutés.

Voie Anthropic en alternative

La passerelle supporte également Anthropic Messages : fournisseur avec api: "anthropic-messages" et baseUrl: "https://gate.joingonka.ai" — sans le chemin /v1/messages, le client l'ajoutera lui-même. Pour un usage quotidien, la voie OpenAI suffit ; l'option Anthropic est utile si vos extensions Pi sont conçues pour le format Messages.

Avertissement sur la sécurité

Pi n'a pas par défaut une couche d'autorisation complète : l'agent exécute des commandes dans le terminal sans confirmation étape par étape, contrairement aux outils plus lourds. Exécutez-le dans un bac à sable (sandbox) — conteneur ou compte utilisateur dédié — surtout pour les tâches autonomes en plusieurs étapes. C'est une caractéristique de Pi lui-même, pas de la passerelle.

Quel modèle choisir et quel budget

Les trois modèles du réseau prennent en charge le tool calling et le streaming. Pour les longues sessions et les grands référentiels, utilisez DeepSeek V4 Flash (le plus long contexte du réseau, sortie jusqu'à 32768). Kimi K2.6 est performant dans le travail d'agent multi-étapes, MiniMax M2.7 est une option polyvalente. Le tarif est unique, les prix en temps réel se trouvent dans la liste de prix de la passerelle.

Pi se connecte à la passerelle JoinGonka avec une entrée dans ~/.pi/agent/models.json : baseUrl gate.joingonka.ai/v1, api openai-completions, clé en littéral, modèles avec contextWindow/maxTokens réels. Encore plus rapide — npx @joingonka/setup --tool pi. Lancez l'agent dans une sandbox et commencez avec 10M de jetons gratuits.

Vous voulez en savoir plus ?

Explorez d'autres sections ou commencez à gagner des GNK dès maintenant.

pi.cta.text →