Skip to content

Franklin Agent 3.28.2 — install reliability

Choose a tag to compare

@VickyXAI VickyXAI released this 13 Jun 18:43
· 195 commits to main since this release

Reduces global-install failures reported by new users. No runtime code changes.

  • Honest Node engine floor. engines.node raised >=20 → >=20.18.0 to match what bundled dependencies (@solana/kit, @noble/*) actually require. Users on older Node now see one clear warning instead of ~40 cryptic EBADENGINE lines.
  • npx install path documented. The most common new-user failure is EACCES on npm install -g when the global npm prefix is root-owned (typical of the macOS Node .pkg installer). The README now leads users to npx @blockrun/franklin, which sidesteps the trap.
  • Install troubleshooting section. New README table maps EACCES and EBADENGINE to fixes, with the permanent cure (user-owned Node via nvm/fnm) and a 'don't use sudo' warning.