Sections de la base de connaissances ▾

Navigation

▸ Commencez ici Par rôles

Catégories

Outils 52
Glossaire 12

Outils

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

Pi est un agent de codage terminal minimaliste, l'un des harnais 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 — ce qui signifie que JoinGonka Gateway peut être connecté des deux manières. Les modèles du réseau décentralisé Gonka coûtent des centaines de fois moins cher que les prix affichés par les fournisseurs, et les 3M jetons initiaux sont gratuits.

Pi lui-même s'installe via npm : npm install -g --ignore-scripts @earendil-works/pi-coding-agent. Le nom du paquet est nouveau : le projet a migré vers le dépôt earendil-works/pi, et l'ancien paquet @mariozechner/pi-coding-agent est obsolète et n'est plus mis à jour. Si vous avez installé Pi sous l'ancien nom, réinstallez-le ; le répertoire de configuration ~/.pi/agent est resté le même lors de la migration.

Voie rapide : installateur

L'option la plus rapide est notre installateur :

npx @joingonka/setup --tool pi

Il configurera le fournisseur avec les modèles de réseau actuels dans ~/.pi/agent/models.json, définira le modèle par défaut dans ~/.pi/agent/settings.json (il n'intercepte pas le modèle que vous avez choisi vous-même — celui-ci n'est modifié que par un flag explicite --model minimax|deepseek|glm) et vérifiera par une requête en direct que la passerelle accepte la clé et le modèle. Si le répertoire de configuration est déplacé via la variable PI_CODING_AGENT_DIR, l'installateur y écrira également. La clé est placée sous forme de littéral dans le fichier de configuration avec les droits 0600 — il n'est pas nécessaire d'exporter une 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 littéral. Pi comprend aussi les références $VAR/${VAR} et !command, mais le littéral fonctionne sans variable exportée — gardez le fichier en permissions 0600
modelstableau : id, name, contextWindow, maxTokens

Valeurs correctes pour les modèles du réseau : 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. Les valeurs par défaut de Pi (128000/16384) ne correspondent pas aux limites réelles du réseau, définissez donc 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 doit 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 sessions longues et les dépôts volumineux, utilisez DeepSeek V4 Flash (l'un des contextes les plus longs du réseau et une sortie jusqu'à 32768). MiniMax M2.7 est une option polyvalente, GLM-5.3 Flash est un modèle de raisonnement avec le contexte le plus long du réseau (390K) : il réfléchit avant de répondre, donc ne diminuez pas son maxTokens. Le tarif est unique, les prix en temps réel sont disponibles dans la liste de prix de la passerelle.

Si le minimalisme de Pi ne suffit pas, jetez un œil à son fork omp (Oh My Pi) : la même idée de fournisseurs déclaratifs, mais avec des rôles de modèles, des serveurs de langage et des sous-agents. Leurs configurations sont différentes, donc omp se configure séparément.

Pi se connecte au JoinGonka Gateway avec une simple entrée dans ~/.pi/agent/models.json : baseUrl gate.joingonka.ai/v1, api openai-completions, clé littérale, modèles avec contextWindow/maxTokens corrects. Encore plus rapide — npx @joingonka/setup --tool pi. Lancez l'agent dans un bac à sable et commencez avec les jetons gratuits de départ.

Vous voulez en savoir plus ?

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

Obtenir des jetons gratuits →