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.
At a Glance
About Franklin
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 insightsprovides 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.
Community Discussions
Be the first to start a conversation about Franklin
Share your experience with Franklin, ask questions, or help others learn from your insights.
Pricing
Free Tier (NVIDIA Models)
Use Franklin for free with NVIDIA Nemotron and Qwen3 Coder models. No wallet funding required.
- Free NVIDIA models (Qwen3 Coder + Llama 4 Maverick)
- CLI access
- 16+ built-in tools
- Persistent sessions
- Full-text session search
YOPO (Wallet-Funded)
Fund your non-custodial USDC wallet to unlock all 55+ frontier models and paid APIs. Pay provider cost + 5% per action. No monthly fees, no rate limits.
- 55+ LLMs (Anthropic, OpenAI, Google, xAI, DeepSeek, Kimi, Minimax, NVIDIA)
- AI image generation (DALL-E / GPT Image)
- AI video generation
- Paid web search (Exa)
- CoinGecko Pro trading data
- Smart Router with 4 profiles (auto/eco/premium/free)
- Provider cost + 5% per action in USDC
- No monthly fees, no rate limits, no overdraft
- Telegram remote control
- VS Code extension
- x402 micropayment protocol
- Non-custodial wallet (Base + Solana)
Capabilities
Key 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
