pyfolio is a Python library for performance and risk analysis of financial portfolios developed by Quantopian Inc. It works well with the Zipline open source backtesting library.
At the core of pyfolio is a so-called tear sheet that consists of
various individual plots that provide a comprehensive image of the
performance of a trading algorithm. Here is an example of a tear sheet of a the Zipline algo included as one of our example notebooks:
See also slides of a recent talk about pyfolio.
For development on pyfolio itself, you might want to use a virtual environment to avoid dependency conflicts between pyfolio
and other python projects you have. To get set up with a virtual env, run:
mkvirtualenv pyfolio
before running the install commands below.
To install pyfolio
via pip
issue the following command:
pip install pyfolio
For development, clone the git repo and run python setup.py develop
and edit the library files directly. Make sure to reload or restart
the IPython kernel when you make changes.
pyfolio
has the following dependencies:
- numpy
- scipy
- pandas
- matplotlib
- seaborn
- pymc3 (optional)
- zipline (optional; requires master, not 0.7.0)
Some of Pyfolio's functionality, such as the Bayesian tearsheet, requires PyMC3 and Theano. To get set up, you can run:
pip install theano
pip install git+https://github.com/pymc-devs/pymc3
If you are on OSX and using a non-framework build of python you may need to set your backend:
echo "backend: TkAgg" > ~/.matplotlib/matplotlibrc
A good way to get started is to run the examples in a Jupyter notebook.
To get set up with an example, you can:
Run a Jupyter notebook server via:
jupyter notebook
From the notebook list page(usually found at http://localhost:8888/
), navigate over to the examples directory, and open any file with a .ipynb extension.
Execute the code in a notebook cell by clicking on it and hitting Shift+Enter.
If you find a bug, feel free to open an issue on our github tracker.
You can also join our mailing list.
If you want to contribute, a great place to start would be the help-wanted issues.
- Gus Gordon (gus@quantopian.com)
- Justin Lent (justin@quantopian.com)
- Sepideh Sadeghi (sp.sadeghi@gmail.com)
- Thomas Wiecki (thomas@quantopian.com)
- Jessica Stauth (jstauth@quantopian.com)
- Karen Rubin (karen@quantopian.com)
- David Edwards (dedwards@quantopian.com)
- Andrew Campbell (andrew@quantopian.com)
For a full list of contributors, see https://github.com/quantopian/pyfolio/graphs/contributors.