Skip to content

Instantly share code, notes, and snippets.

Last active August 3, 2023 01:46
Show Gist options
  • Save Bouke/11261620 to your computer and use it in GitHub Desktop.
Save Bouke/11261620 to your computer and use it in GitHub Desktop.
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.

Copy link

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.

Copy link

The link is broken:

Using tox and pyenv for testing and development

Copy link

I believe the new link is now here:

Copy link

Bouke commented Sep 28, 2016

Thanks @denfromufa, I've updated the link.

Copy 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)

Copy link

yanpeng commented Jun 8, 2017

@matinfo it saves me :-)

Copy link

devhero commented Jun 12, 2017


Can also works using shims (pyenv doc):

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

Copy link

gino8080 commented Dec 3, 2017

great thankyou!

Copy link

Nice work~

Copy link

nachozt commented Mar 8, 2018


Copy link

Thank you guys!

Copy link

Thank you 👍

Copy link

yes, very helpful!

Copy link

pyenv install 3.7.2
python-build: use openssl from homebrew
python-build: use readline from homebrew
Downloading Python-3.7.2.tar.xz...
Installing Python-3.7.2...
python-build: use readline from homebrew

BUILD FAILED (OS X 10.14.3 using python-build 20180424)

Inspect or clean up the working tree at /var/folders/g_/9zn58k_16m50w1z3tqvq65xr0000gn/T/python-build.20190214115852.93619
Results logged to /var/folders/g_/9zn58k_16m50w1z3tqvq65xr0000gn/T/python-build.20190214115852.93619.log

Last 10 log lines:
File "/private/var/folders/g_/9zn58k_16m50w1z3tqvq65xr0000gn/T/python-build.20190214115852.93619/Python-3.7.2/Lib/ensurepip/", line 5, in
File "/private/var/folders/g
/9zn58k_16m50w1z3tqvq65xr0000gn/T/python-build.20190214115852.93619/Python-3.7.2/Lib/ensurepip/", line 204, in main
File "/private/var/folders/g
/9zn58k_16m50w1z3tqvq65xr0000gn/T/python-build.20190214115852.93619/Python-3.7.2/Lib/ensurepip/", line 117, in _bootstrap
return _run_pip(args + [p[0] for p in PROJECTS], additional_paths)
File "/private/var/folders/g
/9zn58k_16m50w1z3tqvq65xr0000gn/T/python-build.20190214115852.93619/Python-3.7.2/Lib/ensurepip/", line 27, in _run_pip
import pip._internal
zipimport.ZipImportError: can't decompress data; zlib not available
make: *** [install] Error 1

Copy link

LongBu commented Feb 20, 2019


Try the following:

CFLAGS="-I$(brew --prefix readline)/include -I$(brew --prefix openssl)/include -I$(xcrun --show-sdk-path)/usr/include" LDFLAGS="-L$(brew --prefix readline)/lib -L$(brew --prefix openssl)/lib" PYTHON_CONFIGURE_OPTS=--enable-unicode=ucs2 pyenv install -v 3.7.2


Copy link

Yikes! I had the same error as @crapthings and the arcane incantation from @LongBu made my screen puke all fun kinds of output and eventually ended with:

Collecting setuptools
Collecting pip
Installing collected packages: setuptools, pip
Successfully installed pip-18.1 setuptools-40.6.2
/var/folders/rz/fjd3x9jn24n8kxhybt17yh_40000gn/T/python-build.20190224164731.13157 ~
Installed Python-3.7.2 to /Volumes/DATA_MAC/brad/.pyenv/versions/3.7.2

... and pyenv versions lists 3.7.2
Thank you.

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