285

I try to switch to Homebrew (after using fink and macport) on Mac OS X 10.6.2. I have installed python 2.7 with

brew install python 

The problem is that, contrary to Macport, it seems that there is no python_select utility, and my default mac python is always default

which python

give me

/usr/bin/python

and /usr/bin/python is not a symlink

How can I do to make python brew flavour to be my default python ?

5
  • 24
    Homebew no longer shadows the system installation of python. You can do: export PATH="/usr/local/opt/python/libexec/bin:$PATH" source: discourse.brew.sh/t/…
    – George
    Oct 16, 2017 at 23:16
  • 3
    I tried all the mentioned answers, /usr/local/bin comes before /usr/bin in my $PATH. I tried brew link and unlink, brew doctor didn't report the /usr/bin being before /usr/local/bin an issue. Still when I do which python, I get /usr/bin/python and not the one installed with brew. Nov 16, 2017 at 8:40
  • 1
    try... which python2
    – Fraser
    Feb 10, 2018 at 18:43
  • 2
    It's not recommended anymore to use Homebrew Python for local projects. See Homebrew Python Is Not For You Feb 14, 2022 at 18:17
  • if you're using python3, try 'which python3' . If that works then 'python3 --version' and 'pip3 --version' should work May 2 at 18:46

24 Answers 24

150

As suggested by the homebrew installer itself, be sure to add this to your .bashrc or .zshrc:

export PATH="/usr/local/opt/python/libexec/bin:$PATH"
9
  • 19
    This is the correct method on High Sierra. Vote up!
    – tormodatt
    Jan 31, 2018 at 11:08
  • 1
    MacOS defaults to the zsh terminal, so chances are it is the .zshrc file and not the .bashrc file that needs to change.
    – user394430
    Mar 30, 2020 at 17:10
  • 2
    None of the other answers worked for me except this! running macOS Catalina here. Thanks!
    – HumbleBee
    May 17, 2020 at 10:59
  • 11
    For MacOS on Apple Silicon/ARM, this will rather be: export PATH="/opt/homebrew/opt/python/libexec/bin:$PATH" (Homebrew's default location is different) Aug 22, 2022 at 14:50
  • 4
    On my machine (MacOS Ventura, Apple M1) it needed to be: export PATH="/opt/homebrew/opt/python@3/libexec/bin:$PATH" . Dec 18, 2022 at 15:55
133

As you are using Homebrew the following command gives a better picture:

brew doctor

Output:

==> /usr/bin occurs before /usr/local/bin This means that system-provided programs will be used instead of those provided by Homebrew. This is an issue if you eg. brew installed Python.

Consider editing your .bash_profile to put: /usr/local/bin ahead of /usr/bin in your $PATH.

3
  • 4
    Make sure that you don't have /user/local/bin TWICE in your path. For some reason in my PATH it appeared both before and after /usr/bin and it was driving me crazy.
    – vinaut
    Oct 2, 2013 at 19:01
  • 1
    many programs use /usr/bin/python in the header making this not a viable solution. Jul 7, 2015 at 20:15
  • 6
    for brew in High Sierra only python2 is in /usr/local/bin, for just python; set export PATH="/usr/local/opt/python/libexec/bin:$PATH" in ~/.bash_profile
    – tormodatt
    Jan 31, 2018 at 13:45
108

See: How to symlink python in Homebrew?

$ brew link --overwrite python
Linking /usr/local/Cellar/python/2.7.3... 28 symlinks created
$ which python
/usr/local/bin/python
7
  • 14
    why doesn't this happen when I brew install python?
    – Ben West
    Feb 7, 2014 at 1:31
  • 4
    @BenWest because python3, now you get python2 rather then python.
    – georgexsh
    Sep 14, 2017 at 20:20
  • 2
    I don't have it enabled. Feb 28, 2018 at 15:26
  • 2
    In my case, I needed to restart the terminal after running this command (as noted by Martijn Courteaux's answer) Jun 29, 2018 at 21:11
  • 2
    this links python@2 for me
    – Andrew B.
    Dec 21, 2018 at 1:09
82

For Apple Silicon machines, the path are slightly different. After running brew install python, you must ensure your ~/.zshrc uses the correct Homebrew paths:

# Homebrew
eval "$(/opt/homebrew/bin/brew shellenv)"

# Homebrew: Python
export PATH="/opt/homebrew/opt/python/libexec/bin:$PATH"

Results:

% which python
/opt/homebrew/opt/python/libexec/bin/python

% python --version
Python 3.9.9

% which pip
/opt/homebrew/opt/python/libexec/bin/pip

% pip -V
pip 21.3.1 from /opt/homebrew/lib/python3.9/site-packages/pip (python 3.9)

UPDATE 2023

Brew python changed it's location again and had to update my ~/.zshrc to:

export PATH="$(brew --prefix)/opt/python@3/libexec/bin:$PATH"

There isn't a .../opt/python/... anymore which is annoying because now I have to specify v3 explicitly, but at least better than having to specify the minor version like in the comments.

5
  • 12
    it looks like python version should be specified: /opt/homebrew/opt/[email protected]/libexec/bin/ Jul 15, 2022 at 13:37
  • 1
    Thank you — that worked for me on my M1 MacBook (and nothing else here did!)
    – Sam Dutton
    Oct 1, 2022 at 13:16
  • 1
    This worked when nothing else did on Mac M1. Thanks! Jan 10 at 12:50
  • This is the correct answer for ARM Macs, thanks a lot! Jul 6 at 6:51
  • Worked for me. Thanks!
    – Hamza Awan
    Sep 1 at 16:07
68

Quick fix:

  1. Open /etc/paths
  2. Change the order of the lines (highest priority on top)

In my case /etc/paths looks like:

/usr/local/bin
/usr/local/sbin
/usr/bin
/bin
/usr/sbin
/sbin

If you want to know more about paths in OSX I found this article quite useful:

http://muttsnutts.github.com/blog/2011/09/12/manage-path-on-mac-os-x-lion/

3
  • 2
    Thank you, all above answers did solve my problem, but your did! Thank you so much!
    – Sean
    Aug 16, 2012 at 0:02
  • 7
    the problem with this is that it changes it for all users :/, IMO it's better to change something more specific. Jul 30, 2013 at 15:48
  • 1
    @RandallHunt like what and how? Feb 11, 2020 at 4:53
49

I did "brew install python" for OSX High Sierra. The $PATH had /usr/local/bin before any other path but still which python was pointing to the system's python.

When I looked deeper I found that there is no python executable at /usr/local/bin. The executable is named python2. To fix this problem create a symbolic link python pointing to python2:

/usr/local/bin $: ln -s python2 python

6
  • 4
    Confirmed this fixes the issue on High Sierra Feb 7, 2018 at 17:33
  • You are my hero. Can't believe I didn't realize this solution!
    – Smokin Joe
    Feb 23, 2018 at 23:22
  • 3
    Also need restarting the terminal for apply
    – lexa-b
    Feb 27, 2018 at 10:33
  • 3
    $ cd /usr/local/bin $ ln -s python3 python
    – Pnemonic
    Mar 28, 2018 at 6:34
  • 1
    and I suppose also sym-link pip to pip3 (or pip2)? Sep 11, 2018 at 0:46
29

python formula now uses python3(v3.6.5 for now), brew will link the directory:

/usr/local/opt/python -> ../Cellar/python/3.6.5

it will also link the binary:

/usr/local/bin/python3 -> ../Cellar/python/3.6.5/bin/python3

If you still need to use python2.x, use:

brew install python@2

To use homebrew's python, just put its directory in PATH, for bash:

export PATH="/usr/local/opt/python/libexec/bin:$PATH"

for fish:

set -x PATH /usr/local/opt/python/libexec/bin $PATH

Note:

  1. doing this will shadow the system default version of python
  2. homebrew used to link python to /usr/local/share/python in older versions.
1
  • This was the trick for me. By default, brew installs python3 in your path - not an exec called python.. Specifically referencing /usr/local/opt/python/libeexec/bin ahead of other directories in my path sorted things out.
    – cam8001
    Jul 9, 2018 at 2:37
24

Homebrew does NOT replace stuff in "/usr/bin". You'll just want to put "/usr/local/bin" ahead of "/usr/bin" in your path, then "which python" will give you "/usr/local/bin/python".

Replacing /usr/bin/python (or /usr/bin/ruby) is highly unrecommended.

1
16

Modify your $PATH, Add this in your bashrc or bash_profile:

export PATH=/usr/local/bin:/usr/local/sbin:~/bin:$PATH

more click here: Issue #89791

1
  • My editor "PyCharm" was using ~/.bashrc and I was unable to get brew's python working until this little gem. Thanks @Aben Dec 11, 2016 at 5:27
15

I did brew install python, my $PATH was good, but still, which python gave me the system installed one. Restarting the terminal fixed it.

4
  • 1
    This is all I needed to do. I'm not sure when to do this, though. It sounds like just execute brew install python and then, restart terminal, and nothing else? No need to brew unlink & brew link? Dec 4, 2016 at 23:40
  • Right after installed python using brew, "which python" give me the correct local python path, but "python" command indicated that it was the system installed one invoking. Restart terminal fixed it.
    – Michelle
    Feb 20, 2017 at 6:50
  • 2
    restart terminal is not necessary, try hash -r
    – georgexsh
    Sep 8, 2017 at 5:13
  • JFC, I was losing my mind until I read this. I already did brew unlink & brew link several times. Only needed to restart the terminal
    – Dominic
    Jan 8, 2018 at 8:46
10

You need to edit your PATH environmental variable to make sure wherever the homebrew python is located is searched before /usr/bin. You could also set things up in your shell config to have a variable like PYTHON be set to your desired version of python and call $PYTHON rather than python from the command line.

Also, as another poster stated (and especially on mac) DO NOT mess with the python in /usr/bin to point it to another python install. You're just asking for trouble if you do.

7

python now points to python3, if you need python 2 then do: brew install python@2 and then in your .zshrc or .bashrc file export PATH="/usr/local/opt/python@2/libexec/bin:$PATH" Now, pyhon --version = Python 2.7.14 and python3 --version = Python 3.6.4. That's the behavior I'm used to seeing in my terminal.

6

I believe there are means to make homebrew python default, but in my opinion the proper way to solve a problem is not to mess with system python paths: it is better to create a virtualenv in which homebrew python would be default (by using virtualenv --python option). Using tools like python_select is almost always a bad idea.

5

Add the /usr/local/opt/python/libexec/bin explicitly to your .bash_profile:

export PATH="/usr/local/opt/python/libexec/bin:$PATH"

After that, it should work correctly.

5

Use pyenv instead to install and switch between versions of Python. I've been using rbenv for years which does the same thing, but for Ruby. Before that it was hell managing versions.

Consult pyenv's github page for installation instructions. Basically it goes like this: - Install pyenv using homebrew. brew install pyenv - Add a function to the end of your shell startup script so pyenv can do it's magic. echo -e 'if command -v pyenv 1>/dev/null 2>&1; then\n eval "$(pyenv init -)"\nfi' >> ~/.bash_profile

  • Use pyenv to install however many different versions of Python you need. pyenv install 3.7.7.
  • Set the default (global) version to a modern version you just installed. pyenv global 3.7.7.
  • If you work on a project that needs to use a different version of python, look into pyevn local. This creates a file in your project's folder that specifies the python version. Pyenv will look override the global python version with the version in that file.
2

Just do:

brew install python
brew link python

After doing that, add this to your bashrc or bash_profile:

alias python='/usr/local/bin/python2'

Enjoy!

2
  • It sounds like you ran into the same problem I did. All the links that brew creates, even with the link commands in answers here, in /usr/local/bin are for python2 instead of python. Using an alias to work around this seems like a bad idea, but I haven't found anything better yet.
    – Patrick M
    Dec 5, 2017 at 17:15
  • Rather than alias, I just copied it cp /usr/local/bin/python2 /usr/local/bin/python and it seemed to work well. Is this an even uglier work-around?
    – kingb12
    Dec 20, 2017 at 18:59
1

You can edit /etc/paths. Here is mine:

/usr/local/bin
/usr/bin
/bin
/usr/sbin
/sbin

Then add a symlink for the python version. In my case

$ cd /usr/local/bin
$ ln -s python3 python

Voila!

1

If you are fish shell

echo 'set -g fish_user_paths "/usr/local/opt/python/libexec/bin" $fish_user_paths' >> ~/.config/fish/config.fish
1

try this

which python3

Try typing python3 instead of just python

1
  • 1
    The issue emerges when some of the scripts are trying to use python command, so you can't simply replace python with python3 everywhere. Aug 29, 2022 at 13:44
1

Greeting folks! I have the need to use python 3.10 version to harness its new features. My solved solution at 2022-07-03 is as follows. Have fun coding python!

» rm '/usr/local/bin/pip3.10'
» brew link [email protected]
» echo 'export PATH="/usr/local/opt/[email protected]/bin:$PATH"' >> ~/.zshrc
» python3
Python 3.10.5 (main, Jun 23 2022, 17:15:25) [Clang 13.1.6 (clang-1316.0.21.2.5)] on darwin
Type "help", "copyright", "credits" or "license" for more information.
0

Since High Sierra, you need to use:

sudo chown -R $(whoami) $(brew --prefix)/*

This is because /usr/local can no longer be chowned

0
brew link python

And you must create/add an alias for python and put it in your .zprofile (Located in Users/username folder, if you press Shift+command+.

This must point to your homebrew python installation location.

alias python ='opt/homebrew/bin/python3'
0

Well just in case anyone needed something I needed i.e. just to play around with Python a bit, you may as well call it from terminal with

python3 my_python_file.py

considering python 3.x is installed, of course, in my case using brew.

0

On Mac OS X, if you installed Python3 via Homebrew with brew install python3, then you need to run the following command via terminal:

export PATH="/usr/local/opt/[email protected]/libexec/bin:$PATH"

This is for the latest Python version 3.11. Make sure to edit the command to correspond with your Python version.

Not the answer you're looking for? Browse other questions tagged or ask your own question.