This is a step-by-step installation guide to setup a scientific python environment on Mac OS X 10.9 Mavericks with homebrew.
An older version of this setup guide can be found here: Scientific Python on Mac OS X 10.8 with homebrew, main changes: rename of a tap + changes wrt. openblas as Accelerate was fixed in OS X 10.9
Needless to say: Make a backup (Timemachine)
First install homebrew.
Follow their instructions, then come back here.
If you don’t have a clean install, some of the following steps might need minor additional attention (like changing permissions
chgrp or overwriting existing files in the linking step with
brew link --overwrite package_that_failed. In this case i can only recommend a backup again).
In general: execute the following commands one line at a time and read the outputs! If you read some warnings about “keg-only” that’s fine, it just means that brew won’t “hide” your system’s stuff behind the stuff it installed itself so it doesn’t cause problems… brewed stuff will still use it.
brew tap homebrew/science # a lot of cool formulae for scientific tools
brew tap homebrew/python # numpy, scipy
brew update && brew upgrade
# install a brewed python
brew install python
Now make sure that you actually run python from brew, not your system:
# should say /usr/local/bin/python
# /usr/local/bin should appear in front of /usr/bin
If this is not the case you’d probably end up not using brewed python. Please check your brew install with
brew doctor, it will probably tell you that you should consider updating your paths in
~/.bashrc. You can either follow its directions or create a
~/.profile file like this one: ~/.profile. If you performed these steps please close your terminal windows and open a new one for the changes to take effect.
# image generating stuff (qt is nice for viewing)
ln -s /usr/local/include/freetype2 /usr/local/include/freetype # seems freetype can't be found on some systems otherwise
brew install pillow imagemagick graphviz
brew install cairo --without-x
brew install py2cairo # this will ask you to download xquartz and install it
brew install qt pyqt
# install nose (unittests & doctests on steroids)
pip install virtualenv nose
# install numpy and scipy
# the faster default below now works, but you can still use openblas if you like
#brew install openblas
brew install numpy # --with-openblas
brew install scipy # --with-openblas
# test the numpy & scipy install
brew test numpy
brew test scipy
# some cool python libs (if you don't know them, look them up)
# time series stuff, natural language toolkit
# generate plots, symbolic maths in python, fancy debugging output
pip install pandas nltk
brew install matplotlib
pip install sympy q
# ipython and notebook support
brew install zmq
pip install ipython[zmq,qtconsole,notebook,test]
# html stuff (parsing)
pip install html5lib cssselect pyquery lxml BeautifulSoup
# webapps / apis (choose what you like)
pip install Flask Django
# semantic web stuff: rdf & sparql
pip install rdflib SPARQLWrapper
As always: If you think something is missing / wrong leave a comment.
2014-03-02: include checking of
$PATH for Mike