@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.
- package/README.md +83 -65
- 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
|
|
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
|
|
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
|
[](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
|
|
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
|
|
268
|
-
- ~
|
|
269
|
-
- ~
|
|
270
|
-
- ~
|
|
271
|
-
-
|
|
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** (
|
|
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,
|
|
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,
|
|
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
|
-
>
|
|
372
|
+
> backtest strategies/sol_breakout.py on the last 90 days and tell me if it beats holding
|
|
375
373
|
|
|
376
|
-
✓
|
|
377
|
-
✓ Read
|
|
378
|
-
✓
|
|
379
|
-
✓
|
|
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
|
-
|
|
379
|
+
Strategy +11.4% vs. hold +6.2% · max drawdown −8.9% · 14 trades
|
|
383
380
|
```
|
|
384
381
|
|
|
385
|
-
|
|
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 -->
|
|
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 —
|
|
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
|
-
>
|
|
397
|
+
> summarize this week's stablecoin news in five bullets
|
|
401
398
|
|
|
402
|
-
|
|
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
|
|
403
|
+
TRADING claude-opus-5 · 8.2K in / 1.8K out
|
|
407
404
|
|
|
408
|
-
>
|
|
405
|
+
> is this funding-rate arbitrage actually risk-free? walk through the cases
|
|
409
406
|
|
|
410
|
-
REASONING claude-
|
|
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
|
|
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
|
|
429
|
-
|
|
430
|
-
claude-
|
|
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
|
|
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
|
### 🧠 Multi-model is the future
|
|
451
448
|
|
|
452
|
-
No single model is best at everything.
|
|
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
|
-
| |
|
|
470
|
-
| -------------------------------------- | ---------------- |
|
|
471
|
-
|
|
|
472
|
-
| **
|
|
473
|
-
|
|
|
474
|
-
|
|
|
475
|
-
|
|
|
476
|
-
|
|
|
477
|
-
|
|
|
478
|
-
|
|
|
479
|
-
|
|
|
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 -->
|
|
503
|
-
Anthropic, OpenAI, Google, xAI, DeepSeek, GLM, Kimi, Minimax,
|
|
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 -->
|
|
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
|
-
**🛠
|
|
515
|
-
|
|
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 -->
|
|
584
|
+
│ 2M+ requests · <!-- br:models.chatVisible@live -->86<!-- /br:models.chatVisible@live --> models · category detection · Elo scores │
|
|
572
585
|
├──────────────────────────────────────────────────────────────┤
|
|
573
586
|
│ Agent Loop │
|
|
574
|
-
│
|
|
587
|
+
│ 60+ tools · Sessions · Compaction · Pricing · Plugin SDK │
|
|
575
588
|
├──────────────────────────────────────────────────────────────┤
|
|
576
589
|
│ BlockRun Gateway │
|
|
577
|
-
│ <!-- br:models.chatVisible@live -->
|
|
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/
|
|
608
|
-
│
|
|
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 -->
|
|
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
|
|
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
|
|
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
|
|
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