@blockrun/franklin 3.28.1 → 3.28.2

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 +27 -0
  2. package/package.json +2 -2
package/README.md CHANGED
@@ -56,6 +56,8 @@ Built by the [BlockRun](https://blockrun.ai) team. Apache-2.0. TypeScript. Ships
56
56
 
57
57
  ## Quick start
58
58
 
59
+ > **Requires Node.js 20.18+ (Node 22 LTS recommended).** Check with `node -v`.
60
+
59
61
  ```bash
60
62
  # 1. Install
61
63
  npm install -g @blockrun/franklin
@@ -70,6 +72,31 @@ franklin balance # show address + USDC balance
70
72
 
71
73
  That's it. Zero signup, zero credit card, zero phone verification. Send **$5 of USDC** to the wallet and you've unlocked every frontier model and every paid tool in the BlockRun gateway.
72
74
 
75
+ **No global install? Just run it directly** — no permissions, no `-g`:
76
+
77
+ ```bash
78
+ npx @blockrun/franklin
79
+ ```
80
+
81
+ ### Install troubleshooting
82
+
83
+ | Symptom | Cause | Fix |
84
+ | ------- | ----- | --- |
85
+ | `npm error EACCES … mkdir '/usr/local/lib/node_modules'` | Your global npm folder is owned by root (common when Node was installed from the macOS `.pkg`). | Don't use `sudo`. Either run `npx @blockrun/franklin` (no global install needed), or switch to a user-owned Node via a version manager — see below. |
86
+ | `npm warn EBADENGINE … required: { node: '>=20.x' }` | Node is older than 20.18. | Upgrade to Node 20.18+ or 22 LTS. The warning alone is harmless, but upgrading clears it. |
87
+
88
+ The clean, permanent fix for both is a **user-owned Node** so global installs never touch root-owned system folders:
89
+
90
+ ```bash
91
+ # nvm (https://github.com/nvm-sh/nvm)
92
+ nvm install 22 && nvm use 22
93
+ npm install -g @blockrun/franklin
94
+
95
+ # or fnm (https://github.com/Schniz/fnm)
96
+ fnm install 22 && fnm use 22
97
+ npm install -g @blockrun/franklin
98
+ ```
99
+
73
100
  ### Prefer a GUI? Try Franklin for VS Code
74
101
 
75
102
  [![Franklin for VS Code — Beta is here](assets/franklin-vscode-banner.png)](https://marketplace.visualstudio.com/items?itemName=blockrun.franklin-vscode)
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@blockrun/franklin",
3
- "version": "3.28.1",
3
+ "version": "3.28.2",
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": {
@@ -63,7 +63,7 @@
63
63
  },
64
64
  "homepage": "https://Franklin.run",
65
65
  "engines": {
66
- "node": ">=20"
66
+ "node": ">=20.18.0"
67
67
  },
68
68
  "dependencies": {
69
69
  "@blockrun/llm": "^2.0.0",