pi-runinfra

RunInfra.ai model provider extension for pi.

Registers the RunInfra OpenAI-compatible endpoint as the runinfra provider with its current model catalog, including cost metadata, reasoning-level mapping, and the per-request X-Client-Request-Id header RunInfra's API examples expect.

Models

Prices per 1M tokens (as listed on https://runinfra.ai/inference-api).

RunInfra also accepts the short slugs from GET /v1/models (deepseek-v4-1-flash, glm-5-3-flash, nemotron-3-5-lightning-30b, qwen3-8-27b, ornith-1-5-35b).

DeepSeek V4 Flash (deepseek-v4-flash) was retired on 2026-09-29, and DeepSeek V4 Pro / Qwen3.8 2.4T are no longer served, so they were removed. Switch to deepseek-ai/DeepSeek-V4.1-Flash.

Install

pi install npm:pi-runinfra

Or try it without installing:

pi -e npm:pi-runinfra

If you previously used the standalone extension at ~/.pi/agent/extensions/runinfra.ts, remove it to avoid double registration: rm ~/.pi/agent/extensions/runinfra.ts

API Key

Register your RunInfra workspace key (from https://runinfra.ai → API keys) one of these ways — any order:

# 1) Environment variable (matches RunInfra's own docs)
export RUNINFRA_GATEWAY_KEY=sk-...
pi

# 2) pi's native login (stores the key in ~/.pi/agent/auth.json)
/login runinfra

# 3) This package's command (writes ~/.pi/agent/auth.json directly)
/runinfra-key

Usage

# pick a model interactively
/model → runinfra/deepseek-ai/DeepSeek-V4.1-Flash

# or start pi directly on it
pi --provider runinfra --model deepseek-ai/DeepSeek-V4.1-Flash

Behavior Notes

• Reasoning: every model reasons by default, and omitting reasoning_effort means the model's default (maximum) effort. The extension pins an explicit effort per pi thinking level.
• DeepSeek / Nemotron / Qwen / Ornith: off → "none" (no reasoning), minimal/low → "low", medium → "medium", high → "high", xhigh/max → "max". Qwen3.8 rejects "minimal", so it is never sent.
• GLM 5.3 Flash: thinking cannot be disabled ("none" is rejected), and every value other than low / high is treated as maximum effort, so only low / high / max are exposed.
• Images: GLM 5.3 Flash, Qwen3.8 27B and Ornith 1.5 35B accept image input; DeepSeek V4.1 Flash and Nemotron are text only.
• X-Client-Request-Id: a per-request UUID is added to every request via the before_provider_headers event (retries reuse the same id).
• System role: supportsDeveloperRole: false — the system prompt is sent as system, not developer, matching DeepSeek/Qwen-style endpoints.
• If RunInfra rejects a value, edit thinkingLevelMap in extensions/runinfra.ts or override it via models.json.

Overrides

models.json overrides compose above this extension's provider, so you can tune prices, context windows, or endpoints without editing the package:

{
  "providers": {
    "runinfra": {
      "modelOverrides": {
        "deepseek-ai/DeepSeek-V4.1-Flash": {
          "maxTokens": 65536,
          "cost": { "input": 0.1, "output": 0.25 }
        }
      }
    }
  }
}

Development

npm pack --dry-run   # inspect the publish contents
npm login
npm publish         # manual one-off publish (alternative to the CI flow below)

Release Flow (GitHub Actions)

Pushing to main triggers .github/workflows/release.yml, which — no release PRs involved:

1. Detect bump type from conventional commits since the last v* tag (feat: → minor, fix:/perf: → patch, breaking change → major). Commits that don't warrant a release (docs:, chore:, ci:, …) are skipped.
2. Bump & tag: runs npm version, commits chore(release): vX.Y.Z directly to main, pushes the vX.Y.Z tag.
3. GitHub Release with auto-generated notes.
4. npm publish with npm publish --provenance using the NPM_TOKEN secret.

A "Publish to npm (manual)" workflow remains as a fallback (e.g. if NPM_TOKEN was missing). Do not run it after a feat:/fix: push — that already published. If the version is already on npm, the workflow now skips instead of failing with E409.

Commit message conventions

feat: add a new model          → minor bump (0.x: 0.1.0 → 0.2.0)
fix: correct pricing metadata   → patch bump (0.1.0 → 0.1.1)
feat!: change provider id      → major bump
docs:/chore:/ci:               → no release

Setup checklist

1. Repo is on GitHub and NPM_TOKEN is set in repo Settings → Secrets and variables → Actions (npm token, "Automation" type to bypass 2FA).
2. Push a conventional commit to main — release + npm publish happen automatically.

npm publish --provenance uses GitHub OIDC (sigstore) and requires the repository field in package.json (already set); remove the --provenance flag and the id-token: write permission if you don't want it.

License

MIT