Mga Seksyon ng Base ng Kaalaman ▾

Nabigasyon

▸ Magsimula rito Ayon sa papel

Mga Kategorya

Mga Gamit 52
Glosaryo 12

Mga tool

Pi + JoinGonka Gateway — terminal agent sa murang inference

Ang Pi ay isang minimalistang terminal coding-agent, isa sa mga pinakamabilis na lumalagong open harnesses ng 2026. Ang mga provider dito ay inilalarawan nang deklaratibo sa ~/.pi/agent/models.json, at anumang endpoint na gumagamit ng OpenAI Completions o Anthropic Messages ay gagana — ibig sabihin, ang JoinGonka Gateway ay maaaring ikonekta sa parehong paraan. Ang mga modelo ng desentralisadong network ng Gonka ay daan-daang beses na mas mura kaysa sa mga card price ng mga vendor, at ang panimulang 3M na mga token ay libre.

Ang Pi mismo ay ini-install mula sa npm: npm install -g --ignore-scripts @earendil-works/pi-coding-agent. Ang pangalan ng package ay bago: ang proyekto ay lumipat sa repository na earendil-works/pi, at ang dating package na @mariozechner/pi-coding-agent ay idineklara nang deprecated at hindi na ina-update. Kung ang Pi ay naka-install sa ilalim ng lumang pangalan, i-reinstall ito; ang configuration directory na ~/.pi/agent ay nanatiling pareho noong lumipat.

Mabilis na paraan: installer

Ang pinakamabilis na paraan ay ang aming installer:

npx @joingonka/setup --tool pi

Isusulat nito ang provider na may mga kasalukuyang network models sa ~/.pi/agent/models.json, itatakda ang default model sa ~/.pi/agent/settings.json (hindi nito papalitan ang modelong pinili mo mismo — tanging ang tahasang flag na --model minimax|deepseek|glm lang ang makakapagbago nito), at susuriin gamit ang live request kung tinatanggap ng gateway ang key at modelo. Kung ang configuration directory ay inilipat gamit ang variable na PI_CODING_AGENT_DIR, doon din isusulat ng installer. Ang key ay inilalagay bilang literal sa config na may permissions na 0600 — hindi na kailangang i-export ang environment variable.

Manual na setup: provider sa models.json

Kunin ang key na jg-… kapag nagrehistro at idagdag ang provider sa ~/.pi/agent/models.json:

baseUrlhttps://gate.joingonka.ai/v1
apiopenai-completions
apiKeyang iyong key na jg-… bilang literal. Nauunawaan din ng Pi ang mga reference na $VAR/${VAR}, at !command, ngunit gumagana ang literal kahit walang na-export na variable — panatilihin ang file na may pahintulot na 0600
modelsarray: id, name, contextWindow, maxTokens

Ang mga tamang value para sa mga modelo ng network: 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. Ang mga default ng Pi (128000/16384) ay hindi tumutugma sa totoong limit ng network, kaya itakda nang tahasan ang dalawang field. Ang default na modelo ay nasa IBANG file — ~/.pi/agent/settings.json, ang mga field na defaultProvider at defaultModel. Para suriin: dapat ipakita ng pi --list-models ang mga idinagdag na modelo.

Anthropic-path bilang alternatibo

Ang gateway ay nagbibigay din ng Anthropic Messages: provider na may api: "anthropic-messages" at baseUrl: "https://gate.joingonka.ai" — walang /v1/messages path, ang client ang magdaragdag nito. Para sa pang-araw-araw na trabaho, sapat na ang OpenAI-path; ang Anthropic-variant ay kapaki-pakinabang kung ang iyong mga Pi extension ay nakatutok sa Messages format.

Babala tungkol sa seguridad

Ang Pi ay walang default na ganap na permission-layer: ang agent ay nagsasagawa ng mga command sa terminal nang walang step-by-step confirmation na mayroon ang mas mabibigat na harnesses. Patakbuhin ito sa isang sandbox — container o hiwalay na account — lalo na sa mga autonomous multi-step task. Ito ay katangian ng mismong Pi, hindi ng gateway.

Aling model ang pipiliin at magkano ang gastos

Lahat ng tatlong model ng network ay sumusuporta sa tool calling at streaming. Para sa mahahabang session at malalaking repository — DeepSeek V4 Flash (isa sa may pinakamahabang context sa network at output hanggang 32768). Ang MiniMax M2.7 ay isang universal na opsyon, ang GLM-5.3 Flash ay isang reasoning-model na may pinakamahabang context sa network (390K): nag-iisip bago sumagot, kaya huwag babaan ang maxTokens nito. Iisa ang tariff, ang mga live price ay nasa price ng gateway.

Kung hindi sapat ang minimalism ng Pi, tingnan ang fork nito na omp (Oh My Pi): parehong ideya ng mga declarative provider, pero may mga model role, language server, at sub-agent. Magkaiba ang kanilang config, kaya magkahiwalay ang setup ng omp.

Ang Pi ay kumokonekta sa JoinGonka Gateway sa pamamagitan ng isang entry sa ~/.pi/agent/models.json: baseUrl gate.joingonka.ai/v1, api openai-completions, key bilang literal, models na may tamang contextWindow/maxTokens. Mas mabilis pa — npx @joingonka/setup --tool pi. Patakbuhin ang agent sa sandbox at magsimula gamit ang mga libreng panimulang tokens.

Gusto mo pang matuto?

Galugarin ang iba pang mga seksyon o simulang kumita ng GNK ngayon.

Kumuha ng libreng tokens →