Sekcje bazy wiedzy ▾

Nawigacja

▸ Zacznij tutaj Według ról

Kategorie

Narzędzia 54
Słownik 12

Narzędzia

Pi + JoinGonka Gateway — terminalowy agent na tanim inference

Pi (pi.dev) to minimalistyczny terminalowy agent codingowy, jeden z najszybciej rosnących otwartych harnessów 2026 roku. Providerów opisuje się w nim deklaratywnie w ~/.pi/agent/models.json, a pasuje każdy endpoint mówiący w OpenAI Completions lub Anthropic Messages — czyli JoinGonka Gateway podłącza się obiema drogami. Modele zdecentralizowanej sieci Gonka są setki razy tańsze od kartowych cen vendoró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ł oznaczony jako przestarzały i nie jest już aktualizowany. Jeśli Pi masz zainstalowane pod starą nazwą — zainstaluj je ponownie; katalog ustawień ~/.pi/agent przy przeprowadzce pozostał ten sam.

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:

baseUrlhttps://gate.joingonka.ai/v1
apiopenai-completions
apiKeyTwó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
modelstablica: 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 180000, 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.

Chcesz wiedzieć więcej?

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

Odbierz darmowe tokeny →