pi-requesty-provider

Unlock 300+ frontier & open-source LLMs in pi with native tool calling, smart reasoning, real-time pricing, and built-in web search.

pi-requesty-provider seamlessly bridges Requesty — the next-generation LLM router and AI gateway — directly into the pi coding agent. Experience Claude Fable 5, OpenAI GPT-5.6 Sol, xAI Grok 4.6, Gemini 3.7 Flash, Kimi K3, Qwen3.8 Max, DeepSeek V4 Pro, GLM-5, and hundreds more under a single unified provider.

---

⚡ Superpowers & Features

• 🌐 Native Web Search Integration — Browse the live web during agent execution without external tools. Toggle dynamically with /requesty search native on/off (powered by Requesty's server-side web grounding).
• 🛡️ 100% Agent-Ready (Smart Tool Filtering) — Automatically filters out models lacking function/tool calling support. Every model in your picker is guaranteed to work reliably with pi tools.
• 🧠 Deep Reasoning & Vision Support — Automatic detection of thinking budgets, reasoning effort, and multimodal vision capabilities (["text", "image"]).
• 💰 Real-Time Cost & Cache Tracking — Precise per-million-token cost mapping, including tiered pricing, prompt caching read/write rates, and context limits.
• ⌨️ Extensible CLI & Multi-Level Autocomplete — Unified /requesty command router with dynamic categorized help, interactive nested tab-completion, and status monitoring.
• 🔐 Native Auth & Multi-Region — Standard /login requesty flow storing credentials securely in ~/.pi/agent/auth.json, supporting US and EU endpoints.

---

🚀 Quick Installation

From npm (Recommended)

pi install npm:pi-requesty-provider

From GitHub

pi install git:github.com/xinaps-dev/pi-requesty-provider

Local Development

# Clone and build
git clone https://github.com/xinaps-dev/pi-requesty-provider.git
cd pi-requesty-provider
pnpm install
pnpm build

# Run locally in pi
pi -e ./

---

🎯 Getting Started

1. Authenticate

Run the native login command inside pi:

/login requesty

1. Enter your API key (get one at app.requesty.ai/api-keys).
2. Select your regional endpoint:
   • US (Global): https://router.requesty.ai/v1 (Default)
   • EU (Frankfurt): https://router.eu.requesty.ai/v1 (GDPR compliant endpoint)

2. Pick Any Model

Open the model selector:

/model

All models are listed as requesty/<model-id> (e.g. requesty/anthropic/claude-3-7-sonnet, requesty/deepseek/deepseek-r1). Type to filter with fuzzy search.

3. Enable Native Web Search (Optional)

Give your models real-time web access:

/requesty search native on

---

🛠️ Command Reference

The /requesty command comes with full autocomplete and categorized subcommands:

Command	Category	Description
/requesty	General	Show interactive help and subcommand index
/requesty sync	Provider	Fetch and refresh the active model catalog from Requesty API
/requesty status	Provider	Display connection status, active model, endpoints, and search support
/requesty search native on	Search	Enable Requesty native web search grounding (persisted)
/requesty search native off	Search	Disable Requesty native web search grounding
/requesty search native status	Search	Show web search configuration and model capability

---

⚙️ Environment Variables

Prefer configuring via environment variables? Simply export:

Variable	Description	Default
REQUESTY_API_KEY	Your Requesty API key	(required if not logged in)
REQUESTY_BASE_URL	Custom gateway endpoint	https://router.requesty.ai/v1

---

🔍 Model Metadata Mapping

The provider parses Requesty's model catalog into pi native capabilities:

Requesty Attribute	pi Model Feature	Impact
supports_reasoning	reasoning: true, compat.supportsReasoningEffort	Enables thinking/reasoning blocks
supports_vision	input: ["text", "image"]	Allows image and multimodal inputs
supports_tools / supports_function_calling	Catalog filter	Ensures 100% agent execution compatibility
supports_web_search	Model capability flag	Controls native web search injection
context_window & max_output_tokens	contextWindow, maxTokens	Optimizes context management and limits
pricing[] / input_price / caching_price	cost.input, cost.output, cost.tiers	Accurate prompt and cache token cost tracking

---

🏗️ Architecture

┌────────────────────────────────────────────────────────────────────────┐
│                          pi CLI / TUI Runtime                          │
│                                                                        │
│   /login requesty    /requesty [sync|status|search]    /model requesty │
│         │                          │                          │        │
│         ▼                          ▼                          ▼        │
│   ┌───────────────────────────────────────────────────────────────┐    │
│   │                pi-requesty-provider Extension                 │    │
│   │                                                               │    │
│   │   ┌──────────────┐   ┌─────────────────┐   ┌──────────────┐   │    │
│   │   │  AuthEngine  │   │  CommandRouter  │   │  CatalogSync │   │    │
│   │   │ (ApiKeyAuth) │   │ (Multi-level AC)│   │(Model Parser)│   │    │
│   │   └──────────────┘   └─────────────────┘   └──────────────┘   │    │
│   │                               │                               │    │
│   │              ┌────────────────┴────────────────┐              │    │
│   │              │  before_provider_request Hook   │              │    │
│   │              │  (Native Web Search Injection)  │              │    │
│   │              └────────────────┬────────────────┘              │    │
│   └───────────────────────────────┼───────────────────────────────┘    │
│                                   │                                    │
└───────────────────────────────────┼────────────────────────────────────┘
                                    ▼
                     ┌──────────────────────────────┐
                     │    Requesty Router Gateway   │
                     │   https://router.requesty.ai │
                     ├──────────────────────────────┤
                     │  GET  /v1/models             │
                     │  POST /v1/chat/completions   │
                     └──────────────────────────────┘
                                    ▼
              ~/.pi/agent/auth.json  │  ~/.pi/agent/requesty.json

---

💻 Development & Contributing

Prerequisites

• Node.js 20+
• pnpm 8+

Scripts

pnpm install          # Install dependencies
pnpm typecheck        # Run type checking
pnpm test             # Run Vitest test suite

Project Layout

pi-requesty-provider/
├── index.ts                  # Extension entry point & lifecycle hooks
├── src/
│   ├── commands.ts           # Unified hierarchical /requesty command router
│   ├── types.ts              # Global extension types & definitions
│   ├── constants.ts          # Extension-level constants
│   ├── provider/             # Core Provider module
│   │   ├── index.ts          # Provider factory and model caching
│   │   ├── auth.ts           # ApiKeyAuth implementation
│   │   ├── client.ts         # Requesty REST client
│   │   ├── models.ts         # Model transformer & capability mapper
│   │   ├── commands.ts       # sync & status subcommand handlers
│   │   └── types.ts          # Requesty API & Model types
│   └── search/               # Native Web Search module
│       ├── index.ts          # Search module exports
│       ├── config.ts         # Config store (~/.pi/agent/requesty.json)
│       ├── interceptor.ts    # before_provider_request payload interceptor
│       └── commands.ts       # /requesty search native subcommands
└── tests/                    # Unit and integration tests

---

📄 License

MIT © xinaps