Skip to content

Repository files navigation

pi-free-providers

pi-free

Free and paid AI model providers for Pi. Access models from multiple providers in one install.


What does pi-free do

pi-free is a Pi extension that registers additional providers and applies free/all model filters.

When you install pi-free, it:

  1. Registers native providers such as Kilo, Cline, LLM7, FastRouter, Ollama Cloud, StepFun, and more.
  2. Registers Qoder through Pi's native provider surface and supports Pi's built-in OpenCode, OpenCode Go, and OpenRouter integrations.
  3. Uses Pi's native model and auth stores for all extension providers; Ollama Cloud and Qoder retain documented compatibility caches only for auxiliary behavior.
  4. Applies the global free-only filter by default, while preserving provider-specific paid/trial behavior.
  5. Provides per-provider toggle commands — /toggle-{provider} switches between the provider's free/basic view and its full catalog.
  6. Supports OAuth and API-key authentication where a provider offers them.
  7. Adds Coding Index scores to model names and can probe and hide unavailable models.
  8. Provides /pi-free-health and /free-startup diagnostics without exposing credentials.

Install

Install the published npm package:

pi install npm:pi-free

For the latest unreleased GitHub changes instead:

pi install git:github.com/apmantza/pi-free

Press Ctrl+L to open the model picker. The global free-only setting is enabled by default.

Quick Start

Use free models

Cline exposes a public catalog before login. Kilo requires an OAuth credential or API key for authenticated refreshes and chat:

/login cline
/login kilo

Qoder supports /login qoder with PAT or browser OAuth, then /toggle-qoder switches between its basic free tier and full catalog.

Toggle between free and paid

/toggle-kilo
/toggle-openrouter
/toggle-free
/free-providers
/pi-free-health

Add API keys (optional)

First run creates ~/.pi/free.json. Add extension-provider keys there or use the environment variables documented in Provider catalog & auth. For example:

{
  "ollama_api_key": "...",
  "anyapi_api_key": "..."
}

Provider Catalog

Category Providers
Free/free-tier Kilo, Cline, LLM7, TokenRouter, Agnes AI, Qoder basic tier, and eligible models from other catalogs
Freemium AnyAPI, Ollama Cloud, SambaNova
Paid/trial ZenMux, CrofAI, DeepInfra trial, Novita, Routeway, OpenGateway, B.AI, StepFun, GMI Cloud, Venice AI, Infron AI, and paid catalog entries from other providers
Native lifecycle Kilo, Cline, LLM7, Ollama Cloud, AnyAPI, SambaNova, TokenRouter, ZenMux, CrofAI, DeepInfra, Novita, Routeway, OpenGateway, B.AI, FastRouter, StepFun, GMI Cloud, Agnes AI, Venice AI, Infron AI
Built-in OpenCode, OpenCode Go, OpenRouter — captured from Pi and refreshed in place after session start (OpenCode Zen catalog + public OpenRouter endpoint), so new models appear without waiting for a Pi release

Provider availability, authentication, and exact API-key names are maintained in docs/providers.md. pi-free does not publish model counts as guarantees because provider catalogs change — but a dated free-model snapshot (per-provider model lists + usage conditions) is maintained in docs/free_models.md.

Live catalog audit

Snapshot from 2026-08-26, fetched directly from each provider's real /models endpoint and classified with pi-free's own detection semantics (cost-based Route A, name-based Route B, promotional stamps). Counts drift as providers change their catalogs — treat this as a verified point-in-time audit, not a promise.

Provider Models Free-classified Notes
Cline 417 22 OAuth/API key for chat; public catalog incl. stealth/ox-alpha
Requesty 675 11 Inline pricing
ZenMux 165 14
FastRouter 139 11
TokenRouter 128 2 qwen3.8-max-free upstream was flaky at audit time (gateway 503s)
GMI Cloud 75 2 MiniMax Week promotion through 2026-09-06
Infron AI 285 5 New in this release
LLM7 46 46 Entirely free gateway
DeepInfra 188 0 $5 trial-credit provider; no pricing exposed, no free-named models
Novita 151 0 Trial-credit posture, same as DeepInfra
Routeway 246 6
Venice AI 113 1 stealth-ox-alpha is $0-listed but Venice gates inference behind account balance (402 when unfunded)
CrofAI 21 0
SambaNova 7 0 Free tier is at the billing layer; list prices nonzero
Agnes AI 4 2 Flash class free, pro paid per Agnes pricing docs
OpenGateway 14 2 Promotional free entries
StepFun 2 2 Step Plan free tier

Not audited this cycle (no credential available): Kilo (OAuth-gated catalog), Ollama Cloud, AnyAPI, B.AI, Qoder.

Catalog and credential storage

Native providers use Pi's ~/.pi/agent/models-store.json and ~/.pi/agent/auth.json. Qoder's static catalog is persisted in the native model store; it retains its legacy cache only for optional stream metadata. Ollama Cloud retains ~/.pi/provider-cache.json only for capability reuse and its compatibility refresh command. /free-startup also reports per-provider fetch attempts and post-start session work.

Startup packaging

Pi and npm load the compiled dist/ entry. The compiled import-inclusive benchmark improved from roughly 1.14s to 0.43s p50 (total from 1.18s to 0.47s p50) after reducing the measured import graph from 904 to 226 modules. These are controlled extension benchmarks, not a full Pi-host A/B result; host startup also includes Pi and its peer dependencies.

Docs

Topic Link
Provider catalog & auth docs/providers.md
Slash commands docs/commands.md
Configuration & logging docs/configuration.md
Features deep dive docs/features.md
Compiled packaging docs/build-strategy.md
Adding new providers CONTRIBUTING.md

License

MIT — See LICENSE

Questions? Open an issue

About

All-in-one free/freemium/paid model providers for Pi

Resources

Contributing

Stars

110 stars

Watchers

1 watching

Forks

Releases

Packages

Used by

Contributors

Languages