Secciones de la base de conocimientos ▾

Navegación

▸ Empiece aquí Por roles

Categorías

Herramientas 52
Glosario 12

Herramientas

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

Pi es un agente de codificación de terminal minimalista, uno de los arneses de código abierto de más rápido crecimiento en 2026. Los proveedores se describen de forma declarativa en ~/.pi/agent/models.json, y cualquier endpoint que hable OpenAI Completions o Anthropic Messages servirá, es decir, JoinGonka Gateway se conecta por ambos caminos. Los modelos de la red descentralizada Gonka son cientos de veces más baratos que los precios de los proveedores, y los 3M de tokens iniciales son gratuitos.

Pi se instala desde npm: npm install -g --ignore-scripts @earendil-works/pi-coding-agent. El nombre del paquete es nuevo: el proyecto se ha mudado al repositorio earendil-works/pi, y el paquete anterior @mariozechner/pi-coding-agent ha sido declarado obsoleto y ya no se actualiza. Si tienes Pi instalado bajo el nombre antiguo, reinstálalo; el directorio de configuración ~/.pi/agent permanece igual tras la migración.

Ruta rápida: instalador

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

npx @joingonka/setup --tool pi

Configurará un proveedor con los modelos de red actuales en ~/.pi/agent/models.json, establecerá el modelo por defecto en ~/.pi/agent/settings.json (no sobrescribe un modelo que hayas elegido tú; solo lo cambia la bandera explícita --model minimax|deepseek|glm) y verificará con una solicitud en vivo que la pasarela acepta la clave y el modelo. Si el directorio de configuración se ha trasladado mediante la variable PI_CODING_AGENT_DIR, el instalador escribirá allí. 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

Consigue 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 también entiende las referencias $VAR/${VAR} y !command, pero el literal funciona sin una variable exportada: mantén el archivo con permisos 0600
modelsarray: id, name, contextWindow, maxTokens

Los valores correctos para los modelos de la red: 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. Los valores por defecto de Pi (128000/16384) no coinciden con los límites reales de la red, así que define ambos campos explícitamente. El modelo por defecto vive en OTRO archivo: ~/.pi/agent/settings.json, campos defaultProvider y defaultModel. Comprobación: pi --list-models debe 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 (uno de los contextos más largos de la red y salida de hasta 32768). MiniMax M2.7 es una opción universal, GLM-5.3 Flash es un modelo de razonamiento con el contexto más largo de la red (390K): razona antes de responder, por lo que no le disminuya su maxTokens. La tarifa es única; los precios en tiempo real se encuentran en la lista de precios del gateway.

Si el minimalismo de Pi no es suficiente, eche un vistazo a su fork omp (Oh My Pi): la misma idea de proveedores declarativos, pero con roles de modelos, servidores de lenguaje y subagentes. Sus configuraciones son diferentes, por lo que omp se configura por separado.

Pi se conecta a JoinGonka Gateway con una sola entrada en ~/.pi/agent/models.json: baseUrl gate.joingonka.ai/v1, api openai-completions, clave como literal, modelos con contextWindow/maxTokens precisos. Aún más rápido: npx @joingonka/setup --tool pi. Ejecuta el agente en un sandbox y comienza con los tokens iniciales gratuitos.

¿Quieres saber más?

Explora otras secciones o empieza a ganar GNK ahora mismo.

Obtener tokens gratuitos →