Розділи бази знань ▾

Навігація

▸ Почніть тут За ролями

Категорії

Інструменти 36
Глосарій 12

pi.tag

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

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

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

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

npx @joingonka/setup --tool pi

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

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

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

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

Правильні значення для моделей мережі: deepseek-ai/DeepSeek-V4-Flash-0731 — contextWindow 380000, maxTokens 32768; moonshotai/Kimi-K2.6 та MiniMaxAI/MiniMax-M2.7 — 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). Kimi K2.6 сильна в багатокроковій агентній роботі, MiniMax M2.7 — універсальний варіант. Тариф єдиний, актуальні ціни — у прайсі шлюзу.

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

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

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

pi.cta.text →