pi-provider-env

Pi extension that registers up to two independent providers from environment variables:

• OPENAI_ENV_* → an OpenAI Chat Completions compatible provider (default id openai-env). Opus 4.7/4.8 reasoning is transparently routed to the gateway's /v1/messages adaptive-thinking endpoint via a custom stream handler.
• ANTHROPIC_ENV_* → an Anthropic Messages compatible provider (default id anthropic-env). All models go through pi's built-in anthropic-messages API (streaming, thinking, prompt caching handled natively — no custom stream handler).

The two providers are fully independent: each reads only its own variables (no cross-fallback) and is registered only when its BASE_URL + credential are present. Set one, the other, or both at the same time.

Environment Variables

OpenAI-completions provider (OPENAI_ENV_*)

Variable	Required	Default	Description
OPENAI_ENV_BASE_URL	Yes	—	Gateway base URL (with or without /v1)
OPENAI_ENV_API_KEY	Yes	—	Gateway API key (sent as Authorization: Bearer). If missing, this provider is skipped.
OPENAI_ENV_MODEL_ID	No	—	Specific model ID. If unset, fetches all models from /v1/models.
OPENAI_ENV_MODEL_EXTRA	No	—	Extra config as JSON (contextWindow, maxTokens)
OPENAI_ENV_PROVIDER_ID	No	openai-env	Provider ID
OPENAI_ENV_PROVIDER_NAME	No	OpenAI (Environment)	Provider display name

Anthropic-messages provider (ANTHROPIC_ENV_*)

Variable	Required	Default	Description
ANTHROPIC_ENV_BASE_URL	Yes	—	Gateway base URL (with or without /v1; the SDK appends /v1/messages)
ANTHROPIC_ENV_AUTH_TOKEN	Yes	—	Gateway auth token (alias: ANTHROPIC_ENV_API_KEY). If missing, this provider is skipped.
ANTHROPIC_ENV_MODEL_ID	No	—	Specific model ID. If unset, fetches all models from /v1/models.
ANTHROPIC_ENV_MODEL_EXTRA	No	—	Extra config as JSON (contextWindow, maxTokens)
ANTHROPIC_ENV_PROVIDER_ID	No	anthropic-env	Provider ID
ANTHROPIC_ENV_PROVIDER_NAME	No	Anthropic (Environment)	Provider display name

Auth

• OpenAI provider: Authorization: Bearer <OPENAI_ENV_API_KEY> (pi's built-in OpenAI auth).
• Anthropic provider: the token is sent two ways so it works with gateways that expect either scheme:
  • x-api-key: <token> — pi's built-in Anthropic auth (from apiKey)
  • Authorization: Bearer <token> — added via custom headers

Model Discovery

Both providers discover models from the OpenAI-compatible GET {base}/v1/models endpoint (authenticated with Authorization: Bearer).

Claude Opus 4.7/4.8 are special-cased in both providers: adaptive thinking, maxTokens capped at 128000 (gateway returns 400 above this), and the off/minimal thinking levels suppressed. The OpenAI provider additionally carries per-vendor compat/thinkingLevelMap tuning (GPT, Qwen, DeepSeek, Kimi, MiniMax) for Chat Completions quirks.

max_tokens caps (per endpoint × vendor / category)

The gateway does not report max_tokens in /v1/models, and the output-token ceiling differs both by vendor and by endpoint. Each provider applies its own endpoint-specific cap table as the default upper limit (all values measured against the live gateway):

Vendor / category (owned_by / id)	OpenAI (Chat Completions)	Anthropic (Messages)
Claude Opus 4.7/4.8	128000	128000
Claude (other, AMAZON_AI)	65536	65536
GPT (id contains gpt)	128000	— (skipped)
DeepSeek-Pro	65536	8192
DeepSeek (other, e.g. Flash)	65536	65536
GLM (OTHER)	65536	8192
Qwen (ALI_QWEN)	65536	65536
Kimi (MOONSHOT_AI)	65536	65536
MiniMax (MINIMAX)	65536	65536
unmatched	*_ENV_MODEL_EXTRA.maxTokens or 65536	same

Only DeepSeek-Pro and GLM actually differ by endpoint (the Anthropic endpoint caps them at ~8192, while Chat Completions accepts 65536). Claude is capped at 65536 on the Anthropic endpoint because above that the gateway drops usage and crashes the client. If the gateway ever reports a positive max_tokens for a model, that value takes priority. *_ENV_MODEL_EXTRA={"maxTokens":N} sets the fallback for unmatched vendors only.

GPT models are skipped by the Anthropic provider: this gateway's Anthropic adapter returns empty content and omits usage, which crashes the client. Use the OpenAI provider (OPENAI_ENV_*) for GPT instead.

Install

pi install npm:pi-provider-env

Or try without persisting:

pi -e npm:pi-provider-env

Usage

OpenAI-completions provider:

export OPENAI_ENV_BASE_URL="https://gateway.example.com"
export OPENAI_ENV_API_KEY="sk-xxx"
export OPENAI_ENV_MODEL_ID="gpt-4o"        # optional
pi

Anthropic-messages provider:

export ANTHROPIC_ENV_BASE_URL="https://gateway.example.com"
export ANTHROPIC_ENV_AUTH_TOKEN="sk-xxx"
export ANTHROPIC_ENV_MODEL_ID="claude-opus-4-8"  # optional
pi

Both at once (two providers appear in /model or Ctrl+P):

export OPENAI_ENV_BASE_URL="https://gateway.example.com"
export OPENAI_ENV_API_KEY="sk-xxx"
export ANTHROPIC_ENV_BASE_URL="https://gateway.example.com"
export ANTHROPIC_ENV_AUTH_TOKEN="sk-xxx"
pi

System CA Trust

On Node 22.15+ / 23.9+, this extension also merges system root CAs (macOS Keychain / Windows cert store / Linux system CA) into Node's default trust set. This enables TLS verification for internally-signed or custom certificates without disabling verification entirely (NODE_TLS_REJECT_UNAUTHORIZED=0).