Разделы базы знаний ▾

Навигация

▸ Начните здесь По ролям

Категории

Инструменты 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 →