Set Up Your Mac for Python

This is a free Mac app that installs and configures Python for you, from the author of the Mac Install Guide. It is the fastest path to a conflict-free, verified Python setup that actually works.

If you need Python: maybe a course or a tutorial told you to install it, maybe a script at work will not run, or maybe you typed python and your Mac said command not found. Python on a Mac is unusually confusing: the Apple system tools include one version, Homebrew may have installed another, and a version manager might have added a third. They do not agree, and the one that runs is often not the one you wanted.

This free app sorts that out for you, the way an expert would, in about ten minutes. You do not type a single terminal command. It finds every Python version on your Mac and tells you which one actually runs, installs a modern Python the reliable way with the uv manager, and then proves it works by creating a project and installing a package, so you finish with a setup that can do real work, not just guesswork or trial-and-error.

Download the app "Set Up Your Mac for Python"

No account is needed. There is no trial, no paid upgrade. Most setups finish in less than ten minutes. There is no catch; everything it installs is free, standard, open-source software.

Who this is for

Many people who need Python on a Mac are not experienced Python developers. You might be:

• Taking a course: data science, machine learning, or an intro programming class that lists "install Python" as step one.
• Stuck on an error: zsh: command not found: python, command not found: pip, or externally-managed-environment when you try to install a package.
• Running a script or tool someone gave you that needs Python and packages.
• A developer who wants a clean, modern Python without the old, complicated pyenv, python.org, or other messy configurations.

If you want to get Python running without figuring out where Python is installed and studying how macOS PATH works, this app is for you.

What the app does, step by step

I built this to be an app I can trust, so nothing happens behind your back. The app shows you each step, in detail, before it runs anything.

1. It finds every Python version you have. It looks across the places Python hides on a Mac (Apple's, Homebrew's, python.org's, pyenv, Rye, uv, conda) and lists each one it finds with its version and where it came from. It reads the filesystem; it does not run anything to find out.
2. It tells you which one actually runs. This is the part that catches people. The app opens a fresh login shell and reports what python and python3 each resolve to, and why. Having Python installed and having python work are different things, and the difference is usually problems with the shell PATH.
3. It checks for a conflict first. If a version manager such as pyenv, conda, asdf or mise is already managing Python for you, the app says so up front and lets you stop. It will not fight another tool for control of your setup.
4. It installs Python with your permission. It uses uv, a fast modern installer from Astral, and installs a uv-managed Python. When anything needs your password, macOS shows its own standard prompt. You can cancel at any moment.
5. It makes python actually work. Installing the Python is not enough. The app also adds the one PATH line that fixes the python command, placed after other lines so there is no fight. It shows you the exact change first and backs the file up before editing it.
6. It proves the setup works. It creates a real project, installs a package into it, and imports that package. If that succeeds, you have a Python that can do actual work. If it fails, the app tells you which step failed and what that means.
7. It offers an example project. If you want, it will install a sample project in a directory of your choice. It will also help install an AI agent such as Claude or ChatGPT Codex to use with the project, pre-configured to work with the sample.

Most setups take less than ten minutes.

Why use the app instead of a tutorial

You can set Python up by hand, and my Install Python on Mac, Install uv and Mac Python PATH tutorials cover every step. Reading them is still the best way to understand the why.

But Python on macOS has a specific trap that tutorials struggle with: the most common failure is not a failed install, it is a successful install that the shell then ignores. You install Python, the installer says it worked, and python still returns command not found, or worse, silently runs a different Python than the one you just installed. That is a PATH problem, it is invisible, and it is why the "check what you have" and "which one actually runs" steps come first in this app.

I am the author of the Mac Install Guide and have written macOS tutorials since 2018. I added the Set Up Your Mac apps because I kept seeing that some setups are simply easier with a tool than with a tutorial. The app does exactly what the tutorial describes, far faster, with a verified result.

Is it safe to run?

Short answer: yes, and you can check every part of it. This matters especially if you are not a developer and would rather be sure before running an app that changes anything on your Mac.

• Signed and notarized by Apple. macOS Gatekeeper launches it without warnings, after the standard "downloaded from the internet" first-launch confirmation.
• Every change is shown first. Before it acts, the app shows you what it will install, the PATH line it will add, and the backup it will make. Nothing is stealthy or tricky.
• Your password stays with macOS. Anything that needs a password uses Apple's standard authorization dialog, so the system handles it, never the app.
• It does not remove or change what you have. It never uninstalls a Python you already installed, and it never edits or disables another tool's configuration. If pyenv, conda, asdf or mise is managing your Python, the app tells you and stops rather than taking over.
• It adds, it does not rewrite. The only change it makes to your shell configuration is appending its own marked line. It never edits a line someone else wrote.
• It does not linger. No background process, no menu bar app, no launchd service, no auto-launch at login, no auto-update. Quit it and it is gone until you open it again. New versions you download yourself, the same way you downloaded this one.

What it leaves on your Mac

The app tells you this on its final screen, with real details, so you don't have to guess. A typical run leaves a uv-managed Python and uv's own cache, plus Homebrew and Xcode Command Line Tools if you did not already have them and chose to install them. Nothing is hidden, and the outcome screen names each item.

Your privacy

The app sends anonymous event counts so I can tell whether it is actually helping people, for example "the check step finished" or "the verify step passed." It does not send your name, email address, IP address, or any identifier I could use to contact you, and it does not send your shell config, your files, or a list of what is installed on your Mac. Each launch gets a random session identifier that resets when you quit. Full details are in the Mac Install privacy article.

Download the app "Set Up Your Mac for Python"

System requirements and how to run it

The app requires macOS 14 Sonoma or later and runs natively on both Apple Silicon and Intel Macs.

Download the disk image, open it, and drag the app to your Applications folder. The first time you open it, macOS asks you to confirm you want to open an app downloaded from the internet; that is the standard prompt, and the app is signed and notarized by Apple.