BlockRun
Get started

Franklin Agent

The AI agent with a wallet. Other coding agents write code; Franklin writes code and spends money to get the job done — picking the best model per task, buying data, generating media, paying for search, all autonomously from one USDC wallet.

Source: github.com/BlockRunAI/Franklin · npm: @blockrun/franklin · Apache-2.0

YOPO — You Only Pay Outcome

Not a subscription (pay for access), not generic pay-per-call (pay for trying). You set an outcome and a budget; Franklin decides what to call, what to pay for, and when to stop. Provider cost + 5%, settled per action in USDC — no monthly fees, no rate limits.

Quick start

1
Install

Requires Node.js 20.19+ (Node 22 LTS recommended).

npm install -g @blockrun/franklin
2
Run — free out of the box

Franklin starts on the free tier (10 reasoning, coding, and vision models), no wallet needed.

franklin
3
Fund a wallet to unlock everything

Add USDC to unlock Claude, GPT, Gemini, Grok, and every paid API (trading data, image/video, web search).

franklin setup base      # or: franklin setup solana
franklin balance         # show address + USDC balance

No install? Run it directly with npx @blockrun/franklin.

How Franklin fits

Franklin is the autonomous agent on top of the BlockRun stack — it uses the same pieces you can use directly:

  • Models & routing — picks the best model per task via ClawRouter's scoring, across 61 chat models.
  • Paid APIs — search, market data, media, RPC, and more, paid per call over x402.
  • One wallet — the wallet is the identity; fund it on Base or Solana (Wallet Setup).

What's next?

ClawRouter

The router Franklin uses — 14-dimension scoring picks the cheapest capable model.

BlockRun MCP

Prefer Claude Code / Cursor? Get the same tools as MCP commands.

Wallet Setup

Fund on Base or Solana and set budgets for autonomous spend.