Pi + JoinGonka Gateway — термінальний агент на дешевому інференсі

Pi — мінімалістичний термінальний coding-агент, один із найшвидше зростаючих відкритих харнесів 2026 року. Провайдери в ньому описуються декларативно у ~/.pi/agent/models.json, і підійде будь-який endpoint, що розмовляє на OpenAI Completions або Anthropic Messages — тобто JoinGonka Gateway підключається обома шляхами. Моделі децентралізованої мережі Gonka коштують у сотні разів дешевше за карткові ціни вендорів, а стартові 3M токенів безкоштовні.

Сам Pi ставиться з npm: npm install -g --ignore-scripts @earendil-works/pi-coding-agent. Ім'я пакета нове: проект переїхав у репозиторій earendil-works/pi, а колишній пакет @mariozechner/pi-coding-agent оголошено застарілим і більше не оновлюється. Якщо Pi стоїть у вас під старим ім'ям — перевстановіть його; каталог налаштувань ~/.pi/agent при переїзді залишився колишнім.

Швидкий шлях: інсталятор

Найкоротший варіант — наш установник:

npx @joingonka/setup --tool pi

Він пропише провайдера з актуальними моделями мережі у ~/.pi/agent/models.json, поставить модель за замовчуванням у ~/.pi/agent/settings.json (модель, яку ви обрали самі, він не перехоплює — її змінює лише явний флаг --model minimax|deepseek|glm) і живим запитом перевірить, що шлюз приймає ключ і модель. Якщо каталог налаштувань перенесено змінною PI_CODING_AGENT_DIR, установник пише туди ж. Ключ кладеться літералом у конфіг із правами 0600 — експортувати змінну оточення не потрібно.

Ручне налаштування: провайдер у models.json

Отримайте ключ jg-… під час реєстрації й додайте провайдера в ~/.pi/agent/models.json:

`baseUrl`	`https://gate.joingonka.ai/v1`
`api`	`openai-completions`
`apiKey`	ваш ключ `jg-…` літералом. Pi розуміє й посилання `$VAR`/`${VAR}`, і `!command`, але літерал працює без експортованої змінної — тримайте файл із правами `0600`
`models`	масив: `id`, `name`, `contextWindow`, `maxTokens`

Правильні значення для моделей мережі: 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. Дефолти Pi (128000/16384) не збігаються з реальними лімітами мережі, тому задавайте обидва поля явно. Модель за замовчуванням живе в ІНШОМУ файлі — ~/.pi/agent/settings.json, поля defaultProvider і defaultModel. Перевірка: pi --list-models має показати додані моделі.

Anthropic-шлях як альтернатива

Шлюз віддає і Anthropic Messages: провайдер з api: "anthropic-messages" та baseUrl: "https://gate.joingonka.ai" — без шляху /v1/messages, клієнт допише його сам. Для повсякденної роботи достатньо OpenAI-шляху; Anthropic-варіант корисний, якщо ваші розширення Pi заточені під формат Messages.

Застереження про безпеку

У Pi за замовчуванням немає повноцінного permission-шару: агент виконує команди в терміналі без покрокових підтверджень, які є у важчих харнесів. Запускайте його в пісочниці — контейнері або окремій обліковці — особливо на автономних багатокрокових задачах. Це властивість самого Pi, не шлюзу.

Яку модель обрати і що по грошах

Усі три моделі мережі підтримують tool calling та streaming. Для довгих сесій і великих репозиторіїв — DeepSeek V4 Flash (один із найдовших контекстів мережі та вивід до 32768). MiniMax M2.7 — універсальний варіант, GLM-5.3 Flash — reasoning-модель із найдовшим контекстом мережі (390K): міркує перед відповіддю, тому не занижуйте їй maxTokens. Тариф єдиний, актуальні ціни — у прайсі шлюзу.

Якщо мінімалізму Pi не вистачає, подивіться на його форк omp (Oh My Pi): та ж ідея декларативних провайдерів, але з ролями моделей, мовними серверами та субагентами. Конфіги у них різні, тож налаштовується omp окремо.

Pi підключається до JoinGonka Gateway одним записом у ~/.pi/agent/models.json: baseUrl gate.joingonka.ai/v1, api openai-completions, ключ літералом, моделі з чесними contextWindow/maxTokens. Ще швидше — npx @joingonka/setup --tool pi. Запускайте агента в пісочниці та починайте з безкоштовних стартових токенів.

← Zed + JoinGonka Gateway — дешевий інференс у редакторі Codex CLI: свій ключ замість підписки →

Бажаєте дізнатися більше?

Вивчіть інші розділи або почніть заробляти GNK прямо зараз.

Отримати безкоштовні токени →