Pi + JoinGonka Gateway — agente terminal em inferência barata

A opção mais curta é o nosso instalador:

npx @joingonka/setup --tool pi

Ele configurará um provedor com os modelos de rede atuais em ~/.pi/agent/models.json, definirá o modelo padrão em ~/.pi/agent/settings.json (ele não substitui um modelo que você tenha escolhido; isso só é alterado pela flag explícita --model minimax|deepseek|glm) e verificará com uma requisição ao vivo se o gateway aceita a chave e o modelo. Se o diretório de configurações foi movido através da variável PI_CODING_AGENT_DIR, o instalador escreverá lá. A chave é colocada como um literal no arquivo de configuração com permissões 0600 — não é necessário exportar uma variável de ambiente.

Obtenha uma chave jg-… no cadastro e adicione o provedor em ~/.pi/agent/models.json:

Os valores corretos para os modelos da rede: 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. Os padrões do Pi (128000/16384) não batem com os limites reais da rede, então defina os dois campos explicitamente. O modelo padrão fica em OUTRO arquivo — ~/.pi/agent/settings.json, campos defaultProvider e defaultModel. Verificação: pi --list-models deve mostrar os modelos adicionados.

O gateway também entrega Anthropic Messages: provedor com api: "anthropic-messages" e baseUrl: "https://gate.joingonka.ai" — sem o caminho /v1/messages, o cliente adicionará automaticamente. Para o trabalho diário, o caminho OpenAI é suficiente; a variante Anthropic é útil se suas extensões do Pi forem otimizadas para o formato Messages.

Por padrão, o Pi não possui uma camada de permissão completa: o agente executa comandos no terminal sem as confirmações passo a passo que harneses mais pesados possuem. Execute-o em uma sandbox — contêiner ou conta separada — especialmente em tarefas autônomas de várias etapas. Esta é uma característica do próprio Pi, não do gateway.

Todos os três modelos da rede suportam tool calling e streaming. Para sessões longas e repositórios grandes, DeepSeek V4 Flash (um dos contextos mais longos da rede e saída de até 32768). MiniMax M2.7 é uma opção universal, GLM-5.3 Flash é um modelo de raciocínio com o contexto mais longo da rede (390K): ele raciocina antes de responder, por isso não diminua o seu maxTokens. A tarifa é única; os preços em tempo real estão no preçário do gateway.

Se o minimalismo do Pi não for suficiente, dê uma olhada no seu fork omp (Oh My Pi): a mesma ideia de provedores declarativos, mas com papéis de modelos, servidores de linguagem e subagentes. As configurações deles são diferentes, então o omp é configurado separadamente.