The Autonomous Economic Agent

The AI agent
with a wallet.

Other agents write code. Franklin writes code and spends money to get it done — models, data, images, search. You set the budget. It runs it.

Open source · MIT licensed · Built by the BlockRun team. Trusted by developers shipping autonomous agents on Base and Solana.

Built on USDC · Base · Solana · x402 · routes across 55+ frontier models from Anthropic, OpenAI, Google, xAI, DeepSeek and Moonshot.

See it run

Five tasks. Five runs. Five receipts.

A real Franklin Agent session. Each command spawns calls to a routed model, pays per call in USDC, and prints the cost.

~ franklin --trustLIVE
claude-opus-4.6·$4.80 USDC·esc to abort
Four Chapters

What a wallet
changes.

Coding intelligence is table stakes. The difference is purchasing power — and the quiet discipline that comes with an agent that must balance its own books.

Chapter 01
The Wallet

Software that can spend money.

Franklin holds USDC on Base or Solana. When it needs a model, a data feed, or an image — it signs a payment and takes it. Non-custodial. Your keys stay on your machine. You set a cap; it enforces it.

USDC · BaseNon-Custodial
24.37USDC
0x8F3a · c92D · 1E4b · f70A · · · autonomy = $0.50 / session cap
▸ claude-sonnet-4.6 · refactor auth.ts−$0.041
▸ coingecko · BTC/USD signal−$0.002
▸ dall·e 3 · hero logo, 1024²−$0.040
▸ exa · neural web search (4)−$0.012
▸ kimi-k2.6 · context compaction−$0.004
◆ x402 · EIP-712Session: f3a · 18s
Chapter 02
Trading

Buy data. Read the tape. Decide.

Ask “how’s BTC looking?” and Franklin purchases live prices, computes RSI, MACD, Bollinger, and volatility locally, then returns a signal. One prompt. No five browser tabs, no API key spaghetti.

◆ BTC№ 04.20.26
Signal Report · Bitcoin
30-day window · bullish
$71,056▲ 2.3% · 24hMCAP $1.42T · VOL $29.6B
RSI (14)
53.2
neutral
MACD
339.21
bullish cross
Bollinger
mid-band
$64.5k — $73.8k
Volatility
35.3%
annualized
Bullish Momentum

Entry $65,000 · stop $63,200 (−2.8%) · risk $27.69 · target $70k · R/R 1:2.8 ✓

Authored · Franklin / Opus 4.6Cost · $0.031 USDC
Chapter 03
Smart Router

55+ models. It picks. You save.

No single model is best at everything. The router classifies every request and routes in under a millisecond. Trained on 2M+ real requests, continuously scored by Elo, adapts to your overrides. Up to 89% savings vs. always-Opus.

Session Ledger · /cost23 reqs · 4 categories · saved 67%
refactor src/auth.ts to use the new jwt helper
▸ CODING
kimi-k2.6
$0.0023
↓ 84%
what's the BTC outlook for the week?
▸ TRADING
grok-4-1-fast
$0.0008
↓ 95%
prove this algorithm is O(n log n)
▸ REASONING
claude-sonnet-4.6
$0.0312
priced
compare the top 5 AI agent pricing models
▸ RESEARCH
gemini-2.5-flash
$0.0012
↓ 91%
Session total · $0.0847Saved vs. Opus-only · $0.174
Chapter 04
Learns You

Gets smarter each session.

Claude Code forgets between runs. Franklin extracts preferences — language, style, model choices, workflow — and injects them into the next session. Confirmed patterns gain confidence. Stale ones decay at 30 days.

Learnings /learnings7 confirmed · 2 decaying
Primary Language
TypeScript · strict mode
confirmed · 42 sess
Commit Style
Conventional · no scope
confirmed · 38 sess
Preferred Coder
kimi-k2.6 over sonnet for refactors
confirmed · 19 sess
Test Runner
vitest · watch mode
confirmed · 24 sess
Reply Tone
terse · no apologies
confirmed · 51 sess
Trading Pair Focus
BTC, ETH, SOL
decaying · 6d silent
Pricing · Install · Fund

Pay for the outcome,
nothing else.

◆ HTTP◆ x402◆ EIP-712◆ USDC
402
You Only Pay Outcome · YOPO
Provider cost + 5%, signed per action.

No subscription (you don’t pay for access). No pay-per-call (you don’t pay for failed tries). The wallet balance is the hard cap. When it hits zero, Franklin stops. That’s the whole pricing model.

01

Install

One npm command. Node 20+. macOS, Linux, WSL.

npm i -g @blockrun/franklin
02

Run free

Free NVIDIA Nemotron & Qwen3 Coder out of the box. No wallet required.

franklin
03

Fund ($5 is plenty)

Generate a Base or Solana wallet. Send USDC. Unlock every frontier model.

franklin setup base
04

State an outcome

Code, trade, research, generate — Franklin picks, pays, reports, stops.

franklin --trust
Slash Commands · 18 built-in
/model [name]
Interactive picker or direct switch
/plan · /execute
Read-only planning, then run
/ultrathink <q>
Deep reasoning for hard problems
/compact
Structured context compression
/search <q>
Search the codebase
/session-search
Full-text across past sessions
/history · /resume
Inspect or restore any session
/commit · /push · /pr
Git workflow helpers
/review · /fix · /test
One-shot review, bugfix, tests
/cost · /wallet
Session spend + address + balance
/insights [--days N]
Spend breakdowns and trends
/learnings
What Franklin has picked up
The Ledger

In a table,
to be plain.

AI products sell access. Subscriptions hand you monthly guilt and rate limits. Pay-per-call bills you for every failed try. Franklin settles for the outcome — once, in USDC.

Subscription SaaSPay-per-call APIFranklin — YOPO
You pay forAccess, whether used or notEvery attempt, including dead-endsThe outcome. Once.
Monthly fee$20 — $200$0, plus usage$0. Pay only what you spend.
Rate limitsYes. Tightens when you need it most.Per-key quotas, tiersNone. Wallet balance is the only cap.
IdentityEmail + credit cardVendor account, API keys per modelA wallet. No email, no KYC.
Model choiceSingle vendorYou juggle 12 keys55+ models via one wallet · router decides.
Provider outageYou’re stopped.You’re stopped.Routes to the next provider.
Overdraft riskSilent auto-renewUnbounded bill at month endNone. Wallet empty ⇒ Franklin stops.
SourceClosedClosed SDKApache 2.0 · local-first.
The Commons · Apache 2.0

You own
everything.

Your data
~/.blockrun/
Your wallet
Private keys · local
Your models
55+ · switch in 1 cmd
Your license
Apache 2.0
Your uptime
Fork it. Self-host.

With closed 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. Wallet keys, session history, learnings — everything sits in ~/.blockrun/. Zero telemetry. Nothing phones home.

If BlockRun disappears tomorrow, your USDC stays in your wallet and your agent still runs. That’s the point.

Read every line: the entire agent loop, the 16 built-in tools, the plugin SDK, the x402 client, the router — it’s all in the repo. Audit it, fork it, ship your own vertical.

Dispatches

From the
bench.

Notes on multi-model coding agents, wallet-native AI, and frontier models for developers without global credit cards.

All posts →
Inquiries

Questions,
answered.

The autonomous economic agent model in plain English. No hedging.

They write great code. They can't spend money. They can't buy trading data, purchase API calls, pay for image generation, or settle a web-search bill. Franklin can — because it holds a USDC wallet and pays per action via x402. Coding intelligence is table stakes; economic autonomy is the category.

Franklin holds USDC on Base or Solana. When it needs a model, a data feed, or a service, it signs an EIP-712 micropayment and pays. You set a budget; Franklin enforces it. Every cent is tracked in real-time. No subscriptions, no API keys, no billing portals.

55+ AI models (Claude, GPT, Gemini, Grok, DeepSeek, Kimi, etc.), image gen (DALL·E, Nano Banana, Grok Imagine), video gen, Exa neural web search, prediction-market data (Polymarket, Kalshi), X/Twitter intelligence, music gen. The Smart Router picks the best model per task — up to 89% savings vs always-Opus.

YOPO — You Only Pay Outcome. Provider cost + 5%, settled per call in USDC. Simple question: ~$0.001. Coding session: $0.02–$0.10. 30-minute deep 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 preferences — language, style, model choices, workflow — and injects them into the next run. Confirmed preferences gain confidence. Stale ones decay at 30 days. Run /learnings to see what it knows.

Everything stays local in ~/.blockrun/. 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 (Nemotron, Qwen3 Coder) work with no wallet, no USDC, no signup. Fund the wallet only when you want Sonnet, Opus, GPT, Gemini, Grok, or paid tools.

Fast finality, negligible fees, mature USDC support, and a real x402 ecosystem on both. You pick at setup and can switch anytime. Same wallet UX, same models, different rails.

Franklin Agent

Run an Economic Agent.
Stop watching agents fail at money.

Install Franklin Agent