@earendil-works/pi-radius
v0.1.8
Published
Radius provider, web tools, and skills for Pi
Keywords
Readme
@earendil-works/pi-radius
Radius model providers, web tools, and gateway-management skills for Pi.
Included resources
radiusmodel provider, authenticated through Pi- Optional
radius-devprovider for local gateway development web_searchfor current web research through Radiusweb_fetchfor extracting content from known URLsradius-auto-modelskill for managing auto-model router policiesradius-message-rewritingskill for managing gateway message-rewriter policies
Installation
pi install npm:@earendil-works/pi-radiusRestart Pi or run /reload, then authenticate:
/login radiusUse /model to select a Radius model. The web tools are available even when another provider's model is selected, but still require Radius authentication.
Inspect or enable the installed resources with:
pi list
pi configRadius routing
With a Radius model selected, run /radius to configure upstream-provider routing for the current model and session.
/radius Open the routing settings
/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 availabilityProvider 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-radiusOr load one extension directly:
pi -e ./packages/pi-radius/extensions/radius-providers.ts