Installing Zipline via
pip is slightly more involved than the average
There are two reasons for the additional complexity:
- Zipline ships several C extensions that require access to the CPython C API.
In order to build the C extensions,
pipneeds access to the CPython header files for your Python installation.
- Zipline depends on numpy, the core library for numerical array computing in Python. Numpy depends on having the LAPACK linear algebra routines available.
Because LAPACK and the CPython headers are non-Python dependencies, the correct way to install them varies from platform to platform. If you’d rather use a single tool to install Python and non-Python dependencies, or if you’re already using Anaconda as your Python distribution, you can skip to the Installing with Conda section.
Once you’ve installed the necessary additional depdendencies (see below for your particular platform), you should be able to simply run
$ pip install zipline
On Debian-derived Linux distributions, you can acquire all the necessary
binary dependencies from
apt by running:
$ sudo apt-get install libatlas-base-dev python-dev gfortran pkg-config libfreetype6-dev
On recent RHEL-derived derived Linux distributions (e.g. Fedora), the following should be sufficient to acquire the necessary additional dependencies:
$ sudo dnf install atlas-devel gcc-c++ gcc-gfortran libgfortran python-devel redhat-rep-config
On Arch Linux, you can acquire the additional dependencies via
$ pacman -S lapack gcc gcc-fortran pkg-config
There are also AUR packages available for installing Python 3.4 (Arch’s default python is now 3.5, but Zipline only currently supports 3.4), and ta-lib, an optional Zipline dependency. Python 2 is also installable via:
$ pacman -S python2
The version of Python shipped with OSX by default is generally out of date, and has a number of quirks because it’s used directly by the operating system. For these reasons, many developers choose to install and use a separate Python installation. The Hitchhiker’s Guide to Python provides an excellent guide to Installing Python on OSX, which explains how to install Python with the Homebrew manager.
Assuming you’ve installed Python with Homebrew, you’ll also likely need the following brew packages:
$ brew install freetype pkg-config gcc openssl
Another way to install Zipline is via the
conda package manager, which
comes as part of Continuum Analytics’ Anaconda distribution.
The primary advantage of using Conda over
pip is that conda natively
understands the complex binary dependencies of packages like
scipy. This means that
conda can install Zipline and its dependencies
without requiring the use of a second tool to acquire Zipline’s non-Python
For instructions on how to install
conda, see the Conda Installation
Once conda has been set up you can install Zipline from our
conda install -c Quantopian zipline