Skip to main content
FireConnect routes Pi through Fireworks AI models. See the FireConnect overview for install and CLI basics.

​
Prerequisites

​
Enable Fireworks routing

export FIREWORKS_API_KEY=fw_...
fireconnect pi on
Restart Pi after enabling if it is already running. 
fireconnect pi status

​
Using Fire Pass

Use your fpk_... key instead of a standard fw_... key: 
export FIREWORKS_API_KEY=fpk_...
fireconnect pi on --api-key fpk_...
FireConnect detects Fire Pass keys and defaults Pi to glm-latest.

​
Default model

Pi routes a single default model. The default is glm-latest.

​
What gets written

FireConnect:
  • Sets defaultProvider / defaultModel in ~/.pi/agent/settings.json
  • Stores the API key in ~/.pi/agent/auth.json ($FIREWORKS_API_KEY when from env, literal with --api-key)
  • Writes auth.json at mode 0600
FireConnect snapshots both files under ~/.fireconnect/pi/ before the first change. Running fireconnect pi off restores them byte-for-byte.

​
API key handling

  • If the key comes from FIREWORKS_API_KEY, it is written as $FIREWORKS_API_KEY so the secret stays out of settings.
  • Passing --api-key writes the literal key to auth.json instead.

​
Browsing and picking models

fireconnect pi model list              # browse serverless endpoints
fireconnect pi model select            # pick Pi's default model
fireconnect pi model select --search glm
Fire Pass keys (fpk_...) show Fire Pass-supported routers only.

​
CLI reference

fireconnect pi on              # Enable Fireworks routing
fireconnect pi off             # Restore original settings and auth
fireconnect pi status          # Check current provider and model
fireconnect pi model list      # Browse serverless endpoints
fireconnect pi model select    # Pick a model interactively
fireconnect pi model reset     # Reset model to default
fireconnect pi help            # Show harness-specific help
Run fireconnect pi help for all options.

​
Switch models

fireconnect pi on --main glm-5p1

​
Turn off Fireworks routing

fireconnect pi off
This restores your previous settings.json and auth.json from the backup in ~/.fireconnect/pi/.

​
Use a non-default settings file

fireconnect pi on --settings-path /path/to/settings.json

​
Source

FireConnect is open source: github.com/fw-ai/fireconnect