pi-fireworks

Fireworks AI provider extension package for pi

Package details

extension

Install pi-fireworks from npm and Pi will load the resources declared by the package manifest.

$ pi install npm:pi-fireworks
Package
pi-fireworks
Version
0.1.2
Published
Apr 24, 2026
Downloads
372/mo · 145/wk
Author
denniseijpe
License
MIT
Types
extension
Size
16.5 KB
Dependencies
0 dependencies · 2 peers
Pi manifest JSON
{
  "extensions": [
    "./index.ts"
  ]
}

Security note

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

README

pi-fireworks

Deprecated: Pi now has native support for Fireworks.ai.

An extension for pi that adds Fireworks AI as a provider.

Please note: This has been highly vibe coded by pi itself.

What it does

  • Registers a fireworks provider in pi
  • Reads a cached Fireworks model list from ~/.pi/agent/fireworks-models-cache.json
  • Adds /fireworks-refresh to fetch the latest chat-capable models from the Fireworks API
  • Injects two kinds of known-available models when Fireworks does not return them in the API listing:
    • fire pass models: subscription/router models such as Kimi K2.5 Turbo
    • forced models: known available models such as Kimi K2.6
  • Supports FIREWORKS_API_KEY or ~/.pi/agent/auth.json

Install

From npm

pi install npm:pi-fireworks

From git

pi install git:github.com/denniseijpe/pi-fireworks

From a local checkout

pi install /absolute/path/to/pi-fireworks

Configure authentication

Option 1: environment variable

export FIREWORKS_API_KEY=fw_...

Option 2: ~/.pi/agent/auth.json

{
  "fireworks": {
    "type": "api_key",
    "key": "fw_..."
  }
}

Usage

Start pi, then fetch the latest models using /fireworks-refresh and pick a model with /model.

Commands

  • /fireworks-refresh — fetch the latest Fireworks model list and update the local cache

Cache files

The package stores its model cache in the pi directory:

  • ~/.pi/agent/fireworks-models-cache.json
  • ~/.pi/agent/fireworks-models-response.json

License

MIT