Saltar al contenido principal

Usar InferNode desde Pi

Pi es un agente de código de terminal. Puede leer archivos, ejecutar herramientas y trabajar sobre tu proyecto usando los modelos de InferNode. Se conecta directamente por la API de Chat Completions; no necesita un router local.

Esta guía se comprobó con Pi 0.73.1. Usa los alias Saptiva Turbo, Saptiva Omni y Saptiva Cortex como tres opciones independientes. El administrador puede cambiar el modelo detrás de cada alias sin cambiar tu configuración.

Antes de empezar​

Necesitas una llave de InferNode, la URL de tu instalación, Node.js 22 o superior y jq para consultar el catálogo. Los comandos de entorno usan Bash; ejecuta bash si tu terminal usa otro intérprete. Reemplaza el dominio de ejemplo por el que te dé tu administrador.

npm install -g @mariozechner/pi-coding-agent@0.73.1
pi --version

La versión comprobada se distribuye como @mariozechner/pi-coding-agent. npm muestra un aviso de cambio de nombre a @earendil-works/pi-coding-agent; esta receta fija la versión comprobada y no supone que otra versión tenga la misma configuración.

1. Comprueba tu acceso​

Carga la llave en la terminal sin escribirla en el historial. La entrada no se muestra al pegarla:

export INFERNODE_BASE_URL='https://api.<tu-dominio>/infernode/v1'
read -r -s -p 'InferNode API key: ' INFERNODE_API_KEY
printf '\n'
export INFERNODE_API_KEY
curl --fail-with-body -sS "$INFERNODE_BASE_URL/me" \
-H "Authorization: Bearer $INFERNODE_API_KEY"

La respuesta debe identificar tu usuario y organización. Las variables duran solo en esa terminal; vuelve a cargarlas cuando abras otra. No pongas la llave en el repositorio ni en el archivo de modelos.

Consulta los alias disponibles para tu llave:

curl --fail-with-body -sS "$INFERNODE_BASE_URL/models/aliases" \
-H "Authorization: Bearer $INFERNODE_API_KEY" \
| jq '.data[] | {alias, model: .model.id, context: .model.context_window}'

Usa los nombres exactos de esa respuesta, incluidas mayúsculas y espacios. Si alguno de los tres alias no existe, omítelo de la configuración o pide acceso a tu administrador. No agregues modelos de embeddings o guardas como modelos de conversación.

2. Agrega el proveedor y los modelos​

Crea ~/.pi/agent/models.json. Si ya existe, agrega el proveedor infernode dentro de providers y conserva los demás. Cambia baseUrl por la URL que acabas de probar:

~/.pi/agent/models.json
{
"providers": {
"infernode": {
"baseUrl": "https://api.<tu-dominio>/infernode/v1",
"api": "openai-completions",
"apiKey": "INFERNODE_API_KEY",
"compat": {
"supportsStore": false,
"supportsDeveloperRole": false,
"supportsReasoningEffort": false,
"supportsStrictMode": false,
"maxTokensField": "max_tokens"
},
"models": [
{
"id": "Saptiva Turbo",
"name": "Saptiva Turbo",
"reasoning": true,
"input": [
"text",
"image"
],
"contextWindow": 262144,
"maxTokens": 8192
},
{
"id": "Saptiva Omni",
"name": "Saptiva Omni",
"reasoning": true,
"input": [
"text",
"image"
],
"contextWindow": 131072,
"maxTokens": 8192
},
{
"id": "Saptiva Cortex",
"name": "Saptiva Cortex",
"reasoning": true,
"input": [
"text",
"image"
],
"contextWindow": 131072,
"maxTokens": 8192
}
]
}
}
}

apiKey contiene el nombre de la variable, no el secreto. openai-completions selecciona Chat Completions. Los ajustes de compat evitan enviar campos que no necesita esta integración; supportsReasoningEffort: false no desactiva el razonamiento del modelo.

Los valores de contextWindow son un ejemplo comprobado, no una propiedad permanente del alias. Ajústalos al catálogo de tu instalación. maxTokens: 8192 reserva salida dentro de esa ventana: entrada y salida deben caber juntas (Contexto excedido). Esta receta no configura precios en Pi; consulta el consumo real en InferNode.

3. Abre Pi en tu proyecto​

Desde la carpeta del proyecto, ejecuta una de estas opciones:

pi --provider infernode --model 'Saptiva Turbo'
pi --provider infernode --model 'Saptiva Omni'
pi --provider infernode --model 'Saptiva Cortex'

Dentro de Pi, /model permite elegir entre los tres. Los nombres entre comillas son los alias que se envían a InferNode, no equivalencias con nombres de Claude. El comando pi-saptiva no forma parte de Pi: solo existe si alguien instaló un lanzador personalizado en tu equipo.

Para comprobar la conexión con una petición breve:

pi --provider infernode --model 'Saptiva Turbo' \
--print --no-session --no-tools 'Responde solamente OK.'

Después prueba una herramienta en la sesión interactiva: pide leer un archivo pequeño que exista, indicando su ruta exacta, y resumirlo sin modificarlo. Una respuesta a un saludo comprueba generación; una lectura seguida de una respuesta comprueba también el uso de herramientas.

Errores frecuentes​

SíntomaQué revisar
pi: command not foundEl directorio de binarios de npm debe estar en tu PATH.
401 o UnauthorizedCarga INFERNODE_API_KEY en la misma terminal. Si ya usaste /login para infernode, Pi puede estar usando una llave guardada; actualízala o usa /logout para volver a la variable.
model_not_foundCompara el id con GET /v1/models/aliases; conserva espacios y mayúsculas.
La respuesta queda vacía o se cortaEl razonamiento puede consumir la salida disponible. Revisa maxTokens y prueba Saptiva Turbo.
La herramienta no encuentra un archivoComprueba la carpeta desde la que abriste Pi y proporciona una ruta exacta.
El modelo afirma ser Claude u otro modeloEsa afirmación no verifica el proveedor. Consulta el campo model de la respuesta de InferNode y los registros de uso; Claude Code muestra cómo distinguir identidad y enrutamiento.

Siguiente paso​