Abschnitte der Wissensbasis ▾

Navigation

▸ Hier starten Nach Rollen

Kategorien

Werkzeuge 52
Glossar 12

Werkzeuge

Pi + JoinGonka Gateway — Terminal-Agent mit günstiger Inference

Pi ist ein minimalistischer Terminal-Coding-Agent und einer der am schnellsten wachsenden Open-Source-Harnesses des Jahres 2026. Anbieter werden darin deklarativ in ~/.pi/agent/models.json beschrieben, und jeder Endpunkt, der OpenAI Completions oder Anthropic Messages unterstützt, ist geeignet – das bedeutet, das JoinGonka Gateway kann auf beide Arten angebunden werden. Die Modelle des dezentralen Netzwerks Gonka sind hunderte Male günstiger als die GPU-Preise der Anbieter, und die anfänglichen 3M Token sind kostenlos.

Pi selbst wird über npm installiert: npm install -g --ignore-scripts @earendil-works/pi-coding-agent. Der Paketname ist neu: Das Projekt ist in das Repository earendil-works/pi umgezogen, während das vorherige Paket @mariozechner/pi-coding-agent als veraltet markiert wurde und nicht mehr aktualisiert wird. Wenn Pi bei Ihnen unter dem alten Namen installiert ist, installieren Sie es bitte neu; das Konfigurationsverzeichnis ~/.pi/agent ist beim Umzug unverändert geblieben.

Der schnelle Weg: Installer

Die kürzeste Variante ist unser Installationsprogramm:

npx @joingonka/setup --tool pi

Es trägt den Anbieter mit den aktuellen Netzwerkmodellen in die ~/.pi/agent/models.json ein, legt ein Standardmodell in der ~/.pi/agent/settings.json fest (ein von Ihnen manuell gewähltes Modell wird nicht überschrieben – dies geschieht nur durch das explizite Flag --model minimax|deepseek|glm) und prüft mit einer Live-Anfrage, ob das Gateway den Schlüssel und das Modell akzeptiert. Wenn das Konfigurationsverzeichnis über die Umgebungsvariable PI_CODING_AGENT_DIR verlagert wurde, schreibt der Installer dort hinein. Der Schlüssel wird als Literal mit den Berechtigungen 0600 in der Konfiguration gespeichert – ein Exportieren der Umgebungsvariable ist nicht erforderlich.

Manuelle Einrichtung: Provider in models.json

Holen Sie sich einen Schlüssel jg-… bei der Registrierung und fügen Sie den Anbieter in ~/.pi/agent/models.json hinzu:

baseUrlhttps://gate.joingonka.ai/v1
apiopenai-completions
apiKeyIhr Schlüssel jg-… als Literal. Pi versteht auch $VAR/${VAR}-Referenzen und !command, aber das Literal funktioniert ohne exportierte Variable – halten Sie die Datei mit Rechten 0600
modelsArray: id, name, contextWindow, maxTokens

Die richtigen Werte für die Modelle des Netzwerks: 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. Pis Standardwerte (128000/16384) stimmen nicht mit den tatsächlichen Limits des Netzwerks überein, geben Sie daher beide Felder explizit an. Das Standardmodell liegt in einer ANDEREN Datei – ~/.pi/agent/settings.json, Felder defaultProvider und defaultModel. Prüfung: pi --list-models sollte die hinzugefügten Modelle anzeigen.

Anthropic-Weg als Alternative

Das Gateway bietet auch Anthropic Messages: ein Provider mit api: "anthropic-messages" und baseUrl: "https://gate.joingonka.ai" — ohne den Pfad /v1/messages, der Client ergänzt diesen selbst. Für den täglichen Gebrauch reicht der OpenAI-Weg; die Anthropic-Variante ist nützlich, wenn Ihre Pi-Erweiterungen auf das Messages-Format ausgelegt sind.

Sicherheitshinweis

Pi verfügt standardmäßig über keine vollständige Berechtigungsschicht: Der Agent führt Befehle im Terminal ohne schrittweise Bestätigung aus, wie sie schwerere Frameworks bieten. Starten Sie ihn in einer Sandbox — einem Container oder einem separaten Benutzerkonto — insbesondere bei autonomen, mehrstufigen Aufgaben. Dies ist eine Eigenschaft von Pi selbst, nicht des Gateways.

Welches Modell wählen und was kostet es?

Alle drei Netzmodelle unterstützen Tool Calling und Streaming. Für lange Sessions und große Repositories — DeepSeek V4 Flash (einer der längsten Kontexte im Netzwerk und Ausgabe bis zu 32768). MiniMax M2.7 ist eine universelle Variante, GLM-5.3 Flash ist das Reasoning-Modell mit dem längsten Netzkontext (390K): Es denkt vor der Antwort nach, daher sollten Sie maxTokens hier nicht reduzieren. Der Tarif ist einheitlich, aktuelle Preise finden Sie in der Gateway-Preisliste.

Wenn Ihnen der Minimalismus von Pi nicht ausreicht, schauen Sie sich seinen Fork omp (Oh My Pi) an: die gleiche Idee deklarativer Provider, aber mit Modellrollen, Sprachservern und Subagenten. Die Konfigurationen sind unterschiedlich, daher wird omp separat konfiguriert.

Pi lässt sich mit einem Eintrag in der ~/.pi/agent/models.json mit dem JoinGonka Gateway verbinden: baseUrl gate.joingonka.ai/v1, api openai-completions, Schlüssel als Literal, Modelle mit korrekten contextWindow/maxTokens. Noch schneller: npx @joingonka/setup --tool pi. Starten Sie den Agenten in einer Sandbox und nutzen Sie die kostenlosen Start-Token.

Möchten Sie mehr erfahren?

Erkunden Sie andere Abschnitte oder beginnen Sie jetzt GNK zu verdienen.

Kostenlose Token erhalten →