@cirthan/pi-cirthan-provider

Pi provider package for the Cirthan API.

Package details

← Back
extension

Install @cirthan/pi-cirthan-provider from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:@cirthan/pi-cirthan-provider
Package
@cirthan/pi-cirthan-provider
Version
0.6.0
Published
Apr 24, 2026
Downloads
385/mo · 214/wk
Author
qmx
License
MIT
Types
extension
Size
9.3 KB
Dependencies
0 dependencies · 2 peers
Pi manifest JSON
{
  "extensions": [
    "./pi-cirthan-provider.ts"
  ]
}

Security note

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

README

pi-cirthan-provider

Cirthan model provider for pi. Registers the cirthan provider using Cirthan's OpenAI-compatible API.

Models

  • breglan (default): snappy, great for everyday use
  • saelorn: deliberate, great for complex tasks

Setup

Provide an API key via environment variable or ~/.pi/agent/auth.json.

Option 1: Environment variable

export CIRTHAN_API_KEY="..."
# optional
export CIRTHAN_BASE_URL="https://api.cirthan.com/v1"

Option 2: auth.json (recommended)

Add to ~/.pi/agent/auth.json:

{
  "cirthan": {
    "type": "api_key",
    "key": "your_key_here"
  }
}

Usage

  • List/switch models: pi /model
  • Use default model: pi --model cirthan
  • Use a specific model: pi --model cirthan:saelorn

Default model

The default model for this provider is:

  • breglan