# Franklin

> An open-source AI agent with a built-in USDC wallet that autonomously spends money to complete tasks — code, research, trading, image generation — using 55+ models via a smart router.

Franklin is an open-source, wallet-native AI agent that combines autonomous task execution with real spending power. Unlike traditional coding agents, Franklin holds a USDC wallet, selects the best model per task from 55+ providers, and pays for APIs, data, images, and web search — all autonomously. Built in TypeScript under the Apache 2.0 license, it ships as a single npm package with zero signup, zero credit card, and zero KYC required.

Franklin introduces the **YOPO (You Only Pay Outcome)** pricing model: you pay provider cost + 5% per action settled in USDC, with no monthly fees, no rate limits, and no overdraft — your wallet balance is the hard cap. Every paid action routes through the x402 micropayment protocol and settles against your own non-custodial wallet on Base or Solana.

Key features include:

- **Smart Router** — Trained on 2M+ real requests, the router classifies every task (coding, trading, reasoning, research) and selects the optimal model from 55+ LLMs including Anthropic, OpenAI, Google, xAI, DeepSeek, and NVIDIA free-tier models. Four profiles: auto, eco, premium, and free.
- **YOPO Micropayments** — HTTP 402 native payments via EIP-712 signed USDC micropayments. Non-custodial; your keys never leave your machine. No subscriptions, no rate limits, no overdraft.
- **16+ Built-in Tools** — Read, Write, Edit, Bash, Glob, Grep, WebFetch, WebSearch, Task, ImageGen, VideoGen, MemoryRecall, AskUser, SubAgent, TradingSignal, TradingMarket, TradingPortfolio, and more.
- **Trading Signals** — Fetches live crypto price data and computes RSI, MACD, Bollinger Bands, and volatility locally via CoinGecko. No API key needed.
- **AI Image & Video Generation** — Calls DALL-E / GPT Image directly from the CLI or VS Code extension, paid from your wallet.
- **Persistent Sessions** — Every turn is streamed to disk with metadata. Resume any session by ID; survives crashes and reboots.
- **Telegram Remote Control** — Run Franklin on an always-on machine and drive it from your phone via a Telegram bot, with session resumption and slash commands.
- **VS Code Extension** — The same agent ships as a VS Code extension with a chat panel, model picker, wallet balance display, and inline diff cards.
- **Plugin SDK + MCP** — Extend Franklin with new workflow verticals via the plugin SDK or discover external tools automatically through MCP server auto-discovery.
- **Cost Insights** — `franklin insights` provides spend breakdowns, trends, and projections per model and task category.
- **Free Tier** — Start with zero dollars using free NVIDIA models (Qwen3 Coder + Llama 4 Maverick) with no wallet funding required.

## Features
- USDC wallet-native economic execution
- YOPO (You Only Pay Outcome) pricing model
- Smart Router across 55+ LLMs
- 16+ built-in tools (Read, Write, Edit, Bash, WebSearch, ImageGen, VideoGen, TradingSignal, etc.)
- x402 micropayment protocol integration
- Trading signals with RSI, MACD, Bollinger Bands
- AI image and video generation from CLI
- Persistent sessions with crash recovery
- Full-text session search
- Telegram remote control
- VS Code extension
- Plugin SDK and MCP server auto-discovery
- Anthropic prompt caching for cost reduction
- Per-session cost insights and spend breakdowns
- Free NVIDIA model tier (no wallet required)
- Multi-chain wallet support (Base + Solana)
- Learned model router adapts to usage over time

## Integrations
Anthropic Claude (Sonnet, Opus), OpenAI GPT / DALL-E, Google Gemini, xAI Grok, DeepSeek, NVIDIA Nemotron / Qwen3 Coder, Kimi, Minimax, CoinGecko, Exa neural web search, Telegram, VS Code, Base (blockchain), Solana (blockchain), MCP servers, x402 micropayment protocol

## Platforms
MACOS, LINUX, WEB, API, VSC_EXTENSION, DEVELOPER_SDK, CLI

## Pricing
Open Source, Free tier available

## Version
v3.15.68

## Links
- Website: https://franklin.run
- Documentation: https://github.com/BlockRunAI/Franklin/blob/main/docs/plugin-sdk.md
- Repository: https://github.com/BlockRunAI/Franklin
- EveryDev.ai: https://www.everydev.ai/tools/franklin-blockrun