◆Franklin/Docs

FAQ

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

What models does Franklin support?

Franklin supports 55+ models from 12+ providers, including OpenAI (GPT-5.4, GPT-5.3, o3), Anthropic (Claude Opus 4.6, Sonnet 4.6), Google (Gemini 3.1 Pro, 2.5 Flash), xAI (Grok-3), DeepSeek (V3.2, Reasoner), Moonshot (Kimi K2.5), MiniMax (M2.7), Z.AI (GLM-5), and free NVIDIA-hosted models. Run franklin models to see the full list with pricing.

How does payment work?

Franklin uses the x402 protocolfor micropayments. Each API call is settled instantly in USDC on Base or Solana. You pay provider cost + 5%, settled via EIP-712 signatures. No subscriptions, no invoices, no billing cycles — you pay only for what you use.

bash
# Set up a wallet
franklin setup base

# 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 free access to NVIDIA-hosted models (GPT-OSS 120B/20B, Llama, Qwen, DeepSeek R1) with unlimited usage and zero setup. No wallet, no USDC, no API keys required. Just install and run franklin.

Fund your wallet only when you want to unlock premium models like Claude Opus 4.6, GPT-5.4, Gemini 3.1 Pro, and Grok-3.

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 55+ modelsfrom 12+ providers — picks the best model for each task, saving up to 89% vs always using Opus
  • Uses x402 micropaymentsinstead of $200/month subscriptions — provider cost + 5%, 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?