diff --git a/CLAUDE.md b/CLAUDE.md index b0a960d..2b4dc8c 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -1,6 +1,6 @@ # XClawRouter -Smart LLM router for autonomous agents. 76 models. Wallet-based auth. USDC micropayments via x402. +Smart LLM router for autonomous agents. 78 models. Wallet-based auth. USDC micropayments via x402. ## Commands diff --git a/README.md b/README.md index 267f871..95f3cc2 100644 --- a/README.md +++ b/README.md @@ -5,8 +5,8 @@

The LLM router built for autonomous agents

Use one BlockRun account API key or let an agent settle each request over x402.

-Local smart routing across 76 models.

-7 models free, no crypto required.

+Local smart routing across 78 models.

+6 models free, no crypto required.


@@ -33,7 +33,7 @@ -> **XClawRouter** is an open-source smart LLM router that reduces AI API costs by 84%. It analyzes each request across 15 dimensions and routes locally to the cheapest capable model in under 1ms. Use a BlockRun account API key with prepaid credit, or settle requests with USDC over x402 on Solana or Base. 76 models from OpenAI, Anthropic, Google, xAI, DeepSeek, and more. MIT licensed. +> **XClawRouter** is an open-source smart LLM router that reduces AI API costs by 84%. It analyzes each request across 15 dimensions and routes locally to the cheapest capable model in under 1ms. Use a BlockRun account API key with prepaid credit, or settle requests with USDC over x402 on Solana or Base. 78 models from OpenAI, Anthropic, Google, xAI, DeepSeek, and more. MIT licensed. --- @@ -57,7 +57,7 @@ Both modes use the same local router and model IDs. | | OpenRouter | LiteLLM | Martian | Portkey | **ClawRouter** | | ---------------- | ----------------- | ---------------- | ----------------- | ----------------- | ---------------------------------------------------------------------- | | **Models** | 200+ | 100+ | Smart routing | Gateway | **60+** | -| **Free tier** | Rate-limited | BYO keys | No | No | **7 models, no signup** | +| **Free tier** | Rate-limited | BYO keys | No | No | **6 models, no signup** | | **Routing** | Manual selection | Manual selection | Smart (closed) | Observability | **Smart (open source)** | | **Auth** | Account + API key | Your API keys | Account + API key | Account + API key | **BlockRun API key or wallet signature** | | **Payment** | Credit card | BYO keys | Credit card | $49-499/mo | **Account credit or USDC per-request** | @@ -294,7 +294,7 @@ Edit existing images with `/img2img`: ## Models & Pricing -76 models across 9 providers, one BlockRun API key or x402 wallet. **Starting at $0.0002/request.** +78 models across 9 providers, one BlockRun API key or x402 wallet. **Starting at $0.0002/request.** > **💡 "Cost per request"** = estimated cost for a typical chat message (~500 input + 500 output tokens). @@ -380,7 +380,7 @@ Edit existing images with `/img2img`: | anthropic/claude-fable-5 | $10.00 | $50.00 | $0.0300 | 1M | reasoning, vision, agentic, tools | | openai/gpt-5.5-pro | $30.00 | $180.00 | $0.1020 | 1M | reasoning, vision, tools | -> **Free tier:** 7 models cost nothing — `/model free` points to nemotron-3.5-lightning, or pick any free model directly (e.g., `/model nemotron-omni` for vision, `/model north-mini-code` for coding, `/model nemotron-3-ultra-550b` for reasoning + 1M context). +> **Free tier:** 6 models cost nothing — `/model free` points to nemotron-3.5-lightning, or pick any free model directly (e.g., `/model nemotron-omni` for vision, `/model north-mini-code` for coding, `/model nemotron-3-ultra-550b` for reasoning + 1M context). > **Best value:** `xiaomi/mimo-v2.5`, `qwen/qwen3.8-flash` and `zai/glm-5.3-flash` deliver strong results at ~$0.0003/request. --- @@ -554,7 +554,7 @@ npm test **The LLM router built for autonomous agents** -You're here. 76 models, local smart routing, x402 USDC payments — the only stack that lets agents operate independently. +You're here. 78 models, local smart routing, x402 USDC payments — the only stack that lets agents operate independently. `curl -fsSL https://blockrun.ai/XClawRouter-update | bash` @@ -565,7 +565,7 @@ You're here. 76 mod **BlockRun for Claude Code** -Run Claude Code with 76 models, no rate limits, no Anthropic account, no phone verification. Pay per request with USDC — your wallet is your identity. +Run Claude Code with 78 models, no rate limits, no Anthropic account, no phone verification. Pay per request with USDC — your wallet is your identity. `curl -fsSL https://blockrun.ai/brcc-install | bash` diff --git a/brand-numbers.json b/brand-numbers.json index ec77809..90d551d 100644 --- a/brand-numbers.json +++ b/brand-numbers.json @@ -2,17 +2,17 @@ "$schema": "https://blockrun.ai/brand/numbers.schema.json", "version": 1, "models": { - "chatVisible": 76, - "totalVisible": 100, - "free": 7, - "freeWithheld": 26, + "chatVisible": 78, + "totalVisible": 102, + "free": 6, + "freeWithheld": 27, "image": 9, "video": 8, "music": 1, "speech": 5, "soundfx": 1, - "withFallback": 34, - "withFallbackAllEntries": 73 + "withFallback": 33, + "withFallbackAllEntries": 74 }, "clawrouter": { "dimensions": 15, diff --git a/docs/anthropic-cost-savings.md b/docs/anthropic-cost-savings.md index c15b507..5779daf 100644 --- a/docs/anthropic-cost-savings.md +++ b/docs/anthropic-cost-savings.md @@ -50,7 +50,7 @@ This is where you're paying for real value: ## The Solution: ClawRouter -[ClawRouter](https://github.com/BlockRunAI/XClawRouter) is an open-source local proxy that sits between your app and 76 AI models. It saves you money in three ways: **smart routing**, **token optimization**, and **response caching**. +[ClawRouter](https://github.com/BlockRunAI/XClawRouter) is an open-source local proxy that sits between your app and 78 AI models. It saves you money in three ways: **smart routing**, **token optimization**, and **response caching**. ``` ┌─────────────┐ ┌──────────────────────────────┐ ┌──────────────────┐ diff --git a/docs/anthropic-third-party-harness-changes.md b/docs/anthropic-third-party-harness-changes.md index 5b75e3d..f5cfc37 100644 --- a/docs/anthropic-third-party-harness-changes.md +++ b/docs/anthropic-third-party-harness-changes.md @@ -31,7 +31,7 @@ This is exactly the problem [XClawRouter](https://github.com/BlockRunAI/XClawRou ## XClawRouter: Smart Routing for Agents -XClawRouter is an open-source local proxy that sits between your agent and 76 LLM models across 9 providers. It analyzes every request across 15 dimensions and routes it to the cheapest model that can handle it — in under 1ms, entirely locally. +XClawRouter is an open-source local proxy that sits between your agent and 78 LLM models across 9 providers. It analyzes every request across 15 dimensions and routes it to the cheapest model that can handle it — in under 1ms, entirely locally. ``` Your Agent → XClawRouter (localhost:8402) → Best model for the job @@ -74,7 +74,7 @@ Then point your agent at `http://localhost:8402/v1/` with any OpenAI-compatible - **No API keys to manage** — wallet-based cryptographic auth - **No subscriptions** — pay per request in USDC (Base or Solana) -- **No vendor lock-in** — 76 models, switch anytime +- **No vendor lock-in** — 78 models, switch anytime - **You control your wallet** — non-custodial, funds never held by a third party - **Budget caps** — set a max spend per session, XClawRouter gracefully downgrades when budget runs low - **Token compression** — 7-layer pipeline reduces token costs by 7–40% before they hit any provider diff --git a/docs/clawrouter-cuts-llm-api-costs-500x.md b/docs/clawrouter-cuts-llm-api-costs-500x.md index 2f47e17..454c1fe 100644 --- a/docs/clawrouter-cuts-llm-api-costs-500x.md +++ b/docs/clawrouter-cuts-llm-api-costs-500x.md @@ -135,7 +135,7 @@ Less context repeated = fewer tokens = lower cost. Agents that need to recall ea ### 7. x402 Micropayments — Wallet-Based Budget Control -

Budget limits enforced by physical construction — wallet loaded via Base/Solana, pay per call across <!-- br:models.chatVisible -->76<!-- /br:models.chatVisible --> models, balance hits zero and the valve shuts cleanly

+

Budget limits enforced by physical construction — wallet loaded via Base/Solana, pay per call across <!-- br:models.chatVisible -->78<!-- /br:models.chatVisible --> models, balance hits zero and the valve shuts cleanly

XClawRouter pays for inference via [x402](https://x402.org/) USDC micropayments (Base or Solana). You load a wallet. Each inference call costs exactly what it costs. When the wallet runs low, requests stop cleanly. diff --git a/docs/clawrouter-vs-openrouter-llm-routing-comparison.md b/docs/clawrouter-vs-openrouter-llm-routing-comparison.md index 2025c53..6b6511b 100644 --- a/docs/clawrouter-vs-openrouter-llm-routing-comparison.md +++ b/docs/clawrouter-vs-openrouter-llm-routing-comparison.md @@ -222,7 +222,7 @@ OpenRouter doesn't always pass through provider-specific features correctly. Ima **Direct provider routing.** XClawRouter routes through BlockRun's API directly to providers — not through a second aggregator. One hop, not two. Provider-specific features work because there's no middleman translating them. -![Guaranteed Feature Parity & Direct Connectivity — Three-panel diagram: Vision (image_url auto-detected → vision-capable models only), Tool Calling (toolCalling flag → agentic models only), Catalog (curated 76 models with automatic legacy-to-modern redirects). Direct provider routing means no dropped payloads.](./assets/clawrouter-feature-parity-direct-connectivity.png) +![Guaranteed Feature Parity & Direct Connectivity — Three-panel diagram: Vision (image_url auto-detected → vision-capable models only), Tool Calling (toolCalling flag → agentic models only), Catalog (curated 78 models with automatic legacy-to-modern redirects). Direct provider routing means no dropped payloads.](./assets/clawrouter-feature-parity-direct-connectivity.png) --- @@ -240,7 +240,7 @@ When new models launch, OpenRouter's catalog lags. Users configure a model that ### How XClawRouter Solves This -XClawRouter maintains a curated catalog of 76 models across 9 providers (including 11 free models), updated with each release. Delisted models have automatic redirect aliases: +XClawRouter maintains a curated catalog of 78 models across 9 providers (including 11 free models), updated with each release. Delisted models have automatic redirect aliases: ```typescript // Delisted models redirect automatically @@ -268,7 +268,7 @@ No silent drops. No stale catalog. Models are benchmarked for speed, quality, an | **Rate limits** | Per-key, shared | Per-wallet, independent | | **Vision support** | Images sometimes dropped | Auto-detected, vision-only fallback | | **Tool calling** | Silent failures with some models | Flag-based filtering, guaranteed support | -| **Model catalog** | Laggy, silent drops | Curated 76 models, redirect aliases | +| **Model catalog** | Laggy, silent drops | Curated 78 models, redirect aliases | | **Budget control** | Monthly invoice | Per-session cap (`maxCostPerRun`) | | **Setup** | Create account, paste key | Agent generates wallet, auto-configured | | **Average cost** | $25/M tokens (Opus direct) | auto-routed = **84% savings** | diff --git a/docs/llm-router-benchmark-46-models-sub-1ms-routing.md b/docs/llm-router-benchmark-46-models-sub-1ms-routing.md index b5bb11d..1c0f50e 100644 --- a/docs/llm-router-benchmark-46-models-sub-1ms-routing.md +++ b/docs/llm-router-benchmark-46-models-sub-1ms-routing.md @@ -13,7 +13,7 @@ The results changed how we route requests. ## Why We Did This -BlockRun is an x402 micropayment gateway that sits between your AI agent and 76 LLM providers. Every request flows through our payment verification layer before hitting the model API. That means our latency numbers include everything a real user experiences: payment auth, provider API call, and response delivery. +BlockRun is an x402 micropayment gateway that sits between your AI agent and 78 LLM providers. Every request flows through our payment verification layer before hitting the model API. That means our latency numbers include everything a real user experiences: payment auth, provider API call, and response delivery. Most benchmarks measure model speed in isolation. We wanted to measure what users actually feel. @@ -136,7 +136,7 @@ Raw benchmark data: [benchmark-results.json](https://github.com/BlockRunAI/XClaw --- -_BlockRun is the x402 micropayment gateway for AI. One wallet, 76 models, pay-per-request with USDC. [Get started](https://blockrun.ai)_ +_BlockRun is the x402 micropayment gateway for AI. One wallet, 78 models, pay-per-request with USDC. [Get started](https://blockrun.ai)_ --- diff --git a/docs/plans/2026-02-03-smart-routing-design.md b/docs/plans/2026-02-03-smart-routing-design.md index c0583b7..a95ef40 100644 --- a/docs/plans/2026-02-03-smart-routing-design.md +++ b/docs/plans/2026-02-03-smart-routing-design.md @@ -6,7 +6,7 @@ Simple queries go to Claude Opus at $75/M output tokens when Gemini Flash could handle them at $0.60/M. No cost-aware model selection. -Phase 1 solved API key management (one wallet for 76 models). Phase 2 solves cost optimization by routing queries to the cheapest capable model. +Phase 1 solved API key management (one wallet for 78 models). Phase 2 solves cost optimization by routing queries to the cheapest capable model. ## Why Client-Side diff --git a/docs/smart-llm-router-14-dimension-classifier.md b/docs/smart-llm-router-14-dimension-classifier.md index b406723..a7a9cca 100644 --- a/docs/smart-llm-router-14-dimension-classifier.md +++ b/docs/smart-llm-router-14-dimension-classifier.md @@ -7,7 +7,7 @@ _March 20, 2026 | BlockRun Engineering_ > the benchmark. For current figures see > [blockrun.ai/brand/numbers.json](https://blockrun.ai/brand/numbers.json). -When you route AI requests across 76 models from 8 providers, you can't just pick the cheapest one. You can't just pick the fastest one either. We learned this the hard way. +When you route AI requests across 78 models from 8 providers, you can't just pick the cheapest one. You can't just pick the fastest one either. We learned this the hard way. This is the technical story of how we benchmarked every model on our platform, discovered that speed and intelligence are poorly correlated, and built a production routing system that classifies requests in under 1ms using 14 weighted dimensions with sigmoid confidence calibration. @@ -26,7 +26,7 @@ We needed a system that could classify any request and route it to the optimal m ## Step 1: Benchmarking the Fleet -Before building the router, we needed ground truth. We benchmarked all 76 models through our production payment pipeline. +Before building the router, we needed ground truth. We benchmarked all 78 models through our production payment pipeline. ### Methodology @@ -317,7 +317,7 @@ We originally designed a two-stage system where low-confidence rules-based class ## Appendix: Full Benchmark Data -Raw data (76 models, latency, throughput, IQ scores, pricing): [`benchmark-merged.json`](https://github.com/BlockRunAI/XClawRouter/blob/main/benchmark-merged.json) +Raw data (78 models, latency, throughput, IQ scores, pricing): [`benchmark-merged.json`](https://github.com/BlockRunAI/XClawRouter/blob/main/benchmark-merged.json) Routing configuration: [`src/router/config.ts`](https://github.com/BlockRunAI/XClawRouter/blob/main/src/router/config.ts) @@ -325,4 +325,4 @@ Scoring implementation: [`src/router/rules.ts`](https://github.com/BlockRunAI/XC --- -_BlockRun is the x402 micropayment gateway for AI. One wallet, 76 models, pay-per-request with USDC. [blockrun.ai](https://blockrun.ai)_ +_BlockRun is the x402 micropayment gateway for AI. One wallet, 78 models, pay-per-request with USDC. [blockrun.ai](https://blockrun.ai)_ diff --git a/skills/xclawrouter/SKILL.md b/skills/xclawrouter/SKILL.md index 0bc88d5..9d955ff 100644 --- a/skills/xclawrouter/SKILL.md +++ b/skills/xclawrouter/SKILL.md @@ -19,7 +19,7 @@ metadata: { "openclaw": { "emoji": "🦀", "requires": { "config": ["models.prov # XClawRouter -Smart LLM router that saves 84% on inference costs by routing each request to the cheapest model that can handle it. 76 models across 9 providers (7 free models), all through one wallet. +Smart LLM router that saves 84% on inference costs by routing each request to the cheapest model that can handle it. 78 models across 9 providers (6 free models), all through one wallet. ## Install @@ -55,7 +55,7 @@ Rules handle ~~80% of requests in <1ms. Only ambiguous queries hit the LLM class ## Available Models -76 models including: claude-fable-5, claude-opus-5, claude-sonnet-5, gpt-5.6-terra, gpt-5.6-sol, gpt-5.5, gpt-5.4, gemini-3.1-pro, gemini-3.6-flash, grok-4.5, grok-4.3, glm-5.3, kimi-k3, qwen3.7-max, mimo-v2.5, deepseek-v4-pro, deepseek-chat, and the free models (nemotron-3.5-lightning [default], nemotron-3-nano-30b, laguna-xs-2.1, north-mini-code, nemotron-3-nano-omni-30b-a3b-reasoning [vision], nemotron-3-ultra-550b, llama-3.2-11b-vision [vision]). +78 models including: claude-fable-5, claude-opus-5, claude-sonnet-5, gpt-5.6-terra, gpt-5.6-sol, gpt-5.5, gpt-5.4, gemini-3.1-pro, gemini-3.6-flash, grok-4.5, grok-4.3, glm-5.3, kimi-k3, qwen3.7-max, mimo-v2.5, deepseek-v4-pro, deepseek-chat, and the free models (nemotron-3.5-lightning [default], nemotron-3-nano-30b, laguna-xs-2.1, north-mini-code, nemotron-3-nano-omni-30b-a3b-reasoning [vision], nemotron-3-ultra-550b, llama-3.2-11b-vision [vision]). ## Example Output