How do I use brew installed Python as the default Python?

Question

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 ?

Homebew no longer shadows the system installation of python. You can do: `export PATH="/usr/local/opt/python/libexec/bin:$PATH"` source: https://discourse.brew.sh/t/what-happened-to-the-standard-python-package/935 — George, Oct 16 '17 at 23:16
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. — Ujwal Ratra, Nov 16 '17 at 08:40
It's not recommended anymore to use Homebrew Python for local projects. See [Homebrew Python Is Not For You](https://justinmayer.com/posts/homebrew-python-is-not-for-you/) — fn control option, Feb 14 '22 at 18:17
if you're using python3, try 'which python3' . If that works then 'python3 --version' and 'pip3 --version' should work — Ashique Razak, May 02 '23 at 18:46

score 149 · Answer 1 · answered Jan 04 '18 at 18:19

149

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"

answered Jan 04 '18 at 18:19

Pamput

2,634
2
16
16

19

This is the correct method on High Sierra. Vote up! – tormodatt Jan 31 '18 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 '20 at 17:10
2

None of the other answers worked for me except this! running macOS Catalina here. Thanks! – HumbleBee May 17 '20 at 10:59
Seemed to work for big sur. Note: needed this for identifying where python was for OBS, since OBS seemed to require python 3.7. Brew installed 3.9. – Cognitiaclaeves Jun 10 '21 at 22:22
Getting python scripts in OBS actually turned out to be a thing. Leaving this here, in case someone happens upon the trail: https://obsproject.com/forum/threads/mac-python-support-in-obs-26.130960/post-530313 . – Cognitiaclaeves Jun 11 '21 at 01:41
Works on macOS Monterey – Greg Lukosek Jan 06 '22 at 12:03
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) – pierrepinard_2 Aug 22 '22 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" . – Adam Dingle Dec 18 '22 at 15:55
1

This is just adding to all the OP comments here. export PATH="/opt/homebrew/opt/python@3.8/libexec/bin:$PATH" seemed to work for me. NOTE: Add the version number while adding the export to your profile file either .zprofile or .bashrc or .zshrc – igmrrf May 18 '23 at 15:25

score 133 · Answer 2 · edited Jan 08 '18 at 12:12

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.

edited Jan 08 '18 at 12:12

bbaassssiiee

6,013
2
42
55

answered Sep 11 '11 at 00:37

Vishal

19,879
23
80
93

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 02 '13 at 19:01
1

many programs use /usr/bin/python in the header making this not a viable solution. – michael.schuett Jul 07 '15 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 '18 at 13:45

score 108 · Answer 3 · edited May 23 '17 at 12:02

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

edited May 23 '17 at 12:02

Community

1
1

answered Feb 01 '13 at 11:35

akauppi

17,018
15
95
120

14

why doesn't this happen when I brew install python? – Ben West Feb 07 '14 at 01:31
4

@BenWest because python3, now you get python2 rather then python. – georgexsh Sep 14 '17 at 20:20
@theonlygusti that is likely due to System Integrity protection. – Vineet Reynolds Feb 28 '18 at 14:33
2

I don't have it enabled. – theonlygusti Feb 28 '18 at 15:26
2

In my case, I needed to restart the terminal after running this command (as noted by [Martijn Courteaux's answer](https://stackoverflow.com/a/39828525/3427178)) – jkmartindale Jun 29 '18 at 21:11
2

this links python@2 for me – Andrew B. Dec 21 '18 at 01:09
um that doesn't work... `brew link --overwrite python` says `Warning: Already linked: /usr/local/Cellar/python@3.9/3.9.5` but then `which python` still points to `/usr/bin/python` and `python --version` is still `python 2.7.16`. – Daniel May 20 '21 at 23:54

TruMan1 · Answer 4 · 2023-03-11T13:22:11.910

80

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.

edited Mar 11 '23 at 13:22

answered Jan 12 '22 at 14:20

TruMan1

33,665
59
184
335

11

it looks like python version should be specified: `/opt/homebrew/opt/python@3.10/libexec/bin/` – Alex Bender Jul 15 '22 at 13:37
1

Thank you — that worked for me on my M1 MacBook (and nothing else here did!) – Sam Dutton Oct 01 '22 at 13:16
1

This worked when nothing else did on Mac M1. Thanks! – seizethedata Jan 10 '23 at 12:50
This is the correct answer for ARM Macs, thanks a lot! – A. Steenbergen Jul 06 '23 at 06:51
Worked for me. Thanks! – Hamza Awan Sep 01 '23 at 16:07

score 68 · Answer 5 · answered Mar 22 '12 at 11:04

68

Quick fix:

Open /etc/paths
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/

answered Mar 22 '12 at 11:04

Bijan

25,559
8
79
71

2

Thank you, all above answers did solve my problem, but your did! Thank you so much! – Sean Aug 16 '12 at 00:02
7

the problem with this is that it changes it for all users :/, IMO it's better to change something more specific. – Randall Hunt Jul 30 '13 at 15:48
1

@RandallHunt like what and how? – Mike Kormendy Feb 11 '20 at 04:53

score 49 · Answer 6 · edited Jan 23 '18 at 21:14

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

edited Jan 23 '18 at 21:14

Kirkland

3,257
1
16
17

answered Jan 18 '18 at 04:52

Sachin Khot

1,412
2
14
18

4

Confirmed this fixes the issue on High Sierra – RandomDeduction Feb 07 '18 at 17:33
You are my hero. Can't believe I didn't realize this solution! – Smokin Joe Feb 23 '18 at 23:22
3

Also need restarting the terminal for apply – lexa-b Feb 27 '18 at 10:33
3

$ cd /usr/local/bin $ ln -s python3 python – Pnemonic Mar 28 '18 at 06:34
1

and I suppose also sym-link pip to pip3 (or pip2)? – alexP_Keaton Sep 11 '18 at 00:46
fixed my problem with python3.9 on Big sur – ibrahim Jul 07 '21 at 10:06

score 29 · Answer 7 · answered Apr 03 '18 at 13:15

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:

doing this will shadow the system default version of python
homebrew used to link python to /usr/local/share/python in older versions.

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 09 '18 at 02:37

Adam Vandenberg · Answer 8 · 2013-01-11T05:33:14.403

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.

edited Jan 11 '13 at 05:33

answered Mar 01 '11 at 17:08

Adam Vandenberg

19,991
9
54
56

2

But it doesn't! – theonlygusti Jan 30 '17 at 20:29

score 16 · Answer 9 · answered Apr 01 '12 at 10:59

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

answered Apr 01 '12 at 10:59

Aben

161
1
4

My editor "PyCharm" was using ~/.bashrc and I was unable to get brew's python working until this little gem. Thanks @Aben – JamesDeHart Dec 11 '16 at 05:27

score 15 · Answer 10 · answered Oct 03 '16 at 09:34

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.

answered Oct 03 '16 at 09:34

Martijn Courteaux

67,591
47
198
287

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`? – Con Antonakos Dec 04 '16 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 '17 at 06:50
2

restart terminal is not necessary, try `hash -r` – georgexsh Sep 08 '17 at 05: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 08 '18 at 08:46

score 10 · Answer 11 · answered Mar 01 '11 at 17:03

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.

score 7 · Answer 12 · answered Mar 05 '18 at 16:53

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.

score 6 · Answer 13 · answered Nov 13 '12 at 15:55

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.

score 5 · Answer 14 · answered Aug 16 '19 at 09:01

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.

answered Aug 16 '19 at 09:01

Dmytro Melnychuk

2,285
21
23

score 5 · Answer 15 · answered Apr 23 '20 at 21:30

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.

score 2 · Answer 16 · answered Dec 03 '17 at 08:05

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!

answered Dec 03 '17 at 08:05

Aaditya Prasad

29
1

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 05 '17 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 '17 at 18:59

Christian Oviedo Gabarda · Answer 17 · 2019-02-13T15:59:05.527

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!

edited Feb 13 '19 at 15:59

answered Feb 13 '19 at 15:52

Christian Oviedo Gabarda

127
1
7

score 1 · Answer 18 · answered Feb 20 '20 at 02:58

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

answered Feb 20 '20 at 02:58

KelaKing

146
8

score 1 · Answer 19 · answered Mar 01 '22 at 12:54

1

try this

which python3

Try typing python3 instead of just python

answered Mar 01 '22 at 12:54

Muhammad Hashir uddin

47
5

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. – Anton Chikin Aug 29 '22 at 13:44

score 1 · Answer 20 · answered Jul 03 '22 at 13:30

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 python@3.10
» echo 'export PATH="/usr/local/opt/python@3.10/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.

score 0 · Answer 21 · answered Feb 28 '19 at 00:36

0

Since High Sierra, you need to use:

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

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

answered Feb 28 '19 at 00:36

zaolian

1,187
3
11
21

score 0 · Answer 22 · answered Nov 20 '21 at 17:55

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'

score 0 · Answer 23 · answered May 27 '23 at 19:14

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.

answered May 27 '23 at 19:14

Gishas

380
6
21

score 0 · Answer 24 · answered Jul 21 '23 at 17:30

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/python@3.11/libexec/bin:$PATH"

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

How do I use brew installed Python as the default Python?

24 Answers24

Linked

Related