Secciones de la base de conocimientos ▾

Navegación

▸ Empiece aquí Por roles

Categorías

Herramientas 36
Glosario 12

pi.tag

Pi + JoinGonka Gateway — agente terminal con inferencia económica

Pi es un agente de programación terminal minimalista, uno de los harneses abiertos de más rápido crecimiento en 2026. Los proveedores en él se describen de forma declarativa en ~/.pi/agent/models.json y cualquier endpoint que hable OpenAI Completions o Anthropic Messages funcionará, es decir, JoinGonka Gateway se conecta de ambas formas. Los modelos de la red descentralizada Gonka cuestan cientos de veces menos que los precios de los proveedores tradicionales, y los 10M de tokens iniciales son gratuitos.

Ruta rápida: instalador

La opción más corta es nuestro instalador:

npx @joingonka/setup --tool pi

Este registrará el proveedor con los modelos de red actuales en ~/.pi/agent/models.json, establecerá el modelo predeterminado en ~/.pi/agent/settings.json (no interfiere con elecciones ajenas) y verificará con una solicitud en vivo que el gateway acepte la clave y el modelo. La clave se coloca como un literal en el archivo de configuración con permisos 0600; no es necesario exportar una variable de entorno.

Configuración manual: proveedor en models.json

Obtén una clave jg-… al registrarte y añade el proveedor en ~/.pi/agent/models.json:

baseUrlhttps://gate.joingonka.ai/v1
apiopenai-completions
apiKeytu clave jg-… como literal. Pi entiende referencias $VAR/${VAR} y !comando, pero el literal funciona sin variables exportadas; mantén el archivo con permisos 0600
modelsarray: id, name, contextWindow, maxTokens

Valores correctos para los modelos de red: deepseek-ai/DeepSeek-V4-Flash-0731 — contextWindow 380000, maxTokens 32768; moonshotai/Kimi-K2.6 y MiniMaxAI/MiniMax-M2.7 — maxTokens 8192. Los valores predeterminados de Pi (128000/16384) no coinciden con los límites reales de la red, así que establece ambos campos explícitamente. El modelo predeterminado vive en OTRO archivo — ~/.pi/agent/settings.json, campos defaultProvider y defaultModel. Verificación: pi --list-models debería mostrar los modelos añadidos.

La ruta de Anthropic como alternativa

La pasarela también ofrece Anthropic Messages: proveedor con api: "anthropic-messages" y baseUrl: "https://gate.joingonka.ai" — sin la ruta /v1/messages, el cliente la añadirá automáticamente. Para el trabajo diario basta con la ruta OpenAI; la opción Anthropic es útil si sus extensiones de Pi están adaptadas al formato Messages.

Advertencia sobre seguridad

Pi no tiene por defecto una capa de permisos completa: el agente ejecuta comandos en el terminal sin las confirmaciones paso a paso que tienen los harneses más pesados. Ejecútelo en un sandbox (contenedor o cuenta separada), especialmente en tareas autónomas de varios pasos. Esta es una característica propia de Pi, no de la pasarela.

Qué modelo elegir y cuánto cuesta

Los tres modelos de la red soportan tool calling y streaming. Para sesiones largas y repositorios grandes, DeepSeek V4 Flash (el contexto más largo de la red, salida hasta 32768). Kimi K2.6 es fuerte en trabajo de agentes multietapa, MiniMax M2.7 es una opción universal. La tarifa es única, los precios en tiempo real están en el listado de precios del gateway.

Pi se conecta al JoinGonka Gateway con una entrada en ~/.pi/agent/models.json: baseUrl gate.joingonka.ai/v1, api openai-completions, clave como literal, modelos con contextWindow/maxTokens correctos. Aún más rápido: npx @joingonka/setup --tool pi. Ejecuta el agente en un sandbox y comienza con 10M de tokens gratuitos.
← Zed + JoinGonka Gateway — inferencia económica en el editor

¿Quieres saber más?

Explora otras secciones o empieza a ganar GNK ahora mismo.

pi.cta.text →