Pi.
Pi es un agente de terminal deliberadamente pequeño: un armazón mínimo que se adapta a tu forma de trabajar en vez de imponerte la suya. Habla el formato de OpenAI, así que NaN entra como un proveedor más.
Puedes saltarte todo esto
El CLI de NaN escribe esta configuración por ti: pestaña Setup, e para pegar tu clave, espacio para marcar Pi, c para aplicar.
Configuración
Declara el proveedor
En ~/.pi/agent/models.json:
{
"providers": {
"nan": {
"baseUrl": "https://api.nan.builders/v1",
"api": "openai-completions",
"apiKey": "sk-tu-clave",
"compat": { "supportsDeveloperRole": true },
"models": [
{
"id": "glm5.3-flash",
"name": "GLM 5.3 Flash",
"reasoning": true,
"input": ["text", "image"],
"contextWindow": 1000000,
"maxTokens": 16384
},
{
"id": "deepseek-v4-flash",
"name": "DeepSeek V4 Flash",
"reasoning": true,
"input": ["text", "image"],
"contextWindow": 1000000,
"maxTokens": 16384
}
]
}
}
}api: "openai-completions" es lo que le dice a Pi con qué formato hablar. maxTokens es el techo de la respuesta en cada petición, no el contexto.
Ponlo por defecto
En ~/.pi/agent/settings.json:
{
"defaultProvider": "nan",
"defaultModel": "glm5.3-flash"
}Este paso no es opcional
Sin defaultProvider y defaultModel, Pi sigue usando su proveedor de fábrica y lo que recibes es un 401. Es el fallo más habitual al conectarlo, y el mensaje de error no dice que el problema sea este fichero.
Pruébalo
piPídele algo corto. Si contesta, está saliendo por el clúster. Puedes cambiar de modelo a mitad de sesión sin salir del agente.
Modelo recomendado
glm5.3-flash para trabajo de código. deepseek-v4-flash para lo demás, que además tiene la cuota más amplia del clúster.
Problemas conocidos
- La clave va escrita en el fichero.
models.jsonvive en tu carpeta personal, así que no suele acabar en un repositorio, pero tenlo en cuenta si sincronizas tu configuración entre máquinas. maxTokensno es el contexto. Es el techo de cada respuesta. El razonamiento sale de ese mismo presupuesto, así que si pides respuestas largas y razonadas, súbelo.- Los modelos que declares son los que verás. Pi no le pregunta al clúster qué hay disponible: muestra lo que haya en la lista.