Docs

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

pi

Pí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.json vive en tu carpeta personal, así que no suele acabar en un repositorio, pero tenlo en cuenta si sincronizas tu configuración entre máquinas.
  • maxTokens no 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.
nan.builders © 2026
Copied to clipboard