clef-router

Route prompts between cheap and frontier LLMs using Cloudflare's Clef decision model.

Quick start

pip install clef-router
export CLEF_ACCOUNT_ID=your_cloudflare_account_id
export CLEF_API_TOKEN=your_cloudflare_api_token

from clef_router import ClefRouter

router = ClefRouter()
result = router.route("What is the capital of France?")
print(result.tier)       # "cheap"
print(result.reason)     # "classified as simple, confidence 0.90"

result = router.route("Design a distributed consensus algorithm")
print(result.tier)       # "frontier"

How it works

prompt → Clef decision model (Cloudflare Workers AI) → tier
              ├─ simple   → cheap model
              ├─ standard  → cheap model
              ├─ complex   → frontier model
              └─ uncertain → frontier (confidence gate)

clef vs laya

Use laya-router for sub-10ms local routing. Use clef-router when quality matters more than latency.

License

Apache 2.0