@earendil-works/pi-radius

@earendil-works/pi-radius

Radius model providers, web search, and API access for Pi.

Included resources

• radius model provider, authenticated through Pi
• Optional radius-dev provider for local gateway development
• radius_web_search for current web research through Radius
• radius-api skill for discovering and invoking Radius API operations

Installation

pi install npm:@earendil-works/pi-radius

Restart Pi or run /reload, then authenticate:

/login radius

Use /model to select a Radius model. Web search is available even when another provider's model is selected, but still requires Radius authentication.

Inspect or enable the installed resources with:

pi list
pi config

Radius API skill

Ask Pi to inspect or manage a Radius resource, or load the skill explicitly with /skill:radius-api. The skill reads the generated Radius guide and OpenAPI contract, then uses one generic authenticated helper for API operations.

Radius routing

With a Radius model selected, run /radius to see which upstream provider served the last request and to configure upstream-provider routing for the current model and session.

/radius                 Open the routing status and settings
/radius status          Print the current routing status
/radius auto            Use automatic routing
/radius prefer <id>     Prefer an upstream provider
/radius force <id>      Require an upstream provider
/radius refresh         Refresh models and provider availability

Provider overrides do not apply to the auto model; its routing is controlled by the Radius auto-model policy.

Configuration

The production gateway defaults to https://radius.pi.dev. These environment variables can override the defaults or provide credentials:

Variable	Purpose
PI_GATEWAY	Production gateway URL
PI_GATEWAY_API_KEY	Production gateway API key (alternative to /login)
PI_DEV_GATEWAY	Enable the radius-dev provider; use 1 for http://localhost:8788 or provide a URL
PI_DEV_GATEWAY_API_KEY	Development gateway API key
PI_CACHE_RETENTION=long	Request long-lived prompt-cache retention when supported

Local development

From the repository root:

pi -e ./packages/pi-radius

Or load one extension directly:

pi -e ./packages/pi-radius/extensions/radius-routing.ts