@earendil-works/pi-radius

Radius provider, web search, and API access 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.12
Published: Aug 25, 2026
Downloads: 646/mo · 89/wk
Author: mitsuhiko
License: unknown
Types: extension, skill
Size: 49.7 KB
Dependencies: 0 dependencies · 4 peers

Pi manifest JSON

{
  "extensions": [
    "./extensions/radius-routing.ts",
    "./extensions/radius-notices.ts",
    "./extensions/radius-web-search.ts"
  ],
  "skills": [
    "./skills/radius-api"
  ]
}

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 search, and API access 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
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