Seções da Base de Conhecimento ▾

Navegação

▸ Comece aqui Por funções

Categorias

Ferramentas 36
Glossário 12

pi.tag

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

O Pi é um agente de codificação terminal minimalista, um dos harneses abertos que mais crescem em 2026. Os provedores nele são descritos de forma declarativa em ~/.pi/agent/models.json, e qualquer endpoint que fale OpenAI Completions ou Anthropic Messages servirá — ou seja, o JoinGonka Gateway conecta-se de ambas as formas. Os modelos da rede descentralizada Gonka custam centenas de vezes menos que os preços dos vendors, e os 10M de tokens iniciais são gratuitos.

Caminho rápido: instalador

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

npx @joingonka/setup --tool pi

Ele registrará o provedor com os modelos de rede atuais em ~/.pi/agent/models.json, definirá o modelo padrão em ~/.pi/agent/settings.json (não interfere com escolhas de terceiros) e verificará com uma requisição ao vivo que o gateway aceita a chave e o modelo. 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.

Configuração manual: provedor em models.json

Obtenha uma chave jg-… ao se registrar e adicione o provedor em ~/.pi/agent/models.json:

baseUrlhttps://gate.joingonka.ai/v1
apiopenai-completions
apiKeysua chave jg-… como literal. O Pi entende referências $VAR/${VAR} e !comando, mas o literal funciona sem variáveis exportadas — mantenha o arquivo com permissões 0600
modelsarray: id, name, contextWindow, maxTokens

Valores corretos para os modelos de rede: deepseek-ai/DeepSeek-V4-Flash-0731 — contextWindow 380000, maxTokens 32768; moonshotai/Kimi-K2.6 e MiniMaxAI/MiniMax-M2.7 — maxTokens 8192. Os padrões do Pi (128000/16384) não coincidem com os limites reais da rede, por isso defina ambos os campos explicitamente. O modelo padrão vive em OUTRO arquivo — ~/.pi/agent/settings.json, campos defaultProvider e defaultModel. Verificação: pi --list-models deve exibir os modelos adicionados.

Caminho Anthropic como alternativa

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.

Aviso sobre segurança

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.

Qual modelo escolher e quanto custa

Todos os três modelos da rede suportam tool calling e streaming. Para sessões longas e repositórios grandes — DeepSeek V4 Flash (o contexto mais longo da rede, saída até 32768). Kimi K2.6 é forte em trabalho de agentes multietapas, MiniMax M2.7 é uma opção universal. A tarifa é única, os preços em tempo real estão na tabela de preços do gateway.

O Pi conecta-se ao JoinGonka Gateway com uma entrada em ~/.pi/agent/models.json: baseUrl gate.joingonka.ai/v1, api openai-completions, chave como literal, modelos com contextWindow/maxTokens corretos. Ainda mais rápido — npx @joingonka/setup --tool pi. Execute o agente em um sandbox e comece com 10M de tokens gratuitos.
← Zed + JoinGonka Gateway — inferência barata no editor

Quer saber mais?

Explore outras seções ou comece a ganhar GNK agora mesmo.

pi.cta.text →