@blockrun/franklin 3.49.4 → 3.49.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +83 -65
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -45,7 +45,7 @@
45
45
 
46
46
  ## The pitch in one paragraph
47
47
 
48
- Franklin Agent is an **autonomous economic agent** — an AI that holds a USDC wallet and spends it to get real work done, with **trading as its flagship arena**. It buys live market data, proposes trade plans you approve before a cent moves, pursues long-running goals across sessions, keeps a wallet-bound trading journal, and picks the best model per task from 55+ providers. You state an outcome and set a budget. Franklin Agent decides what to call, what to pay for, and when to stop. No subscriptions, no seats, no rate limits.
48
+ Franklin Agent is an **autonomous economic agent** — an AI that holds a USDC wallet and spends it to get real work done, with **trading as its flagship arena**. It buys live market data, proposes trade plans you approve before a cent moves, pursues long-running goals across sessions, keeps a wallet-bound trading journal, and picks the best model per task from <!-- br:models.chatVisible -->86<!-- /br:models.chatVisible --> models. You state an outcome and set a budget. Franklin Agent decides what to call, what to pay for, and when to stop. No subscriptions, no seats, no rate limits.
49
49
 
50
50
  Funding it is your choice. Fund a **USDC wallet** and every paid action routes through the [x402](https://x402.org) micropayment protocol, settling on-chain against a wallet only you control — no signup, no account, the wallet is the identity. Or top up a **prepaid balance** at [user.blockrun.ai](https://user.blockrun.ai) and hand Franklin an API key. Same models, same tools, same agent. See [Two ways to pay](#two-ways-to-pay).
51
51
 
@@ -67,7 +67,7 @@ Built by the [BlockRun](https://blockrun.ai) team. Apache-2.0. TypeScript. Ships
67
67
  # 1. Install
68
68
  npm install -g @blockrun/franklin
69
69
 
70
- # 2. Run (free — uses NVIDIA Nemotron & Qwen3 Coder out of the box)
70
+ # 2. Run (free — uses the free models out of the box)
71
71
  franklin
72
72
 
73
73
  # 3. (optional) Unlock Sonnet, Opus, GPT, Gemini, Grok + every paid API.
@@ -113,7 +113,7 @@ npm install -g @blockrun/franklin
113
113
 
114
114
  [![Franklin for VS Code — Beta is here](assets/franklin-vscode-banner.png)](https://marketplace.visualstudio.com/items?itemName=blockrun.franklin-vscode)
115
115
 
116
- The same agent ships as a [VS Code extension](https://marketplace.visualstudio.com/items?itemName=blockrun.franklin-vscode) — chat panel, model picker, wallet balance, image / video generation, inline diff cards — all driven by the wallet you already funded for the CLI.
116
+ The same agent ships as a [VS Code extension](https://marketplace.visualstudio.com/items?itemName=blockrun.franklin-vscode) — chat panel, model picker, wallet balance, image / video generation — all driven by the wallet you already funded for the CLI.
117
117
 
118
118
  ```
119
119
  VS Code → Extensions (Cmd+Shift+X / Ctrl+Shift+X)
@@ -264,13 +264,11 @@ Three consequences fall out of this:
264
264
  2. **No rate limits.** Subscriptions throttle you when you need AI most. YOPO has no artificial caps — if you have USDC, you have access.
265
265
  3. **No overdraft.** The wallet balance IS the hard limit. When it's empty, Franklin stops. No surprise bills, no 3 a.m. rate-limit walls.
266
266
 
267
- Concretely — $1 in USDC gets you roughly:
268
- - ~400K GPT-4o input tokens
269
- - ~7M DeepSeek tokens
270
- - ~13M Gemini Flash tokens
271
- - ~20 DALL-E 3 images
272
- - ~40 Exa neural web searches
273
- - Unlimited agent-tested NVIDIA free tier (Qwen3 Coder + Llama 4 Maverick, no wallet needed)
267
+ Concretely — $1 in USDC buys roughly (input tokens at provider list price, before the $0.001 per-call fee):
268
+ - ~330K Claude Sonnet 4.6 tokens
269
+ - ~750K DeepSeek V4 Pro tokens
270
+ - ~3.3M Gemini 2.5 Flash tokens
271
+ - Unlimited use of the free tier — no wallet needed
274
272
 
275
273
  ---
276
274
 
@@ -282,7 +280,7 @@ Concretely — $1 in USDC gets you roughly:
282
280
 
283
281
  Most AI products fit into one of three buckets: they answer questions, write code, or automate a fixed workflow. None of them can spend money.
284
282
 
285
- Franklin can. It combines **purchasing power** (it pays for models, tools, and APIs), **budget awareness** (cost is part of the loop, not an afterthought), **cross-vertical execution** (code, trading, research, marketing, ops), and **hard stopping conditions** (wallet balance is a real constraint, not a suggestion).
283
+ Franklin can. It combines **purchasing power** (it pays for models, tools, and APIs), **budget awareness** (cost is part of the loop, not an afterthought), **cross-vertical execution** (trading, research, content, operations), and **hard stopping conditions** (wallet balance is a real constraint, not a suggestion).
286
284
 
287
285
  That is why Franklin is an economic agent, not just a task agent.
288
286
 
@@ -353,9 +351,9 @@ Generates images via DALL-E / GPT Image directly from the CLI. Paid from your se
353
351
 
354
352
  ### 📱 Remote control via Telegram
355
353
 
356
- Run `franklin telegram` on an always-on machine (set `TELEGRAM_BOT_TOKEN` + `TELEGRAM_OWNER_ID`) and drive Franklin from your phone. Owner-locked, session-resumable across restarts, slash commands (`/new`, `/balance`, `/status`). Trading, content, dev work — all reachable from a Telegram chat.
354
+ Run `franklin telegram` on an always-on machine (set `TELEGRAM_BOT_TOKEN` + `TELEGRAM_OWNER_ID`) and drive Franklin from your phone. Owner-locked, session-resumable across restarts, slash commands (`/new`, `/balance`, `/status`). Trading, research, content — all reachable from a Telegram chat.
357
355
 
358
- ### 🔎 Research, code, anything with a budget
356
+ ### 🔎 Research, analysis, anything with a budget
359
357
 
360
358
  ```text
361
359
  > compare the top 5 AI agent pricing models, summarize the patterns, and save a note for me
@@ -371,18 +369,17 @@ Run `franklin telegram` on an always-on machine (set `TELEGRAM_BOT_TOKEN` + `TEL
371
369
  ```
372
370
 
373
371
  ```text
374
- > refactor src/auth.ts to use the new jwt helper, then run the tests
372
+ > backtest strategies/sol_breakout.py on the last 90 days and tell me if it beats holding
375
373
 
376
- ✓ Read src/auth.ts $0.002
377
- ✓ Read src/lib/jwt.ts $0.001
378
- ✓ Edit src/auth.ts (-24 +31 lines) $0.008
379
- ✓ Bash npm test $0.000
380
- › 142 passing · 0 failing · 2.4s
374
+ ✓ TradingMarket SOL · 90d daily candles
375
+ ✓ Read strategies/sol_breakout.py
376
+ ✓ Bash python strategies/sol_breakout.py --days 90
377
+ ✓ Write notes/sol-breakout-90d.md
381
378
 
382
- Done in 18s · $0.011
379
+ Strategy +11.4% vs. hold +6.2% · max drawdown −8.9% · 14 trades
383
380
  ```
384
381
 
385
- Code is still first-class. It is just **one workload**, not the category.
382
+ Files and shell are there for the work around a strategy — scripts, data, reports. They are tools, not the category.
386
383
 
387
384
  Every tool call is itemized. Every token is priced. When the wallet hits zero, Franklin stops. No overdraft, no surprise bill, no rate-limit wall at 3 a.m. — this is YOPO in practice.
388
385
 
@@ -390,24 +387,24 @@ Every tool call is itemized. Every token is priced. When the wallet hits zero, F
390
387
 
391
388
  ## Smart Router
392
389
 
393
- **<!-- br:models.chatVisible -->82<!-- /br:models.chatVisible --> models. One decision. Zero guesswork.**
390
+ **<!-- br:models.chatVisible -->86<!-- /br:models.chatVisible --> models. One decision. Zero guesswork.**
394
391
 
395
392
  You don't pick models. Franklin picks for you.
396
393
 
397
- The Smart Router classifies every request — coding, trading, reasoning, research — and selects the model with the best quality-to-cost ratio. Trained on **2M+ real requests** from the BlockRun gateway, continuously updated.
394
+ The Smart Router classifies every request — trading, research, reasoning, creative — and selects the model with the best quality-to-cost ratio. Trained on **2M+ real requests** from the BlockRun gateway, continuously updated.
398
395
 
399
396
  ```text
400
- > refactor this auth module to use JWT
397
+ > summarize this week's stablecoin news in five bullets
401
398
 
402
- CODING kimi-k2.5 · 12.4K in / 2.1K out · $0.0023 saved 84%
399
+ RESEARCH deepseek-v4-pro · 9.6K in / 0.8K out
403
400
 
404
401
  > what's the BTC outlook for the week?
405
402
 
406
- TRADING grok-4-1-fast-reasoning · 8.2K in / 1.8K out · $0.0008 saved 95%
403
+ TRADING claude-opus-5 · 8.2K in / 1.8K out
407
404
 
408
- > prove that this algorithm is O(n log n)
405
+ > is this funding-rate arbitrage actually risk-free? walk through the cases
409
406
 
410
- REASONING claude-sonnet-4.6 · 15.1K in / 3.4K out · $0.0312
407
+ REASONING claude-opus-5 · 15.1K in / 3.4K out
411
408
  ```
412
409
 
413
410
  Every response shows which model was chosen, why, and how much you saved vs. always using the most expensive option.
@@ -419,18 +416,18 @@ Every response shows which model was chosen, why, and how much you saved vs. alw
419
416
  | `auto` | Best quality-to-cost ratio | Default — smart spend |
420
417
  | `eco` | Cheapest model with decent quality | Budget-conscious |
421
418
  | `premium` | Highest quality regardless of cost | Mission-critical |
422
- | `free` | Free NVIDIA models only | Zero wallet balance |
419
+ | `free` | Free models only | Zero wallet balance |
423
420
 
424
421
  **Per-session breakdown** — run `/cost` to see exactly where your USDC went:
425
422
 
426
423
  ```text
427
424
  Session Cost: $0.0847 (23 requests)
428
- gemini-2.5-flash $0.0012 14 req CODING
429
- kimi-k2.5 $0.0423 6 req CODING
430
- claude-sonnet-4.6 $0.0412 3 req REASONING
425
+ gemini-2.5-flash $0.0012 14 req CHAT
426
+ deepseek-v4-pro $0.0201 6 req RESEARCH
427
+ claude-opus-5 $0.0634 3 req TRADING
431
428
  ```
432
429
 
433
- The router also learns from **your** usage. If you keep retrying a model for coding tasks, Franklin adapts and picks a better one next time. Your router gets smarter the more you use it.
430
+ The router also learns from **your** usage. If you keep retrying a model for research tasks, Franklin adapts and picks a better one next time. Your router gets smarter the more you use it.
434
431
 
435
432
  ---
436
433
 
@@ -449,7 +446,7 @@ You don't subscribe to electricity, you pay for what you use. Franklin brings th
449
446
 
450
447
  ### 🧠 &nbsp;Multi-model is the future
451
448
 
452
- No single model is best at everything. Sonnet writes better code, Gemini handles longer context, DeepSeek costs 20x less for simple tasks. The Smart Router routes every request to the optimal model in <1ms — <!-- br:savings.autoVsBaselinePct -->84<!-- /br:savings.autoVsBaselinePct -->% cheaper than pinning Claude Opus 5 for every request.
449
+ No single model is best at everything. Opus reasons deeper, Gemini handles longer context, DeepSeek costs 20x less for simple tasks. The Smart Router routes every request to the optimal model in <1ms — <!-- br:savings.autoVsBaselinePct -->84<!-- /br:savings.autoVsBaselinePct -->% cheaper than pinning Claude Opus 5 for every request.
453
450
 
454
451
  </td>
455
452
  <td width="33%" valign="top">
@@ -466,19 +463,17 @@ No email. No phone. No KYC. Your Solana, Base or Arc address is your account —
466
463
 
467
464
  ## The comparison
468
465
 
469
- | | Coding agents | Editor IDEs | Chatbots | **Franklin** |
470
- | -------------------------------------- | ---------------- | ---------------- | ---------------- | ------------------------------- |
471
- | Writes code | ✅ | ✅ | ⚠️ | ✅ |
472
- | **Spends money for you** | ❌ | ❌ | ❌ | ✅ **USDC wallet, x402** |
473
- | **Buys data + APIs + images + search** | ❌ | ❌ | ❌ | ✅ **55+ APIs, one wallet** |
474
- | Picks best model per task | ❌ single-vendor | ❌ plan-tied | ❌ | ✅ **Smart Router, <!-- br:models.chatVisible -->82<!-- /br:models.chatVisible --> models** |
475
- | Pricing model | Subscription | Subscription | Subscription | **YOPO** — per outcome, USDC |
476
- | Monthly fee | $20–$200 | $20–$40 | $20+ | **$0** |
477
- | Rate-limited | Yes | Yes | Yes | No — limited only by wallet |
478
- | Works when provider goes down | ❌ | ❌ | ❌ | ✅ **routes to another** |
479
- | Identity | Vendor account | Vendor account | Account / email | ✅ **wallet, no signup** |
480
- | Start free, no KYC | ❌ | ❌ | ❌ | ✅ |
481
- | Source | Closed | Closed | Closed | **Apache 2.0, local-first** |
466
+ | | AI chat apps | Agent frameworks | Trading bots | **Franklin** |
467
+ | -------------------------------------- | ---------------- | ----------------------- | -------------------- | ------------------------------- |
468
+ | **Spends money for you** | ❌ | ⚠️ you wire payments | ⚠️ trades only | ✅ **USDC wallet or prepaid key** |
469
+ | **Buys data + APIs + images + search** | ❌ | ⚠️ one key per service | ❌ | ✅ **one wallet pays for all** |
470
+ | Picks best model per task | ❌ single-vendor | ⚠️ you pick | ❌ | ✅ **Smart Router, <!-- br:models.chatVisible -->86<!-- /br:models.chatVisible --> models** |
471
+ | **Money moves only on your approval** | — | ⚠️ build it yourself | ❌ runs on rules | ✅ **trade plan, every mode** |
472
+ | Spend guardrails | — | ⚠️ build it yourself | ⚠️ per-bot limits | ✅ **budget caps + hooks** |
473
+ | Works when a provider goes down | ❌ | ⚠️ if you code it | ❌ | ✅ **routes to another** |
474
+ | Pricing | Subscription | Your separate API bills | Subscription or fees | **YOPO** — per outcome |
475
+ | Identity | Vendor account | A key per vendor | Exchange account | ✅ **wallet, no signup** |
476
+ | Source | Closed | Mixed | Mostly closed | **Apache 2.0, local-first** |
482
477
 
483
478
  **Franklin is the economic agent category in one sentence:** software with a wallet that can spend toward a result.
484
479
 
@@ -499,20 +494,20 @@ Ask "what's BTC looking like?" — Franklin fetches live price data, computes RS
499
494
  **🎨 AI image generation**
500
495
  Ask "generate a logo" — Franklin calls DALL-E / GPT Image, saves the result locally, paid from your wallet.
501
496
 
502
- **🧠 <!-- br:models.chatVisible -->82<!-- /br:models.chatVisible --> models via one wallet**
503
- Anthropic, OpenAI, Google, xAI, DeepSeek, GLM, Kimi, Minimax, NVIDIA free tier. One wallet, one interface, automatic fallback.
497
+ **🧠 <!-- br:models.chatVisible -->86<!-- /br:models.chatVisible --> models via one wallet**
498
+ Anthropic, OpenAI, Google, xAI, DeepSeek, GLM, Kimi, Minimax, plus a free tier. One wallet, one interface, automatic fallback.
504
499
 
505
500
  **💳 x402 micropayments (YOPO)**
506
501
  HTTP 402 native. Every paid action is a signed USDC micropayment — an EIP-712 authorization on Base and Arc, a signed SPL transfer on Solana. Non-custodial: your keys never leave your machine. YOPO: you pay only for outcomes.
507
502
 
508
503
  **🧠 Learned model router**
509
- Trained on 2M+ real requests. Classifies your task and picks the best model from <!-- br:models.chatVisible -->82<!-- /br:models.chatVisible --> LLMs. Four profiles (auto/eco/premium/free). Adapts to your usage over time.
504
+ Trained on 2M+ real requests. Classifies your task and picks the best model from <!-- br:models.chatVisible -->86<!-- /br:models.chatVisible --> LLMs. Four profiles (auto/eco/premium/free). Adapts to your usage over time.
510
505
 
511
506
  </td>
512
507
  <td width="50%" valign="top">
513
508
 
514
- **🛠 16 built-in tools**
515
- Read, Write, Edit, Bash, Glob, Grep, WebFetch, WebSearch, Task, ImageGen, VideoGen, MemoryRecall, AskUser, SubAgent, TradingSignal, TradingMarket, TradingPortfolio, TradingOpenPosition, TradingClosePosition, TradingHistory.
509
+ **🛠 60+ built-in tools**
510
+ Trading and DeFi (signals, portfolio, trade plans, Jupiter and 0x swaps, Polymarket, DeFiLlama), research (Exa, web search and fetch, X search, on-chain and market data), media (image, video, music), autonomy (goals, scheduler, monitors, sub-agents, mixture of agents), phone and voice calls, cloud sandboxes, and general files and shell.
516
511
 
517
512
  **💾 Persistent sessions**
518
513
  Every turn is streamed to disk with metadata. Resume any session by ID. Survives crashes, reboots, and compaction.
@@ -526,6 +521,9 @@ Every turn is streamed to disk with metadata. Resume any session by ID. Survives
526
521
  **⚡ Anthropic prompt caching**
527
522
  Multi-turn Sonnet/Opus sessions use ephemeral cache breakpoints to reduce input spend on long conversations.
528
523
 
524
+ **🔒 Guarded by default**
525
+ Trades need your approved plan, the wallet key never reaches the model, and every network call the agent makes is checked. See [Safety and security](#safety-and-security).
526
+
529
527
  **🔌 Plugin SDK + MCP**
530
528
  Core is workflow-agnostic. Add new verticals without touching the loop. Discover external tools automatically through MCP.
531
529
 
@@ -540,14 +538,16 @@ Core is workflow-agnostic. Add new verticals without touching the loop. Discover
540
538
  | Command | What it does |
541
539
  | -------------------------------- | ---------------------------------------------------- |
542
540
  | `/model [name]` | Interactive model picker, or switch directly |
541
+ | `/goal <objective>` | Work an objective across turns, verified at the end |
542
+ | `/loop <interval> <prompt>` | Run a prompt on a schedule (`/loop list`, `cancel`) |
543
+ | `/market` | Browse and hire paid skills from the marketplace |
544
+ | `/moa` | Ask several models the same question, compare |
543
545
  | `/plan` / `/execute` | Read-only planning mode / execution mode |
544
546
  | `/ultrathink <q>` | Deep reasoning mode for hard problems |
547
+ | `/remember` / `/flush` / `/dream`| Save a note / capture learnings / consolidate memory |
545
548
  | `/compact` | Structured context compression |
546
- | `/search <q>` | Search the codebase |
547
549
  | `/session-search <q>` | Search past sessions |
548
550
  | `/history` / `/resume [id]` | Inspect or restore conversation state |
549
- | `/commit` / `/push` / `/pr` | Git workflow helpers |
550
- | `/review` / `/fix` / `/test` | One-shot code review, bugfix, or test runs |
551
551
  | `/cost` / `/wallet` | Session cost, wallet address, and balance |
552
552
  | `/insights [--days N]` | Rich usage analytics |
553
553
  | `/help` | Full command list |
@@ -560,6 +560,19 @@ like `opus`, `gpt` and `grok` keep their current targets.
560
560
 
561
561
  ---
562
562
 
563
+ ## Safety and security
564
+
565
+ Franklin holds money, so the defaults assume a model can be steered by what it reads — a fetched page, a search result, an MCP response.
566
+
567
+ - **Money moves only on your approval.** Trades need a trade plan you approve, in every permission mode. `--max-spend` sets a spending ceiling, and [lifecycle hooks](docs/examples/hooks/) can veto any paid action before it runs.
568
+ - **The wallet key never reaches the model.** File, search and browser tools refuse the key store and the machine's own credential stores (`~/.ssh`, `~/.aws`, cloud and Solana CLI keys). The exact key values are also scrubbed from every tool result.
569
+ - **Network calls stay public.** Model-driven requests (web fetch, webhooks, the browser) refuse loopback, private and cloud-metadata addresses, and re-check every redirect.
570
+ - **The local panel answers only you.** It listens on loopback, checks the `Host` header, and its wallet and spend routes require a token that only the page it serves knows.
571
+
572
+ Found a vulnerability? Please report it privately — see [SECURITY.md](SECURITY.md).
573
+
574
+ ---
575
+
563
576
  ## How it works
564
577
 
565
578
  ```text
@@ -568,13 +581,13 @@ like `opus`, `gpt` and `grok` keep their current targets.
568
581
  │ Intent → Smart Router → Tool Use → Spend Control → Result │
569
582
  ├──────────────────────────────────────────────────────────────┤
570
583
  │ Learned Router │
571
- │ 2M+ requests · <!-- br:models.chatVisible@live -->82<!-- /br:models.chatVisible@live --> models · category detection · Elo scores │
584
+ │ 2M+ requests · <!-- br:models.chatVisible@live -->86<!-- /br:models.chatVisible@live --> models · category detection · Elo scores │
572
585
  ├──────────────────────────────────────────────────────────────┤
573
586
  │ Agent Loop │
574
- │ 16 tools · Sessions · Compaction · Pricing · Plugin SDK │
587
+ │ 60+ tools · Sessions · Compaction · Pricing · Plugin SDK │
575
588
  ├──────────────────────────────────────────────────────────────┤
576
589
  │ BlockRun Gateway │
577
- │ <!-- br:models.chatVisible@live -->82<!-- /br:models.chatVisible@live --> LLMs · CoinGecko · Search · Image APIs · paid services │
590
+ │ <!-- br:models.chatVisible@live -->86<!-- /br:models.chatVisible@live --> LLMs · CoinGecko · Search · Image APIs · paid services │
578
591
  ├──────────────────────────────────────────────────────────────┤
579
592
  │ x402 Micropayment Protocol │
580
593
  │ HTTP 402 · USDC on Solana, Base & Arc · signed payloads │
@@ -604,10 +617,15 @@ src/
604
617
  ├── index.ts CLI entry (franklin)
605
618
  ├── banner.ts Ben Franklin portrait + FRANKLIN gradient text
606
619
  ├── agent/ Agent loop, LLM client, compaction, commands
607
- ├── tools/ 20+ built-in tools (Read/Write/Edit/Bash/Glob/Grep/
608
- │ WebFetch/WebSearch/Task/ImageGen/VideoGen/
609
- │ MemoryRecall/AskUser/SubAgent/Trading*/Content*)
620
+ ├── tools/ 60+ built-in tools (trading, DeFi, research, media,
621
+ │ phone, sandboxes, files and shell)
610
622
  ├── trading/ Market data (CoinGecko) + technical indicators
623
+ ├── goal/ /goal objectives + adversarial verification
624
+ ├── hooks/ Lifecycle hooks (PreSpend and friends)
625
+ ├── scheduler/ Durable /loop scheduler
626
+ ├── memory/ Wallet-keyed memory and trading journal
627
+ ├── panel/ Local dashboard (franklin panel)
628
+ ├── serve/ Agent host for the panel's Agents tab
611
629
  ├── content/ Content library with budget-bound media generation
612
630
  ├── brain/ Cross-session entity knowledge graph
613
631
  ├── channel/ Non-CLI ingress drivers (Telegram today)
@@ -618,7 +636,7 @@ src/
618
636
  ├── stats/ Usage tracking + insights engine
619
637
  ├── ui/ Ink-based terminal UI
620
638
  ├── proxy/ Payment proxy for external tools
621
- ├── router/ Learned model router (<!-- br:models.chatVisible@live -->82<!-- /br:models.chatVisible@live --> models, Elo scoring)
639
+ ├── router/ Learned model router (<!-- br:models.chatVisible@live -->86<!-- /br:models.chatVisible@live --> models, Elo scoring)
622
640
  ├── wallet/ Wallet management (Base/Arc + Solana)
623
641
  ├── mcp/ MCP server auto-discovery
624
642
  └── commands/ CLI subcommands
@@ -628,7 +646,7 @@ src/
628
646
 
629
647
  ## Free tier, for real
630
648
 
631
- Start with **zero dollars**. Franklin defaults to free NVIDIA models that need **no wallet and no API key** — nothing to fund, nothing to sign up for.
649
+ Start with **zero dollars**. Franklin defaults to free models that need **no wallet and no API key** — nothing to fund, nothing to sign up for.
632
650
 
633
651
  ```bash
634
652
  franklin --model free
@@ -698,7 +716,7 @@ npm install
698
716
  npm run build
699
717
  npm test # deterministic local tests — no API calls
700
718
  npm run test:e2e # live e2e tests — free smoke works unfunded; paid tools need network + funded wallet
701
- npm run test:free-models # live matrix across current free NVIDIA models
719
+ npm run test:free-models # live matrix across the current free models
702
720
  node dist/index.js --help
703
721
  ```
704
722
 
@@ -720,7 +738,7 @@ npm run desktop:package:win
720
738
  Packaged builds create a private, per-launch credential for the local Franklin
721
739
  service, keep cloud session sync off unless the user explicitly enables it, and
722
740
  use `Documents/Franklin` as the default workspace. Files outside that workspace
723
- remain available after an explicit approval, similar to other coding agents.
741
+ remain available after an explicit approval.
724
742
  Team Mode is being developed separately and is not part of this stable integration.
725
743
 
726
744
  For the recommended live validation order and failure triage, see [docs/live-e2e-checklist.md](docs/live-e2e-checklist.md).
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@blockrun/franklin",
3
- "version": "3.49.4",
3
+ "version": "3.49.5",
4
4
  "description": "Franklin Agent — The AI agent with a wallet. Spends USDC autonomously to get real work done. Pay per action, no subscriptions.",
5
5
  "type": "module",
6
6
  "exports": {