diff --git a/README.md b/README.md index e1d43fe..b05a0e2 100644 --- a/README.md +++ b/README.md @@ -6,7 +6,7 @@

Hermes gives your agent a body. ClawRouter gives it a way to pay.
No provider accounts. No per-lab keys. Two rails, one provider block.

-One Hermes provider, 88 models from 12 labs, paid per request —
+One Hermes provider, 90 models from 12 labs, paid per request —
USDC from a local wallet, or account credit on one BlockRun key.

7 models free — no crypto, no balance, no signup required.

@@ -35,7 +35,7 @@ USDC from a local wallet, or account credit on one BlockRun key.

-> **hermes-plugin-clawrouter** wires [NousResearch Hermes](https://github.com/NousResearch/hermes-agent) into [ClawRouter](https://github.com/BlockRunAI/ClawRouter), the open-source LLM router built for autonomous agents. One `pip install` gives Hermes 88 chat models from OpenAI, Anthropic, Google, xAI, DeepSeek, Moonshot, Z.ai, MiniMax, Qwen, NVIDIA and more — plus image, video and web-search tools — behind a single local provider. Requests are scored across 15 dimensions and routed to the cheapest capable model in under 1ms, cutting inference cost by 84% versus pinning Claude Opus 5. Pay however suits you: sign a USDC [x402](https://x402.org) micropayment per call from a local wallet on Solana or Base, **or** sign up at [user.blockrun.ai](https://user.blockrun.ai), top up with a card and use one `brk_…` key. 7 models cost nothing on either rail. MIT licensed. +> **hermes-plugin-clawrouter** wires [NousResearch Hermes](https://github.com/NousResearch/hermes-agent) into [ClawRouter](https://github.com/BlockRunAI/ClawRouter), the open-source LLM router built for autonomous agents. One `pip install` gives Hermes 90 chat models from OpenAI, Anthropic, Google, xAI, DeepSeek, Moonshot, Z.ai, MiniMax, Qwen, NVIDIA and more — plus image, video and web-search tools — behind a single local provider. Requests are scored across 15 dimensions and routed to the cheapest capable model in under 1ms, cutting inference cost by 84% versus pinning Claude Opus 5. Pay however suits you: sign a USDC [x402](https://x402.org) micropayment per call from a local wallet on Solana or Base, **or** sign up at [user.blockrun.ai](https://user.blockrun.ai), top up with a card and use one `brk_…` key. 7 models cost nothing on either rail. MIT licensed. --- @@ -97,7 +97,7 @@ ClawRouter collapses the whole thing into one provider: | | Hermes + lab API keys | Hermes + OpenRouter | Local Ollama | **ClawRouter for Hermes** | | ------------------- | --------------------------- | ------------------- | ------------------ | --------------------------------------------------------------------- | -| **Models** | One provider block per lab | Many | Whatever you host | **88, one block** | +| **Models** | One provider block per lab | Many | Whatever you host | **90, one block** | | **Free tier** | No | Rate-limited | Free but local GPU | **7 models, no signup** | | **Auth** | An API key per lab | Account + API key | None | **Wallet signature, or one BlockRun key** | | **Payment** | Per-lab invoices | Credit card | Your electricity | **USDC per request, or account credit** | @@ -176,7 +176,7 @@ Check either with `/clawrouter account` in chat, or `hermes-clawrouter account` ### Models -The `/model` picker carries a curated, provider-grouped slice of the catalog (small inline keyboards can't render 88 entries); every other model stays routable by full ID. +The `/model` picker carries a curated, provider-grouped slice of the catalog (small inline keyboards can't render 90 entries); every other model stays routable by full ID. | Provider | In the picker | | ----------------- | -------------------------------------------------------------------------------------------------- | @@ -431,7 +431,7 @@ pytest **ClawRouter for NousResearch Hermes** -You're here. 88 models, smart routing, wallet or API key. +You're here. 90 models, smart routing, wallet or API key. `pip install hermes-plugin-clawrouter` @@ -455,7 +455,7 @@ The canonical TypeScript proxy this plugin wraps. Works with any OpenAI-compatib **BlockRun for Claude Code** -Claude Code on 88 models — no Anthropic account, no rate limits, pay per request. +Claude Code on 90 models — no Anthropic account, no rate limits, pay per request. `curl -fsSL https://blockrun.ai/brcc-install | bash` diff --git a/brand-numbers.json b/brand-numbers.json index a71dfa5..75f4dc2 100644 --- a/brand-numbers.json +++ b/brand-numbers.json @@ -2,23 +2,23 @@ "$schema": "https://blockrun.ai/brand/numbers.schema.json", "version": 1, "models": { - "chatVisible": 88, - "totalVisible": 115, + "chatVisible": 90, + "totalVisible": 117, "free": 7, - "freeWithheld": 28, + "freeWithheld": 27, "image": 12, "video": 8, "music": 1, "speech": 5, "soundfx": 1, - "withFallback": 28, - "withFallbackAllEntries": 68 + "withFallback": 29, + "withFallbackAllEntries": 69 }, "clawrouter": { "dimensions": 15, "tiers": 4, "profiles": 4, - "aliases": 276 + "aliases": 295 }, "mcp": { "tools": 19, diff --git a/docs/01-vision-analyze-connection-error-custom-provider.md b/docs/01-vision-analyze-connection-error-custom-provider.md index 095f7db..7818bed 100644 --- a/docs/01-vision-analyze-connection-error-custom-provider.md +++ b/docs/01-vision-analyze-connection-error-custom-provider.md @@ -145,7 +145,7 @@ dominates latency exactly as before. *If you'd rather not run and maintain your own local proxy, a ready-made option is [ClawRouter](https://github.com/BlockRunAI/ClawRouter) — a one-command Hermes plugin -that serves a local OpenAI-compatible endpoint and gives you 88 models — many +that serves a local OpenAI-compatible endpoint and gives you 90 models — many vision-capable — behind it. It's one way to implement Fix 2; the diagnosis above stands regardless of which proxy you use.* diff --git a/docs/02-oauth-vision-provider-falls-back-to-auto.md b/docs/02-oauth-vision-provider-falls-back-to-auto.md index 33b82cb..4eee442 100644 --- a/docs/02-oauth-vision-provider-falls-back-to-auto.md +++ b/docs/02-oauth-vision-provider-falls-back-to-auto.md @@ -122,7 +122,7 @@ avoiding the broken OAuth branch. *If you'd rather not assemble and maintain your own proxy, [ClawRouter](https://github.com/BlockRunAI/ClawRouter) is a ready-made Hermes plugin -that exposes 88 models (MiniMax included) as a single local `api_key` provider — one +that exposes 90 models (MiniMax included) as a single local `api_key` provider — one way to implement the robust setup above. The diagnosis holds regardless of which proxy you use; track the upstream fix in [hermes-agent#38685](https://github.com/NousResearch/hermes-agent/issues/38685).* diff --git a/docs/03-one-endpoint-gpt-claude-gemini-deepseek.md b/docs/03-one-endpoint-gpt-claude-gemini-deepseek.md index d064374..9525ea8 100644 --- a/docs/03-one-endpoint-gpt-claude-gemini-deepseek.md +++ b/docs/03-one-endpoint-gpt-claude-gemini-deepseek.md @@ -1,6 +1,6 @@ --- title: "Run GPT-5, Claude, Gemini and DeepSeek in Nous Hermes From One Endpoint" -description: "Stop wiring a separate provider, key and OAuth flow for every model in Hermes Agent. Point Hermes at one OpenAI-compatible gateway and switch between 88 models from the /model picker." +description: "Stop wiring a separate provider, key and OAuth flow for every model in Hermes Agent. Point Hermes at one OpenAI-compatible gateway and switch between 90 models from the /model picker." keywords: - hermes multiple llm providers - hermes one endpoint all models @@ -77,7 +77,7 @@ blockrun/minimax/minimax-m3 blockrun/moonshot/kimi-k3 blockrun/deepseek/deepseek-v4-pro blockrun/free/nemotron-3.5-lightning -…72 curated entries (88 models via the gateway) +…72 curated entries (90 models via the gateway) ``` Set the model to `blockrun/auto` and the gateway's router picks a model per request @@ -161,11 +161,11 @@ If you prefer a traditional key-based aggregator, the same one-endpoint config pattern works — you just lose the non-custodial/pay-per-use property. **How many models are available?** -88 across OpenAI, Anthropic, Google, DeepSeek, Moonshot/Kimi, xAI/Grok, MiniMax, +90 across OpenAI, Anthropic, Google, DeepSeek, Moonshot/Kimi, xAI/Grok, MiniMax, Z.AI/GLM, Qwen, NVIDIA-hosted open models, and more — plus a few free tiers. --- *Last reviewed against Hermes Agent v0.18.x. The single-endpoint pattern is provider- agnostic; ClawRouter is the implementation that adds non-custodial pay-per-call -billing and 88 models behind the one URL.* +billing and 90 models behind the one URL.* diff --git a/docs/04-pay-per-call-llm-no-api-keys-hermes.md b/docs/04-pay-per-call-llm-no-api-keys-hermes.md index 65c531d..8e66979 100644 --- a/docs/04-pay-per-call-llm-no-api-keys-hermes.md +++ b/docs/04-pay-per-call-llm-no-api-keys-hermes.md @@ -1,6 +1,6 @@ --- title: "Pay-Per-Call LLM Access for Hermes Agents — No API Keys, No Subscriptions" -description: "Funding and rotating an API key for every model your Hermes agent uses is a chore and a liability. Here's how to give Hermes keyless, pay-per-call access to 88 models with USDC micropayments from a wallet you control." +description: "Funding and rotating an API key for every model your Hermes agent uses is a chore and a liability. Here's how to give Hermes keyless, pay-per-call access to 90 models with USDC micropayments from a wallet you control." keywords: - hermes no api key llm - hermes pay per use llm @@ -49,7 +49,7 @@ Applied to LLM access, that means: [ClawRouter](https://github.com/BlockRunAI/ClawRouter) implements this for Hermes. It runs a local OpenAI-compatible gateway that signs an x402 payment for each upstream -call and routes to 88 models: +call and routes to 90 models: ```bash curl -fsSL https://raw.githubusercontent.com/BlockRunAI/ClawRouter-Hermes/main/scripts/install.sh | bash diff --git a/src/clawrouter_hermes/skills/clawrouter/SKILL.md b/src/clawrouter_hermes/skills/clawrouter/SKILL.md index 342f350..bed0019 100644 --- a/src/clawrouter_hermes/skills/clawrouter/SKILL.md +++ b/src/clawrouter_hermes/skills/clawrouter/SKILL.md @@ -1,6 +1,6 @@ --- name: clawrouter -description: Hosted-gateway LLM router — save 87% on inference costs. A local proxy that forwards each request to the blockrun.ai gateway, which routes to the cheapest capable model across 88 models from OpenAI, Anthropic, Google, DeepSeek, xAI, NVIDIA, and more. 7 free models included. Also exposes realtime market data (global stocks, crypto, FX, commodities), Twitter/X intelligence, and prediction-market data across Polymarket, Kalshi, Limitless, Opinion, Predict.Fun, dFlow + UMA oracle resolution + wallet identity & clustering as built-in agent tools. Not a local-inference tool — prompts are sent to the blockrun.ai gateway. +description: Hosted-gateway LLM router — save 87% on inference costs. A local proxy that forwards each request to the blockrun.ai gateway, which routes to the cheapest capable model across 90 models from OpenAI, Anthropic, Google, DeepSeek, xAI, NVIDIA, and more. 7 free models included. Also exposes realtime market data (global stocks, crypto, FX, commodities), Twitter/X intelligence, and prediction-market data across Polymarket, Kalshi, Limitless, Opinion, Predict.Fun, dFlow + UMA oracle resolution + wallet identity & clustering as built-in agent tools. Not a local-inference tool — prompts are sent to the blockrun.ai gateway. triggers: - "clawrouter" - "claw router" @@ -65,7 +65,7 @@ basics through common OS package managers when available. Then in a Hermes chat session: -- Pick model `blockrun/auto` for smart routing across 88 models. +- Pick model `blockrun/auto` for smart routing across 90 models. - `/clawrouter account` — which rail you're paying on (wallet or API key) - `/clawrouter wallet` — show address + USDC balance (Solana and Base) - `/clawrouter stats` — proxy usage @@ -100,7 +100,7 @@ Wallet lives at `~/.openclaw/blockrun/mnemonic` (shared with the upstream TS CLI --- -Hosted-gateway LLM router that saves 84% on inference costs by forwarding each request to the blockrun.ai gateway, which picks the cheapest model capable of handling it across 88 models from 12 providers (7 free models). Billing flows through one credential — a local USDC wallet, or one BlockRun API key from https://user.blockrun.ai. Either way you do not hold provider API keys. +Hosted-gateway LLM router that saves 84% on inference costs by forwarding each request to the blockrun.ai gateway, which picks the cheapest model capable of handling it across 90 models from 12 providers (7 free models). Billing flows through one credential — a local USDC wallet, or one BlockRun API key from https://user.blockrun.ai. Either way you do not hold provider API keys. **This is not a local-inference tool.** ClawRouter is a thin local proxy. Your prompts are sent over HTTPS to the blockrun.ai gateway for model execution. If your workload requires inference that never leaves your machine, use a local runtime like Ollama — ClawRouter is not the right tool for that use case. @@ -192,7 +192,7 @@ Rules handle ~80% of requests in <1ms. Only ambiguous queries hit the LLM classi ## Available Models -88 models including: claude-fable-5.1, claude-fable-5, claude-opus-5.5, claude-opus-5, claude-opus-4.8, claude-opus-4.7, claude-sonnet-5.5, claude-sonnet-5, claude-sonnet-4.6, gpt-6-astra, gpt-6-sol, gpt-6.1-sol, gpt-6-luna, gpt-5.6-sol, gpt-5.6-terra, gpt-5.6-luna, gpt-5.6-terra-pro, gpt-5.6-sol-pro, gpt-5.6-luna-pro, gpt-5.5, gpt-5.4, gpt-5.1, gemini-4-argon, gemini-3.1-pro, gemini-3.5-flash, grok-4.7, grok-4.6, grok-4.5, grok-4.3, grok-build-0.1, deepseek-v4-pro, deepseek-v4-flash-vision-exp [vision], deepseek-v4.1-flash, deepseek-chat, glm-5.2, kimi-k3, minimax-m3, qwen3.8-max, qwen3.7-max, mistral-large-4 [vision], hy4-preview, and the curated free models (nemotron-3.5-lightning, 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]). +90 models including: claude-fable-5.1, claude-fable-5, claude-opus-5.5, claude-opus-5, claude-opus-4.8, claude-opus-4.7, claude-sonnet-5.5, claude-sonnet-5, claude-sonnet-4.6, gpt-6-astra, gpt-6-sol, gpt-6.1-sol, gpt-6-luna, gpt-5.6-sol, gpt-5.6-terra, gpt-5.6-luna, gpt-5.6-terra-pro, gpt-5.6-sol-pro, gpt-5.6-luna-pro, gpt-5.5, gpt-5.4, gpt-5.1, gemini-4-argon, gemini-3.1-pro, gemini-3.5-flash, grok-4.7, grok-4.6, grok-4.5, grok-4.3, grok-build-0.1, deepseek-v4-pro, deepseek-v4-flash-vision-exp [vision], deepseek-v4.1-flash, deepseek-chat, glm-5.2, kimi-k3, minimax-m3, qwen3.8-max, qwen3.7-max, mistral-large-4 [vision], hy4-preview, and the curated free models (nemotron-3.5-lightning, 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]). ## Model Prices — Look Them Up Live