Create a gist now

Instantly share code, notes, and snippets.

What would you like to do?
Multiple Python installations on OS X

Previous versions used homebrew to install the various versions. As suggested in the comments, it's better to use pyenv instead. If you are looking for the previous version of this document, see the revision history.

$ brew update
$ brew install pyenv
$ pyenv install 3.5.0
$ pyenv install 3.4.3
$ pyenv install 3.3.6
$ pyenv install 3.2.6
$ pyenv install 2.7.10
$ pyenv install 2.6.9
$ pyenv versions
* system (set by /Users/bouke/.pyenv/version)

Then, when you need a certain version:

pyenv local 3.5.0

This will create a file .python-version, so pyenv will remember the Python version for this directory. This works also nice with tox, as you can activate many Python version at once. See the pyenv documentation for more information.

See also Using tox and pyenv for testing and development for a more detailed how-to.

The Python 3.2 install will fail on newer versions of Homebrew because the formula is incompatible. I had to comment out lines 133-141 of Library/Formula/python3.rb and install Setuptools and Pip manually after the Python install finished.

Other than that, worked perfectly, thanks for taking the time to document this. :)

Thanks for this writeup -- very helpful. Also thanks tmhlinger for your tip.


Bouke commented Apr 7, 2015

The brew versions command has been removed. The instructions are no longer valid.

This worked perfectly for me, I just skipped the brew versions line.

tdsmith commented Sep 14, 2015

I'm a Homebrew maintainer; I strongly suggest you use pyenv instead if you ever need anything but the most current Python versions. It's a much nicer solution in part because it's designed to handle switching scripts back and forth, which is very difficult for Homebrew to do.


Bouke commented Sep 18, 2015

Thanks, I didn't know about pyenv, but found very useful already. I've updated the document as this looks like a better way to do this.

The link is broken:

Using tox and pyenv for testing and development


Bouke commented Sep 28, 2016

Thanks @denfromufa, I've updated the link.

matinfo commented Mar 20, 2017

Good to know, to not use default Python of OSX Sierra:

Add to your shell (~/.bashrc or ~/.zshrc) :

export PATH="/Users/username/.pyenv:$PATH"
eval "$(pyenv init -)"

Remplace username by your MacBook user.
Refresh your terminal env, example: $ source ~/.zshrc (or restart your terminal)

yanpeng commented Jun 8, 2017

@matinfo it saves me :-)

devhero commented Jun 12, 2017


Can also works using shims (pyenv doc):

export PATH="/shims:$PATH"
eval "$(pyenv init -)"

gino8080 commented Dec 3, 2017

great thankyou!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment