◆Franklin/Docs

FAQ

Frequently asked questions about models, payments, privacy, and more.

Use a BlockRun API key for account billing: account setup guide. Register at user.blockrun.ai, create a key and add credits. Account mode needs no payment wallet; wallet billing supports Solana first, then Base.

What models does Franklin support?

Franklin supports 70+ models from 15+ providers, including OpenAI (GPT-6 Astra, GPT-6 Sol, GPT-6 Luna, GPT-5.6 Sol, GPT-5.5, GPT-5.3 Codex, o3), Anthropic (Claude Fable 5.1, Opus 5.5, Sonnet 5.5, Haiku 4.5), Google (Gemini 3.1 Pro, Gemini 3.6 Flash), xAI (Grok 4.7, Grok 4.6, Grok Imagine), DeepSeek (V4 Pro, V4 Flash), Moonshot (Kimi K3), Qwen (Qwen3.7 Max), MiniMax (M3), Z.AI (GLM-5.3), and a free tier hosted by NVIDIA, Cohere and Poolside. Run franklin models to see the full list with pricing.

How does payment work?

Account API calls use BlockRun account credits. Wallet calls use x402 on Solana or Base. The account dashboard is authoritative for account usage; local cost totals and budget limits are estimates.

bash
# Set up a wallet
franklin setup solana

# Check your balance
franklin balance

Is my data private?

Yes. Everything is stored locally in ~/.blockrun/on your machine. Session history, learnings, brain memory, wallet keys, and configuration never leave your computer. API calls go directly to model providers — Franklin does not proxy your prompts through any intermediary.

No telemetry

Franklin does not collect telemetry, usage analytics, or crash reports. Your data stays on your machine.

Can I use it for free?

Yes. Franklin includes a free tier of seven models(Nemotron 3 Nano 30B, Nemotron 3.5 Lightning, Nemotron 3 Nano Omni, Nemotron 3 Ultra 550B, Llama 3.2 11B Vision, Cohere North Mini Code, Poolside Laguna XS 2.1) with unlimited usage and zero setup. No wallet, no USDC, no API keys required. Just install and run franklin.

Add account credits or fund a wallet when you want to unlock premium models like Claude Opus 5.5, GPT-6 Astra, Gemini 3.1 Pro, and DeepSeek V4 Pro.

How is this different from Claude Code?

Claude Code is a coding copilot locked to a single provider (Anthropic). Franklin is an economic agent— software with purchasing power:

  • Routes across 70+ modelsfrom 15+ providers — picks the best model for each task, saving up to 89% vs always using Opus
  • Uses x402 micropaymentsinstead of $200/month subscriptions — chat at provider cost with no markup plus $0.001 per call, no rate limits
  • Has self-evolution— learns your preferences and improves over time
  • Works across verticals— code, trading, research, image generation, social media, and ops
  • Non-custodial— your keys never leave your machine, everything stored locally

Can I migrate from Claude Code?

Yes. Franklin includes a built-in migration tool that imports your Claude Code settings, CLAUDE.md project instructions, and history:

bash
franklin migrate

The migration is non-destructive — it copies data without modifying your existing Claude Code installation.

What happens if I run out of USDC?

Franklin automatically falls back to free NVIDIA models when your wallet balance is insufficient for premium models. You never lose access to the agent — it just routes to free models until you top up.

Can I use Franklin with my own API keys?

Franklin uses the x402 payment protocol by default, so you do not need individual API keys for each provider. However, you can configure direct API keys via franklin config if you prefer to use your own accounts.

Where can I get help?