Pi returned no models. Run `pi --list-models` and verify pro

Error message

Pi returned no models. Run `pi --list-models` and verify provider auth.

What it means

Error "Pi returned no models. Run `pi --list-models` and verify provider auth." thrown in paperclipai/paperclip.

Source

Thrown at packages/adapters/pi-local/src/server/models.ts:187

export async function ensurePiModelConfiguredAndAvailable(input: {
  model?: unknown;
  command?: unknown;
  cwd?: unknown;
  env?: unknown;
}): Promise<AdapterModel[]> {
  const model = asString(input.model, "").trim();
  if (!model) {
    throw new Error("Pi requires `adapterConfig.model` in provider/model format.");
  }

  const models = await discoverPiModelsCached({
    command: input.command,
    cwd: input.cwd,
    env: input.env,
  });

  if (models.length === 0) {
    throw new Error("Pi returned no models. Run `pi --list-models` and verify provider auth.");
  }

  if (!models.some((entry) => entry.id === model)) {
    const sample = models.slice(0, 12).map((entry) => entry.id).join(", ");
    throw new Error(
      `Configured Pi model is unavailable: ${model}. Available models: ${sample}${models.length > 12 ? ", ..." : ""}`,
    );
  }

  return models;
}

export async function listPiModels(): Promise<AdapterModel[]> {
  try {
    return await discoverPiModelsCached();
  } catch {
    return [];
  }

View on GitHub (pinned to 120ae5428f)

Solutions

Run `pi --list-models` and verify provider authentication.

When it happens

Trigger: Thrown at packages/adapters/pi-local/src/server/models.ts:187 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of paperclipai/paperclip@120ae5428f (2026-08-18). Data as JSON: /api/errors/876a36593a064134. Report an issue: GitHub.