pi-opinionated-zenmux

Provider-only Pi package that registers the curated ZenMux model set used by pi-excalibur.

Packages

Package details

extension

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

npm report
$ pi install npm:pi-opinionated-zenmux
Package
pi-opinionated-zenmux
Version
0.1.2
Published
May 2, 2026
Downloads
49/mo · 6/wk
Author
exaclior123
License
unknown
Types
extension
Size
8.6 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-opinionated-zenmux

Provider-only Pi package for the curated ZenMux model set actually used by pi-excalibur.

Requires Pi >=0.72.0 so model thinking support can use Pi's thinkingLevelMap capability metadata.

It keeps the provider name as zenmux, so literal model references like zenmux/gpt-5.5 keep working without any repo-local retagging.

Install

# try temporarily
pi -e ~/coding_agents/pi-opinionated-zenmux

# or install into the current project
pi install -l ~/coding_agents/pi-opinionated-zenmux

Set your API key before use:

export ZENMUX_API_KEY=...

Registered provider

  • Provider name: zenmux
  • API key env var: ZENMUX_API_KEY

Included models

Model ID Route Why it is included
anthropic/claude-opus-4.7 Anthropic-compatible next-gen Opus reasoning
claude-opus-4.6 Anthropic-compatible review challenger, diagram/animation prompts
claude-sonnet-4.6 Anthropic-compatible librarian prompt
gpt-5.5 OpenAI-compatible review fast/primary/synthesis
moonshotai/kimi-k2.6 OpenAI-compatible long-context cheap reasoning
gemini-3-flash-preview Google Vertex-compatible finder, look_at, summarize_media
gemini-3-pro-image-preview Google Vertex-compatible painter raster generation
gemini-3.1-flash-lite-preview Google Vertex-compatible painter retrospect

Notes

  • Anthropic models route through https://zenmux.ai/api/anthropic.
  • OpenAI models route through https://zenmux.ai/api/v1.
  • Gemini models route through https://zenmux.ai/api/vertex-ai/v1/publishers/google.
  • pi-excalibur refers to these models by their literal IDs; this package owns transport routing, not synthetic suffixes or alias tags.
  • gpt-5.5, anthropic/claude-opus-4.7, and claude-opus-4.6 declare explicit xhigh mappings so Pi 0.72+ does not clamp them down to high.

Usage

After loading the package, select models exactly as pi-excalibur already does:

  • zenmux/gpt-5.5
  • zenmux/anthropic/claude-opus-4.7
  • zenmux/claude-opus-4.6
  • zenmux/claude-sonnet-4.6
  • zenmux/moonshotai/kimi-k2.6
  • zenmux/gemini-3-flash-preview
  • zenmux/gemini-3-pro-image-preview
  • zenmux/gemini-3.1-flash-lite-preview