Franklin Agent — The AI agent with a wallet. Spends USDC autonomously to get real work done. Pay per action, no subscriptions.
How to install franklin?
blockrunai/franklin
$git clone https://github.com/blockrunai/franklinInstalls into the current project.
›Prefer a prompt? Paste this to your agent
Install franklin by running `git clone https://github.com/blockrunai/franklin`, then use it for the current task and follow its documentation at https://github.com/blockrunai/franklin.
README.md
| 1 | <div align="center"> |
| 2 | |
| 3 | <br> |
| 4 | |
| 5 | <img src="assets/terminal-banner.png" alt="Franklin Agent terminal" width="680"> |
| 6 | |
| 7 | <br><br> |
| 8 | |
| 9 | <h1>Franklin Agent</h1> |
| 10 | <h3>The AI agent with a wallet.</h3> |
| 11 | |
| 12 | <p> |
| 13 | Other agents just talk. Franklin Agent holds your USDC <em>and puts it to work</em> —<br> |
| 14 | trading, research, and autonomous tasks with real budgets, real guardrails, real outcomes.<br> |
| 15 | One wallet. Every model. Every paid API. Pay only for outcomes — not subscriptions. |
| 16 | </p> |
| 17 | |
| 18 | <p> |
| 19 | <a href="https://npmjs.com/package/@blockrun/franklin"><img src="https://img.shields.io/npm/v/@blockrun/franklin.svg?style=flat-square&color=FFD700&label=npm" alt="npm"></a> |
| 20 | <a href="https://npmjs.com/package/@blockrun/franklin"><img src="https://img.shields.io/npm/dm/@blockrun/franklin.svg?style=flat-square&color=10B981&label=downloads" alt="downloads"></a> |
| 21 | <a href="https://github.com/BlockRunAI/Franklin/stargazers"><img src="https://img.shields.io/github/stars/BlockRunAI/Franklin?style=flat-square&color=FFD700&label=stars" alt="stars"></a> |
| 22 | <a href="LICENSE"><img src="https://img.shields.io/badge/license-Apache_2.0-blue?style=flat-square" alt="license"></a> |
| 23 | <a href="https://www.typescriptlang.org/"><img src="https://img.shields.io/badge/TypeScript-strict-3178C6?style=flat-square&logo=typescript&logoColor=white" alt="TypeScript"></a> |
| 24 | <a href="https://nodejs.org/"><img src="https://img.shields.io/badge/Node-%E2%89%A520-339933?style=flat-square&logo=node.js&logoColor=white" alt="Node"></a> |
| 25 | <a href="https://x402.org"><img src="https://img.shields.io/badge/x402-native-10B981?style=flat-square" alt="x402"></a> |
| 26 | <a href="https://t.me/blockrunAI"><img src="https://img.shields.io/badge/chat-telegram-26A5E4?style=flat-square&logo=telegram&logoColor=white" alt="telegram"></a> |
| 27 | </p> |
| 28 | |
| 29 | <p> |
| 30 | <a href="#quick-start">Quick start</a> · |
| 31 | <a href="#yopo">YOPO</a> · |
| 32 | <a href="#a-new-category">Category</a> · |
| 33 | <a href="#what-franklin-can-execute">What it does</a> · |
| 34 | <a href="#smart-router">Smart Router</a> · |
| 35 | <a href="#the-comparison">Comparison</a> · |
| 36 | <a href="#how-it-works">Architecture</a> · |
| 37 | <a href="#community">Community</a> |
| 38 | </p> |
| 39 | |
| 40 | </div> |
| 41 | |
| 42 | --- |
| 43 | |
| 44 | ## The pitch in one paragraph |
| 45 | |
| 46 | 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 55+ providers. You state an outcome and set a budget. Franklin Agent decides what to call, what to pay for, and when to stop. Every paid action routes through the [x402](https://x402.org) micropayment protocol and settles against your own wallet. No subscriptions. No API keys. No account. The wallet is the identity. |
| 47 | |
| 48 | Built by the [BlockRun](https://blockrun.ai) team. Apache-2.0. TypeScript. Ships as one npm package. |
| 49 | |
| 50 | > **YOPO — You Only Pay Outcome** |
| 51 | > |
| 52 | > Not a subscription (pay for access). Not a generic pay-per-call (pay for trying). |
| 53 | > You pay only for the work Franklin Agent delivers. Provider cost + 5%, settled per action |
| 54 | > in USDC. No monthly fees. No rate limits. No overdraft. |
| 55 | |
| 56 | --- |
| 57 | |
| 58 | ## Quick start |
| 59 | |
| 60 | > **Requires Node.js 20.19+ (Node 22 LTS recommended).** Check with `node -v`. Older Node crashes at startup with `ERR_REQUIRE_ESM`. |
| 61 | |
| 62 | ```bash |
| 63 | # 1. Install |
| 64 | npm install -g @blockrun/franklin |
| 65 | |
| 66 | # 2. Run (free — uses NVIDIA Nemotron & Qwen3 Coder out of the box) |
| 67 | franklin |
| 68 | |
| 69 | # 3. (optional) Fund a wallet to unlock Sonnet, Opus, GPT, Gemini, Grok, + paid APIs |
| 70 | franklin setup base # or: franklin setup solana |
| 71 | franklin balance # show address + USDC balance |
| 72 | ``` |
| 73 | |
| 74 | That's it. Zero signup, zero credit card, zero phone verification. Send **$5 of USDC** to the wallet and you've unlocked every frontier model and every paid tool in the BlockRun gateway. |
| 75 | |
| 76 | **No global install? Just run it directly** — no permissions, no `-g` |
Related
6 picksType
- financetoolkit200+ transparent financial metrics calculated from raw statements, not third-party endpoints.Jul 2026
- mcp-serverAn MCP server for interacting with the Financial Datasets stock market API.Jun 2025
- mcp-serverPython MCP server for local interactions with the QuantConnect API.May 2026
- alpaca-mcp-serverAlpaca Trading API integration for Model Context Protocol (MCP). V2 generates 60+ tools directly from Alpaca's OpenAPI specs using FastMCP.Jul 2026
- finopsmcpSee where your cloud and AI bills go, and spend less. Local-first, in your terminal or editor.Jul 2026
- xero-mcp-serverMCP server implementation for Xero integrationJun 2026
