@neilurk12/pi-free-models

Free model providers for Pi — Kilo and OpenCode with free/paid filtering

Packages

Package details

extension

Install @neilurk12/pi-free-models from npm and Pi will load the resources declared by the package manifest.

npm report
$ pi install npm:@neilurk12/pi-free-models
Package
@neilurk12/pi-free-models
Version
1.0.0
Published
Jun 2, 2026
Downloads
not available
Author
neilurk12
License
MIT
Types
extension
Size
19.9 KB
Dependencies
0 dependencies · 3 peers
Pi manifest JSON
{
  "extensions": [
    "./dist/index.js"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

@neilurk12/pi-free-models

Free model providers for Pi — Kilo Gateway and OpenCode with automatic free/paid filtering.

What it does

Registers two AI model providers into Pi and defaults to showing only free models:

Provider Models Auth
Kilo 300+ via Kilo Gateway (OpenRouter-compatible) Optional OAuth or API key
OpenCode Models via OpenCode Zen gateway API key from auth.json

Free model detection uses adaptive heuristics — cost-based for providers that expose pricing, name-based for those that don't.

Install

npx pi add @neilurk12/pi-free-models

Requires Pi and Node ≥ 22.

Configuration

Config lives at ~/.pi/free-models.json (separate from Pi's built-in providers).

Options

Key Type Default Description
free_only boolean true Show only free models globally
kilo_show_paid boolean false Show paid Kilo models
opencode_show_paid boolean false Show paid OpenCode models
kilo_api_key string — Kilo API key (env: KILO_API_KEY)
opencode_api_key string — OpenCode API key (env: OPENCODE_API_KEY)
hidden_models string[] [] Model IDs to hide ("model-id" or "provider/model-id")

Environment variables take priority over the config file.

Commands

Command Description
/toggle-free Toggle global free-only mode across all providers
/toggle-kilo Toggle Kilo between free and all models
/toggle-opencode Toggle OpenCode between free and all models
/free-providers Show free/paid model counts by provider
/login kilo OAuth login for Kilo (unlocks paid models)

How free detection works

The extension uses two routes:

  • Route A (pricing-exposed providers like Kilo): A model is free if cost.input === 0 && cost.output === 0, or its name contains "free". When pricing data is missing for a specific model, falls back to name-only.
  • Route B (non-pricing providers like OpenCode): A model is free if its name contains "free" (case-insensitive).

Logging

Logs go to ~/.pi/free-models.log (5 MB rotation). Control with env vars:

Variable Default Description
LOG_LEVEL error Console log level (debug, info, warn, error)
PI_FREE_MODELS_LOG_LEVEL debug File log level
PI_FREE_MODELS_LOG_PATH ~/.pi/free-models.log Log file path
PI_FREE_MODELS_FILE_LOG true Set false to disable file logging

License

MIT