Getting Started

Up and running with Franklin in 60 seconds.

Install

Franklin is distributed as a single npm package. Install it globally:

bash

npm install -g @blockrun/franklin

Run

That's it. Just type franklinand start chatting. Free NVIDIA models are available immediately with zero setup — no API keys, no accounts, no config files.

bash

franklin

No funding required

Franklin works without any funding. Free NVIDIA models (Llama, Mistral, Qwen, DeepSeek) are always available. Fund your wallet only when you want to unlock premium models like Claude, GPT-4, and Gemini.

Fund (optional)

To unlock 55+ premium models (Claude, GPT-4, Gemini, and more), set up a wallet and send USDC. Franklin uses micropayments — you pay fractions of a cent per action, with no subscriptions or rate limits.

bash

franklin setup base

This creates (or imports) a Base wallet and displays your deposit address. Send any amount of USDC on Base to get started — even $1 is enough for hundreds of actions.

What's Next

Installation details — prerequisites, platforms, and troubleshooting
Wallet setup — funding your wallet with USDC on Base or Solana
First session — a guided walkthrough of your first conversation with Franklin