diff --git a/AGENTS.md b/AGENTS.md index bcc04b8a..0f2ae737 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -1,6 +1,6 @@ # Franklin Agent -Open-source AI agent with a wallet. 88 models. Pay per use with BlockRun API account credit or USDC wallets via x402. +Open-source AI agent with a wallet. 90 models. Pay per use with BlockRun API account credit or USDC wallets via x402. ## Commands diff --git a/CLAUDE.md b/CLAUDE.md index 238068c2..b33c8fec 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -14,7 +14,7 @@ Capability pillars: Built on three layers: 1. **x402 micropayment protocol** — HTTP 402 native payments -2. **BlockRun Gateway** — aggregates 88 LLMs + paid APIs (Exa, DALL-E, future Runway/Suno/CoinGecko) +2. **BlockRun Gateway** — aggregates 90 LLMs + paid APIs (Exa, DALL-E, future Runway/Suno/CoinGecko) 3. **Franklin Agent** — this repo, the reference client ## Commands diff --git a/CONTEXT.md b/CONTEXT.md index a2021ce4..1bf849cd 100644 --- a/CONTEXT.md +++ b/CONTEXT.md @@ -19,7 +19,7 @@ The first, unpaid HTTP request whose 402 response carries the payment terms; Fra _Avoid_: Pre-flight, handshake. **BlockRun Gateway**: -The single upstream service Franklin calls for both LLM completions and paid tools (Exa, ImageGen, VideoGen, MusicGen, market data); aggregates 88 models and accepts x402. +The single upstream service Franklin calls for both LLM completions and paid tools (Exa, ImageGen, VideoGen, MusicGen, market data); aggregates 90 models and accepts x402. _Avoid_: API, provider, backend, BlockRun (without "Gateway") when referring to the service. **Per-turn spend cap**: diff --git a/README.md b/README.md index a4afddd1..a4487f10 100644 --- a/README.md +++ b/README.md @@ -45,7 +45,7 @@ ## The pitch in one paragraph -Franklin Agent is an **autonomous economic agent** — an AI that holds a USDC wallet and spends it to get real work done, with **trading as its flagship arena**. It buys live market data, proposes trade plans you approve before a cent moves, pursues long-running goals across sessions, keeps a wallet-bound trading journal, and picks the best model per task from 88 models. You state an outcome and set a budget. Franklin Agent decides what to call, what to pay for, and when to stop. No subscriptions, no seats, no rate limits. +Franklin Agent is an **autonomous economic agent** — an AI that holds a USDC wallet and spends it to get real work done, with **trading as its flagship arena**. It buys live market data, proposes trade plans you approve before a cent moves, pursues long-running goals across sessions, keeps a wallet-bound trading journal, and picks the best model per task from 90 models. You state an outcome and set a budget. Franklin Agent decides what to call, what to pay for, and when to stop. No subscriptions, no seats, no rate limits. Funding it is your choice. Fund a **USDC wallet** and every paid action routes through the [x402](https://x402.org) micropayment protocol, settling on-chain against a wallet only you control — no signup, no account, the wallet is the identity. Or top up a **prepaid balance** at [user.blockrun.ai](https://user.blockrun.ai) and hand Franklin an API key. Same models, same tools, same agent. See [Two ways to pay](#two-ways-to-pay). @@ -387,7 +387,7 @@ Every tool call is itemized. Every token is priced. When the wallet hits zero, F ## Smart Router -**88 models. One decision. Zero guesswork.** +**90 models. One decision. Zero guesswork.** You don't pick models. Franklin picks for you. @@ -467,7 +467,7 @@ No email. No phone. No KYC. Your Solana, Base or Arc address is your account — | -------------------------------------- | ---------------- | ----------------------- | -------------------- | ------------------------------- | | **Spends money for you** | ❌ | ⚠️ you wire payments | ⚠️ trades only | ✅ **USDC wallet or prepaid key** | | **Buys data + APIs + images + search** | ❌ | ⚠️ one key per service | ❌ | ✅ **one wallet pays for all** | -| Picks best model per task | ❌ single-vendor | ⚠️ you pick | ❌ | ✅ **Smart Router, 88 models** | +| Picks best model per task | ❌ single-vendor | ⚠️ you pick | ❌ | ✅ **Smart Router, 90 models** | | **Money moves only on your approval** | — | ⚠️ build it yourself | ❌ runs on rules | ✅ **trade plan, every mode** | | Spend guardrails | — | ⚠️ build it yourself | ⚠️ per-bot limits | ✅ **budget caps + hooks** | | Works when a provider goes down | ❌ | ⚠️ if you code it | ❌ | ✅ **routes to another** | @@ -494,14 +494,14 @@ Ask "what's BTC looking like?" — Franklin fetches live price data, computes RS **🎨 AI image generation** Ask "generate a logo" — Franklin calls DALL-E / GPT Image, saves the result locally, paid from your wallet. -**🧠 88 models via one wallet** +**🧠 90 models via one wallet** Anthropic, OpenAI, Google, xAI, DeepSeek, GLM, Kimi, Minimax, plus a free tier. One wallet, one interface, automatic fallback. **💳 x402 micropayments (YOPO)** HTTP 402 native. Every paid action is a signed USDC micropayment — an EIP-712 authorization on Base and Arc, a signed SPL transfer on Solana. Non-custodial: your keys never leave your machine. YOPO: you pay only for outcomes. **🧠 Learned model router** -Trained on 2M+ real requests. Classifies your task and picks the best model from 88 LLMs. Four profiles (auto/eco/premium/free). Adapts to your usage over time. +Trained on 2M+ real requests. Classifies your task and picks the best model from 90 LLMs. Four profiles (auto/eco/premium/free). Adapts to your usage over time. @@ -581,13 +581,13 @@ Found a vulnerability? Please report it privately — see [SECURITY.md](SECURITY │ Intent → Smart Router → Tool Use → Spend Control → Result │ ├──────────────────────────────────────────────────────────────┤ │ Learned Router │ -│ 2M+ requests · 88 models · category detection · Elo scores │ +│ 2M+ requests · 90 models · category detection · Elo scores │ ├──────────────────────────────────────────────────────────────┤ │ Agent Loop │ │ 60+ tools · Sessions · Compaction · Pricing · Plugin SDK │ ├──────────────────────────────────────────────────────────────┤ │ BlockRun Gateway │ -│ 88 LLMs · CoinGecko · Search · Image APIs · paid services │ +│ 90 LLMs · CoinGecko · Search · Image APIs · paid services │ ├──────────────────────────────────────────────────────────────┤ │ x402 Micropayment Protocol │ │ HTTP 402 · USDC on Solana, Base & Arc · signed payloads │ @@ -636,7 +636,7 @@ src/ ├── stats/ Usage tracking + insights engine ├── ui/ Ink-based terminal UI ├── proxy/ Payment proxy for external tools -├── router/ Learned model router (88 models, Elo scoring) +├── router/ Learned model router (90 models, Elo scoring) ├── wallet/ Wallet management (Base/Arc + Solana) ├── mcp/ MCP server auto-discovery └── commands/ CLI subcommands diff --git a/brand-numbers.json b/brand-numbers.json index a71dfa5a..75f4dc2f 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/adr/0002-blockrun-gateway-as-aggregator.md b/docs/adr/0002-blockrun-gateway-as-aggregator.md index 17866745..0d493e19 100644 --- a/docs/adr/0002-blockrun-gateway-as-aggregator.md +++ b/docs/adr/0002-blockrun-gateway-as-aggregator.md @@ -2,7 +2,7 @@ **Status:** accepted -Franklin makes every LLM and paid-tool call through a single counterparty — the BlockRun Gateway — instead of integrating directly with each model provider, image/video/audio service, search API, and market-data feed. The gateway aggregates 88 models and a small set of paid APIs and accepts x402 uniformly. +Franklin makes every LLM and paid-tool call through a single counterparty — the BlockRun Gateway — instead of integrating directly with each model provider, image/video/audio service, search API, and market-data feed. The gateway aggregates 90 models and a small set of paid APIs and accepts x402 uniformly. ## Considered options diff --git a/docs/anatomy-of-an-economic-agent.md b/docs/anatomy-of-an-economic-agent.md index 34bd8dc3..0e36f0f3 100644 --- a/docs/anatomy-of-an-economic-agent.md +++ b/docs/anatomy-of-an-economic-agent.md @@ -326,7 +326,7 @@ seamlessly. │ signed USDC (HTTP 402) ▼ BlockRun Gateway - 88 models / paid APIs + 90 models / paid APIs │ ▼ User Wallet diff --git a/docs/why-ai-agents-need-a-wallet.md b/docs/why-ai-agents-need-a-wallet.md index f9bfc0c3..c5561a89 100644 --- a/docs/why-ai-agents-need-a-wallet.md +++ b/docs/why-ai-agents-need-a-wallet.md @@ -154,7 +154,7 @@ cheap models because cheapness is now something the agent can agents both learn in real time. **3. Single-vendor failure becomes a one-command swap.** A router -with 88 models across every major provider can route around any +with 90 models across every major provider can route around any single vendor's bad release. The wallet doesn't know or care which model answered — it only pays for the answer that arrived. @@ -175,7 +175,7 @@ filled it. Franklin is the reference implementation of the Economic Agent. It's an AI agent CLI that holds USDC on Base or Solana, routes requests -across 88 models, and settles every paid action in real time via +across 90 models, and settles every paid action in real time via the [x402](https://x402.org) HTTP-402 micropayment protocol. It is Apache-2.0, written in TypeScript, and ships as one npm package.