Name: Franklin
Author: BlockRun

The Wallet

Software that can spend money.

Claude Code writes code. Cursor writes code. Franklin writes code and buys what it needs to get the job done. It holds USDC on Base or Solana, picks the best model per task, purchases trading data, generates images, pays for web search — all autonomously from one wallet. You set a budget. Franklin runs it.

◆◆◆◆

YOPO

You Only Pay Outcome

Not for access. Not for trying. Only for the work Franklin delivers.

Economic Autonomy

Franklin doesn't just call APIs — it pays for them. Every model call, every data query, every image generation is a real USDC transaction signed from your wallet. No API keys, no billing portals, no accounts.

Budget Caps, On-Chain

Set a spending limit and Franklin enforces it. Every cent is tracked in real-time — per call, per session, per model. Run `franklin panel` for a full dashboard. No surprises.

Base & Solana

Choose your chain at setup. Switch anytime. Same USDC, same models, same capabilities — different rails. Non-custodial: your private keys never leave your machine.

Trading

Buy data, make decisions, execute.

This is where a wallet changes everything. Franklin purchases live market data, runs technical analysis, searches for alpha on X, and drafts trades — all in one session. The wallet isn't just for paying models. It's for buying the data and services that make the models useful.

~ franklin

❯ what's BTC looking like today?
  TradingSignal · BTC $107,842 (+2.3%)  ·  RSI 62
  Fear & Greed: 72 (Greed)  ·  Signal: Bullish
 
❯ find X posts about BTC ETF flows this week
  SearchX · 12 results  ·  $0.003
 
❯ generate a chart of BTC vs ETH YTD
  ImageGen · saved to ./btc-eth-ytd.png  ·  $0.040

Live Market Intelligence

Prices, RSI, MACD, Bollinger bands, Fear & Greed — ask about any token. Franklin buys the data, runs the analysis, and gives you the signal. One prompt, not five browser tabs.

Social Signal Detection

Search X for sentiment, find KOL posts, draft contextual replies. Franklin pays for X/Twitter intelligence via the same wallet it uses for models. No separate X API key.

Research + Image + Search

Exa neural web search, DALL-E image generation, prediction market data from Polymarket and Kalshi. Franklin buys what it needs to answer your question completely.

Smart Router

55+ models. It picks the right one.

No single model is best at everything. Claude writes better code, Gemini handles longer context, DeepSeek costs 20x less for simple tasks. Franklin's Smart Router classifies every request and routes to the optimal model automatically — up to 89% savings vs always using Opus. Multi-provider redundancy means your work never stops because one provider has a bad day.

~ franklin

❯ refactor this auth module to use JWT
  CODING → 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

Automatic Model Selection

You don't pick the model. Franklin classifies your request (coding, reasoning, trading, research) and routes to the best model in under 1ms. 55+ models across 12+ providers.

Adapts to You

Override the router a few times, and it learns. Your routing gets personalized to how you work — not a generic one-size-fits-all algorithm.

Never Goes Down

Claude has an outage? Franklin routes to GPT. GPT is slow? Gemini. Your work doesn't stop because one provider has a bad day.

Learns You

Gets smarter the more you use it.

Claude Code forgets everything between sessions. Franklin doesn't. After each session, it extracts your preferences — language, coding style, model choices, workflow patterns — and injects them into the next one. Combined with the wallet, this means an agent that knows what you like and can pay for what you need.

Automatic, Not Manual

You don't configure preferences in a settings file. Franklin observes how you work and captures patterns automatically. Language, coding style, model preferences, communication tone.

Evolves, Not Fossilizes

Learnings confirmed across sessions gain confidence. Stale preferences decay after 30 days. Your agent stays current with how you work today, not how you worked last month.

One-Click Migration

Coming from Claude Code? `franklin migrate` imports your sessions, MCP configs, project memories, and preferences in seconds. Start where you left off.

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.

Install from npm View on GitHub

The Commons

Apache 2.0

Open Source

You own everything.

With closed-source AI tools, the vendor owns your usage data, your preferences, your history. They change terms, you accept. They raise prices, you pay. They go down, you stop. Franklin is Apache 2.0 and runs on your machine. Your agent, your wallet, your rules.

Your Data

Wallet keys, session history, learnings — everything stays in ~/.blockrun/ on your machine. Zero telemetry, zero crash reporting. Nothing phones home.

Your Models

55+ models from 12+ providers. No single vendor can raise prices, change terms, or cut you off. Switch providers with one command. Your wallet works with all of them.

III

Your Money

Every cent tracked in real-time. Provider cost + 5% — no hidden margins, no bundled fees. You know exactly where your money goes. Always.

Your Code

Apache 2.0 licensed. BlockRun disappears tomorrow? Your wallet still has USDC and your code still runs. Fork it, self-host it, extend it.

Inquiries

Questions &
answers.

Everything you want to know about Franklin, the wallet, and the autonomous economic agent model. Answered plainly.

Claude Code and Cursor write great code — but they can't spend money. They can't buy trading data, purchase API calls, generate images, or pay for web search. Franklin can. It holds a USDC wallet, decides what's worth spending on, and executes. Coding intelligence is table stakes. Economic autonomy is the differentiator.

Franklin holds USDC on Base or Solana. When it needs a model, data, or service, it signs a micropayment and pays for it — automatically, via the x402 protocol. You set a budget, Franklin runs it. Every cent is tracked in real-time. No API keys, no subscriptions, no billing portals. One wallet, everything.

55+ AI models from 12+ providers (Claude, GPT, Gemini, Grok, DeepSeek, Kimi, and more), DALL-E image generation, Exa neural web search, prediction market data from Polymarket and Kalshi, X/Twitter intelligence, and music generation. The Smart Router picks the best model per task automatically — up to 89% savings vs always using Opus.

YOPO — You Only Pay Outcome. Provider cost + 5%, settled per call in USDC. That's the entire pricing model. A simple question: $0.001. A coding session: $0.02-0.10. A full 30-minute session: $0.10-0.50. No subscriptions, no monthly fees, no rate limits. Free NVIDIA models are always available at zero cost — no wallet needed.

Yes. After each session, Franklin extracts your preferences — language, coding style, model choices, workflow patterns — and injects them into the next session. Unlike Claude Code, which forgets everything, Franklin gets smarter over time. Confirmed preferences gain confidence; stale ones decay after 30 days.

Everything stays local in ~/.blockrun/ on your machine. Session history, learnings, wallet keys — nothing phones home. Zero telemetry, zero crash reporting. Your private keys never leave your machine. The code is Apache 2.0 — audit every line.

Yes. Free NVIDIA models are available with unlimited usage — no wallet, no USDC, no setup. Fund your wallet only when you want Franklin to access premium models and paid data sources.

The AI agent with a wallet.