• OpenAI-compatible API - Uses CrofAI's /v1/chat/completions endpoint
• Reasoning models - Support for thinking models with reasoning_effort parameter
• Vision models - Image input support on Kimi K2.5, Kimi K2.6, GLM 5.1 (Precision), and Qwen 3.5 / 3.6
• Tool use - Function calling support
• Streaming - Real-time token streaming
• Free tier - Some models available at no cost (GLM 4.7 Flash, Qwen3.5 9B)
• Usage status bar — Displays your remaining credits and daily request count in the pi footer, updated live across sessions

Install directly from GitHub:

pi install https://github.com/monotykamary/pi-crofai-provider

Then set your API key and run pi:

# Recommended: add to auth.json
# See Authentication section below

# Or set as environment variable
export CROFAI_API_KEY=your-api-key-here

pi

Get your API key from crof.ai.

1. Clone this repository:

   git clone https://github.com/monotykamary/pi-crofai-provider.git
   cd pi-crofai-provider

2. Set your CrofAI API key:

   # Recommended: add to auth.json
   # See Authentication section below
   
   # Or set as environment variable
   export CROFAI_API_KEY=your-api-key-here

3. Run pi with the extension:

   pi -e /path/to/pi-crofai-provider

The CrofAI API key can be configured in multiple ways (resolved in this order):

1. auth.json (recommended) — Add to ~/.pi/agent/auth.json:

   { "crofai": { "type": "api_key", "key": "your-api-key" } }

   The key field supports literal values, env var names, and shell commands (prefix with !). See pi's auth file docs for details.
2. Runtime override — Use the --api-key CLI flag
3. Environment variable — Set CROFAI_API_KEY

Get your API key from crof.ai.

Add to your pi configuration for automatic loading:

{
  "extensions": [
    "/path/to/pi-crofai-provider"
  ]
}

Once loaded, select a model with:

/model crofai kimi-k2.5

Or use /models to browse all available CrofAI models.

For reasoning models, control thinking depth:

/reasoning high

Values: none, low, medium, high

Once authenticated, the pi footer shows your CrofAI account status:

$12.35 | ⇄ 450

• $X.XX — Remaining credit balance (hidden when $0)
• ⇄ N — Daily requests remaining (hidden when not on a subscription plan)

The count is fetched from CrofAI's usage API on session start and after each user prompt. Between syncs, the request count is decremented locally per turn to avoid unnecessary API calls.

The CrofAI proxy differs from native provider APIs in several ways. These are handled via patch.json:

Note: The CrofAI /v1/models endpoint does not reliably report reasoning capability. Many models that support thinking are missing the custom_reasoning or reasoning_effort flags. patch.json corrects these based on E2E testing.

• CrofAI Docs: https://crof.ai/docs
• OpenAI-compatible endpoint: https://crof.ai/v1
• Models endpoint: https://crof.ai/v1/models
• Usage endpoint: https://crof.ai/usage_api/

MIT