Setting up Frappe locally on a Mac has always been a 2-hour debugging session disguised as a 10-minute task.
Wrong Python version. MariaDB refusing root access. nvm not loading in non-interactive shells. Guides that were one macOS update out of date.
So I built something about it: frappe-easy-installer-macos — a single shell script that takes you from a fresh Mac to a running Frappe bench in under 10 minutes.
What it does differently:
→ Uses uv for Python and volta for Node — modern, self-contained, no shell hook nonsense
→ Supports both Frappe v15 and v16 with the correct stack for each
→ Multiple benches coexist cleanly — install v16 without touching your existing v15
→ Pre-flight checks before touching anything on your machine
→ Safe mode for machines with an existing MariaDB setup
→ Clean terminal output — spinner, clear errors, logs only when something actually fails
It’s open source, MIT licensed, and designed to be idempotent — safe to re-run after any failure.
If you work with Frappe/ERPNext and have lost hours to local setup, this is for you.
frappe ERPNext opensource #developertools #macos