The AI agent with a wallet.
While others generate text, Franklin deploys capital. One wallet, every model, every paid API. Budgeted execution in USDC. No subscriptions. No API keys. No account.
npm install -g @blockrun/franklinNo API keys. No setup. Just USDC and every model.
One wallet unlocks 55+ models from every provider — forever. No API key management, no billing portals, no per-provider accounts. Fund with USDC and start using Claude, GPT, Gemini, Grok, DeepSeek, and more. Every cent is tracked, every call is logged.
x402 Native Payments
HTTP 402 Payment Required, handled automatically. Franklin signs payments from your wallet on every API call. No middleware, no billing portals.
Dual Chain Support
Base (EVM) and Solana wallets built in. Choose your chain at setup. Switch anytime. Same USDC, same models, different rails.
Real-Time Cost Tracking
Every call shows cost in the terminal. Session totals, daily trends, model breakdowns. Run `franklin panel` for a full dashboard.
You don't pick models. Franklin picks for you.
The Smart Router classifies every request — coding, trading, reasoning, research — and selects the model with the best quality-to-cost ratio. Every response shows which model was chosen, why, and how much you saved.
❯ refactor this auth module to use JWTCODING → kimi-k2.5 · saved 84%❯ what's the BTC outlook for the week?TRADING → grok-4-1-fast-reasoning · saved 95%❯ prove that this algorithm is O(n log n)REASONING → claude-sonnet-4.6
Four Routing Profiles
Auto (best quality-to-cost ratio), Eco (cheapest possible), Premium (most capable), Free (NVIDIA models only). Switch anytime — the router adapts instantly.
Learns From Your Usage
If you keep retrying a model for coding tasks, Franklin adapts and picks a better one next time. Your router gets smarter the more you use it.
Per-Session Cost Breakdown
Run `/cost` to see exactly where your USDC went — model by model, category by category, with request counts and totals. No surprises.
Franklin learns your preferences. Gets smarter every session.
Per-user self-evolution inspired by NousResearch. After each session, Franklin extracts your preferences — language, coding style, model choices, workflow patterns — and injects them into the next session. All data stays local.
Automatic Preference Extraction
A cheap model analyzes your session trace after you exit. Language preference, coding conventions, communication style — all captured automatically.
Confidence-Based Decay
Learnings confirmed multiple times get higher confidence. Stale preferences decay after 30 days. Your agent stays current, not fossilized.
One-Click Migration
Coming from Claude Code? `franklin migrate` imports your sessions, MCP configs, project memories, and preferences in seconds.
Every premium API. One wallet to access them all.
Trading data, image generation, web search, social automation — Franklin pays for premium tools and data the same way it pays for models. One USDC wallet replaces dozens of API keys and billing accounts.
❯ what's BTC looking like today?TradingSignal · live price, RSI, MACD, Bollinger❯ generate a hero image for my landing pageImageGen · DALL-E via x402 · $0.040❯ find X posts about ai agents and draft repliesSearchX · 8 results found · 3 drafts ready
Trading & Market Data
Live prices, RSI, MACD, Bollinger bands, Fear & Greed — ask about any token. CoinGecko data computed locally, no separate API key needed.
Image Generation & Search
DALL-E, web search, research tools — all paid through x402 micropayments from the same USDC wallet. One balance covers everything.
Social Automation
Search X for relevant posts, draft contextual replies, post with your confirmation. Same wallet, same agent, no X API key required.
Get Started
Up and running in 60 seconds.
Install
One npm command. Node 20+. Works on macOS, Linux, and WSL. No Docker, no server, no config files.
Create Wallet
Run franklin setup base (or solana). A USDC wallet is auto-generated. Send USDC to fund it — or skip and use free models.
State an Outcome
Run franklin --trust. Write code, research markets, draft social posts, generate images — Franklin picks the best model and pays per action from your wallet.
Watch It Learn
Franklin learns your preferences across sessions. Run /learnings to see what it knows. Coming from Claude Code? Run franklin migrate to import everything.
Open Source
Open source, always.
Franklin is fully open source under Apache 2.0. Audit every line, self-host, fork, extend. Your agent, your wallet, your rules.
Runs Locally
Your machine, your data. Wallet keys, session history, learnings — everything stays in ~/.blockrun/. Nothing phones home.
No Vendor Lock-in
55+ models from every provider. Switch between Claude, GPT, Gemini, DeepSeek, or free models with one command. Your wallet works with all of them.
Every Cent Tracked
Real-time cost per call in the terminal. Daily trends, model breakdowns, savings vs Opus. Run `franklin panel` for a full localhost dashboard.
Community Built
Apache 2.0 licensed. Plugin SDK for custom workflows. MCP-native for extensibility. Contribute tools, models, or integrations.
FAQ