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 прямо сейчас.

Получить бесплатные токены →