Pi + JoinGonka Gateway — terminalowy agent na tanim inference

Pi to minimalistyczny agent programistyczny działający w terminalu, jeden z najszybciej rozwijających się otwartych harnessów 2026 roku. Dostawcy są w nim opisani deklaratywnie w ~/.pi/agent/models.json i pasuje każdy endpoint obsługujący OpenAI Completions lub Anthropic Messages — co oznacza, że JoinGonka Gateway można podłączyć oboma sposobami. Modele w zdecentralizowanej sieci Gonka są setki razy tańsze niż ceny kart graficznych u dostawców, a startowe 3M tokenów jest darmowe.

Sam Pi instaluje się z npm: npm install -g --ignore-scripts @earendil-works/pi-coding-agent. Nazwa pakietu jest nowa: projekt przeniósł się do repozytorium earendil-works/pi, a poprzedni pakiet @mariozechner/pi-coding-agent został uznany za przestarzały i nie jest już aktualizowany. Jeśli masz zainstalowanego Pi pod starą nazwą — zainstaluj go ponownie; katalog ustawień ~/.pi/agent po przeprowadzce pozostał bez zmian.

Szybka ścieżka: instalator

Najkrótsza opcja to nasz instalator:

npx @joingonka/setup --tool pi

Dopisze on dostawcę z aktualnymi modelami sieci do ~/.pi/agent/models.json, ustawi domyślny model w ~/.pi/agent/settings.json (nie nadpisuje modelu wybranego samodzielnie — zmienia go tylko jawna flaga --model minimax|deepseek|glm) i poprzez zapytanie na żywo sprawdzi, czy brama akceptuje klucz oraz model. Jeśli katalog ustawień jest przeniesiony za pomocą zmiennej PI_CODING_AGENT_DIR, instalator zapisze dane w tym samym miejscu. Klucz jest zapisywany jako literał w pliku konfiguracyjnym z uprawnieniami 0600 — nie ma potrzeby eksportowania zmiennej środowiskowej.

Konfiguracja ręczna: provider w models.json

Zdobądź klucz jg-… przy rejestracji i dodaj providera w ~/.pi/agent/models.json:

`baseUrl`	`https://gate.joingonka.ai/v1`
`api`	`openai-completions`
`apiKey`	Twój klucz `jg-…` jako literał. Pi rozumie też odwołania `$VAR`/`${VAR}` oraz `!command`, ale literał działa bez eksportowanej zmiennej — trzymaj plik z uprawnieniami `0600`
`models`	tablica: `id`, `name`, `contextWindow`, `maxTokens`

Prawidłowe wartości dla modeli sieci: 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. Domyślne wartości Pi (128000/16384) nie pokrywają się z realnymi limitami sieci, więc ustawiaj oba pola jawnie. Model domyślny mieszka w INNYM pliku — ~/.pi/agent/settings.json, pola defaultProvider i defaultModel. Weryfikacja: pi --list-models powinno pokazać dodane modele.

Ścieżka Anthropic jako alternatywa

Bramka obsługuje również Anthropic Messages: provider z api: "anthropic-messages" i baseUrl: "https://gate.joingonka.ai" — bez ścieżki /v1/messages, klient doda ją samodzielnie. Do codziennej pracy wystarczy ścieżka OpenAI; wariant Anthropic jest przydatny, jeśli rozszerzenia Pi są dostosowane do formatu Messages.

Zastrzeżenie o bezpieczeństwie

Pi domyślnie nie posiada pełnej warstwy permission: agent wykonuje polecenia w terminalu bez krokowej weryfikacji, którą mają cięższe harnessy. Uruchamiaj go w piaskownicy — kontenerze lub osobnej konfiguracji użytkownika — zwłaszcza przy autonomicznych zadaniach wielokrokowych. To cecha samego Pi, nie bramki.

Jaki model wybrać i jak z kosztami

Wszystkie trzy modele sieci obsługują tool calling i streaming. Do długich sesji i dużych repozytoriów — DeepSeek V4 Flash (jeden z najdłuższych kontekstów sieci i wyjście do 32768). MiniMax M2.7 to uniwersalny wariant, GLM-5.3 Flash to model reasoning z najdłuższym kontekstem w sieci (390K): analizuje przed udzieleniem odpowiedzi, więc nie zaniżaj jej maxTokens. Taryfa jest jednolita, aktualne ceny — w cenniku bramki.

Jeśli minimalizm Pi to za mało, spójrz na jego fork omp (Oh My Pi): ta sama idea deklaratywnych dostawców, ale z rolami modeli, serwerami językowymi i subagentami. Ich konfiguracje są różne, więc omp konfiguruje się oddzielnie.

Pi łączy się z JoinGonka Gateway za pomocą jednego wpisu w ~/.pi/agent/models.json: baseUrl gate.joingonka.ai/v1, api openai-completions, klucz jako literał, modele z uczciwym contextWindow/maxTokens. Jeszcze szybciej — npx @joingonka/setup --tool pi. Uruchom agenta w piaskownicy i zacznij od darmowych tokenów startowych.

← Zed + JoinGonka Gateway — tani inferencing w edytorze Codex CLI: własny klucz zamiast subskrypcji →

Chcesz wiedzieć więcej?

Zapoznaj się z innymi sekcjami lub zacznij zarabiać GNK już teraz.

Odbierz darmowe tokeny →