@earendil-works/pi-radius

Radius provider, web tools, and skills for Pi

Packages

Package details

extensionskill

Install @earendil-works/pi-radius from npm and Pi will load the resources declared by the package manifest.

npm repo home report

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

Package: @earendil-works/pi-radius
Version: 0.1.1
Published: Jul 10, 2026
Downloads: not available
Author: mitsuhiko
License: unknown
Types: extension, skill
Size: 129.1 KB
Dependencies: 0 dependencies · 3 peers

Pi manifest JSON

{
  "extensions": [
    "./extensions/radius-providers.ts",
    "./extensions/radius-web-fetch.ts",
    "./extensions/radius-web-search.ts"
  ],
  "skills": [
    "./skills/radius-auto-model",
    "./skills/radius-message-rewriting"
  ]
}

Security note

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

README

`@earendil-works/pi-radius`

Radius model providers, web tools, and gateway-management skills for Pi.

Included resources

radius model provider, authenticated through Pi
Optional radius-dev provider for local gateway development
web_search for current web research through Radius
web_fetch for extracting content from known URLs
radius-auto-model skill for managing auto-model router policies
radius-message-rewriting skill for managing gateway message-rewriter policies

Installation

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

Restart Pi or run /reload, then authenticate:

/login radius

Use /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 config

Radius 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 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-providers.ts