pymac is a command line tool for installing and managing Python versions from Python.org's macOS installers.

Core features:

• Download and install Python.org versions entirely from the command line
• Installs only the basics (Python itself, Pip, and SSL certificates), other features like GUI applications are excluded (see What is excluded)
• Managing Python.org installations: updating installed Python versions, setting default Python version, uninstalling versions, and more.
• Automatically picks latest available Python micro versions with a macOS installer if you provide Major.Minor version (pymac install 3.14)
• Warns user if latest Python micro version with a macOS installer is outdated
• Integrates with pyenv (allows you to manage Python versions installed with Python.org installers like normal pyenv installs)

First, an important note: With the Python.org installer, you always only have one Major.Minor Python version (e.g. 3.13). Different micro versions are not installed separately. That said, let's install a few Python versions:

pymac install 3.14 --default
pymac install 3.13.13

If you only provide Major.Minor versions, pymac will pick the latest micro version with a macOS installer on https://www.python.org/ftp/python/. If you specify a micro version, this version will be picked instead. Python.org installers will install Python versions at /Library/Frameworks/Python.framework/Versions/, so your root password is required. Using the --default flag creates a symlink to ~/.config/pymac/default, which you can add to your PATH so that the python or pip commands call this version of Python (see Installation). You can change the default any time:

pymac default 3.13

Please note that if you don't set a default, pymac only provides symlinks in ~/.local/bin named "pythonMajor.Minor" (e.g. python3.13, see install below), no python/pip or python3/pip3 commands are added to your PATH.

If you want to use the GUI installer, you can use the --interactive flag:

pymac install 3.14 --interactive

Note that pymac will not customize Python versions installed with the GUI installer automatically by creating symlinks and installing certifi for you. See How it works.

pymac update 3.14
# Or check updates for all
pymac update-all

If pymac fails to correctly detect the latest micro version available or if you need a specific micro version, just install it directly:

# This will override whatever 3.13 micro version you had installed before
pymac install 3.13.10

To see what micro versions are currently installed:

pymac list --full
3.13 (3.13.13)
3.14 (3.14.4)

If you want to call a specific version of Python that is not set as default:

> pymac exec 3.13 --version
Python 3.13.13
> # If you have ~/.local/bin in your PATH you can also use:
> python3.13 --version
Python 3.13.13

pymac pyenv sync

This creates symlinks to pymac installs in $PYENV_ROOT/versions, which allows you to manage them with pyenv's shims. pymac names its versions as Major.Minor to distinguish them from pyenv installs, which are named as Major.Minor.Micro:

# In this example we added pymac symlinks for 3.13 and 3.14
# Version 3.13.10 is a pyenv install
> pyenv versions
* system (set by /Users/stefan/.pyenv/version)
  3.13
  3.13.10
  3.14
> pyenv global 3.13
> pyenv versions
  system
* 3.13 (set by /Users/stefan/.pyenv/version)
  3.13.10
  3.14

To remove symlinks to pyenv:

# Remove a specific version or all
pymac pyenv remove 3.13
pymac pyenv remove-all

See the List of commands for more options.

Clone this repository:

git clone https://github.com/sbaack/pymac.git ~/.pymac

Add the following to your ~/.zshrc or ~/.bashrc:

export PATH=~/.pymac/bin:"$PATH"
# Optional: Add pymac default to your PATH
export PATH=~/.config/pymac/default/bin:"$PATH"
# Optional: Add ~/.local/bin to your PATH if you haven't already
export PATH=~/.local/bin:"$PATH"

For fish, add this to your ~/.config/fish/config.fish:

set -x PATH ~/.pymac/bin "$PATH"
# Optional: Add pymac default to your PATH
set -x PATH ~/.config/pymac/default/bin "$PATH"
# Optional: Add ~/.local/bin to your PATH if you haven't already
set -x PATH ~/.local/bin "$PATH"

• Adding ~/.config/pymac/default/bin to your PATH is entirely optional. You can also call pymac Python installations directly with the pymac exec command.
• If you would like to be able to call or specify a Python version with pythonMajor.Minor (e.g. python3.13), make sure to add ~/.local/bin to your PATH. Also ensure that ~/.local/bin is in your PATH before /usr/local/bin because this is where Homebrew stores pythonMajor.Minor symlinks. Having ~/.local/bin in your PATH before /usr/local/bin means that pymac's Python versions are preferred over Homebrew if you have the same Python version installed in both.
• If you want to manage pymac installs with pyenv you should source pyenv after adding ~/.config/pymac/default/bin to your PATH.

For zsh, add this to your ~/.zshrc (after compinit):

[[ -e "$HOME/.pymac/completions/pymac.zsh" ]] && source "$HOME/.pymac/completions/pymac.zsh"

For bash, add this to your ~/.bashrc:

[[ -e "$HOME/.pymac/completions/pymac.bash" ]] && source "$HOME/.pymac/completions/pymac.bash"

Note: The bash completions require bash 4.0+. macOS ships with bash 3. If you're using bash on macOS, install a newer version via Homebrew (brew install bash).

For fish:

mkdir -p ~/.config/fish/completions; and ln -s -f ~/.pymac/completions/pymac.fish ~/.config/fish/completions/

In short, because the Python.org installers have some advantages over other solutions:

• You don't need to compile Python yourself and Python.org installers have more features. pyenv or asdf-python require you to install Python build dependencies, and building Python might fail when you upgrade macOS and/or your device. uv's Python installs don't have all the features of Python.org installs.
• If you typically just want the latest micro versions of Python, Python.org installations have the advantage that existing Major.Minor versions are updated in-place. This means you only have one Python version 3.13 or 3.14 for example. If you update Python 3.13.10 to 3.13.13 with the Python.org installer, 3.13.13 will override 3.13.10. Unless a micro version update of Python breaks your dependencies, the virtualenvs you've created with 3.13.10 will continue to work because they point to the same (updated) '3.13' directory.
• Unlike Homebrew Python, installations from Python.org won't randomly break your virtualenvs because you stay in control of when and how Python versions are updated.

pymac is about utilizing the advantages of Python.org installers while mitigating some of their inconveniences:

• The most obvious one being that you usually have to visit Python.org, download the version you need, and click through a GUI interface.
• Python.org installers by default also install features that you might not want: GUI applications, shell config manipulations, documentation and more (see What is excluded)
• Python.org installers come with their own private copy of OpenSSL and require you to manually execute a command that installs and sets up SSL root certificates from the certifi package. This command only comes with the GUI applications.

pymac mitigates this by a) enabling you to install Python.org versions entirely from the command line, b) customizing the installer to only install the basics: Python itself and Pip, and c) automatically installing and setting up SSL certificates. In addition, it offers commands to help manage multiple versions of Python. See How it works and the List of commands for more information.

When you install a Python version with pymac the following happens in the background:

1. Download the correct PKG installer from Python.org.
2. Install Python using the PKG file from the command line (no GUI). Your root password will be required to install Python in /Library/Frameworks/Python.framework/Versions/<Major.Minor> (unfortunately you can't customize the location). pymac customizes the installation so that only Python itself and Pip are installed (see What is excluded).
3. Additional symlinks are created. First, Python.org installers only include executables named python3 or pip3 by default. pymac creates additional symlinks in Python's 'bin' directory so that the default names are used as well (python, pip etc.). Second, the Python.org installers optionally create pythonMajor.Minor symlinks (e.g. python3.13) in /usr/local/bin to make calling or specifying a Python version easier (if 'UNIX command line tools' are installed, they are excluded by pymac. See What is excluded). Putting such symlinks in /usr/local/bin might conflict with Homebrew Python. pymac avoids conflicts by creating pythonMajor.Minor symlinks in ~/.local/bin instead.
4. Finally, pymac will automatically install and symlink SSL root certificates from the certifi package. This replicates the Install Certificates.command that comes with the GUI applications from the Python.org installer (which pymac doesn't install) and that you typically have to execute manually after the installation is completed.

The following features of the Python.org installer are excluded:

• GUI Applications: Adds a directory in /Applications with the Python Launcher (enables double-clicking Python scripts in Finder), some scripts (for setting up SSL certificates and the shell profile updater) and a shortcut to IDLE. Note that you can still run IDLE from the command line when GUI applications are not installed.
• UNIX command line tools: Adds symlinks to Python executables to /usr/local/bin.
• Python Documentation: Offline documentation.
• Shell profile updater: Adds a line to your shell config (.bash_profile, .zprofile, or config.fish) that prepends the installed Python version to your PATH.

If you need any of these features, use the --interactive flag mentioned above.

> pymac help
Install and manage Python.org macOS installers from the command line.

Usage: pymac <command> [<args>]

Commands:
  certifi-update: Update/install and symlink SSL certificates in specified Python version
  certifi-update-all: Update certifi package for all Python versions installed via pymac
  clear-cache:    Delete downloaded PKG installers
  default:        Set Python version symlinked to ~/.config/pymac/default
  default-which:  Show path to Python version symlinked to ~/.config/pymac/default
  exec:           Directly call specified Python version
  install:        Download and (re)install Python version
  list:           List Python versions installed via Python.org installer
  pyenv:          Manage symlinks of Python.org installations in $PYENV_ROOT/versions
  self-update:    Update pymac itself to the latest HEAD version
  uninstall:      Remove Python version
  update:         Update specified Python to the latest available Micro version (e.g. updates 3.10.1 to 3.10.2)
  update-all:     Update all pymac installs to latest available Micro versions

See 'pymac <command> help' for more information.