1# Install instructions
2
3## OS X
4
5Recomended way is using brew and pip.
6
7- Get Homebrew http://brew.sh
8- Install XCode and Command Line Tools
9- More information https://github.com/mxcl/homebrew/wiki/Installation
10
11Make sure that brew is fresh and updated:
12```
13$ brew doctor
14```
15Fix errors
16```
17$ brew update
18$ brew upgrade
19$ brew install python icu4c
20```
21Install needed python libraries:
22```
23$ pip-2.7 install --upgrade nose python-dateutil pyparsing
24```
25Install numpy:
26```
27$ brew tap homebrew/science
28$ brew install samueljohn/python/numpy
29```
30This part takes even more time to download and compile all `numpy` dependencies. It can take a while.
31
32Now you can install `matplotlib` dependency (prefereable way is inside of `virtualenv`, but it is out of the scope of this tutorial.)
33```
34$ ln -s /usr/local/opt/freetype/include/freetype2 /usr/local/include/freetype
35$ pip install matplotlib
36```
37Now your system is ready to install pyfontaine:
38```
39$ pip install fontaine
40```
41At this stage you can also download the github source and run
42```
43$ python setup.py install
44```
45
46## From Source
47
48```sh
49mkdir ~/src;
50cd ~/src;
51git clone git://github.com/googlefonts/pyfontaine'
52cd pyfontaine'
53git submodule init;
54git submodule update;
55# then setup
56sudo python setup.py install;
57```
58