pyfolio-reloaded 0.10.0

pyfolio is a Python library for performance and risk analysis of financial portfolios that works well with the Zipline open source backtesting library.

Maintenance and new development

We continue to maintain Pyfolio Reloaded for bug, security and compatibility fixes. Our new feature development focuses on the current ML4T libraries, including ML4T Diagnostic. For new projects, we recommend evaluating Diagnostic through its migration guide, which includes a runnable portfolio example and explains differences between the workflows. See the Diagnostic documentation for its supported APIs.

Trading Strategy Analysis with pyfolio

At the core of pyfolio are various tear sheets that combine various individual plots and summary statistics to provide a comprehensive view of the performance of a trading algorithm.

Here's an example of a simple tear sheet analyzing a strategy executed with the Zipline backtesting engine:

Performance Metrics

The tear sheet presents performance and risk metrics for the strategy separately during the backtest and out-of-sample periods:

Performance Plots

In addition, it visualizes how several risk and return metrics behave over time:

Installation

This source version targets Python 3.11-3.15. Python 3.9 and 3.10 are end of life and are retired from the next release. Existing release artifacts retain their original Python requirements. See the Python support schedule.

Python 3.14 requires pandas 2.3.3 and NumPy 2.3.3 or newer. Python 3.15 requires pandas 3.0.6 and NumPy 2.5.4 or newer; pandas 2.3.3 crashes during date-range construction in the stable CPython 3.15 Linux qualification. The dependency markers select the appropriate combination. Bottleneck currently builds from source on Python 3.15, so that installation needs a C compiler.

To install a published Pyfolio release into a supported environment, run:

pip install pyfolio-reloaded

The Conda channel contains historical releases:

conda install -c ml4t pyfolio-reloaded

The frozen Conda 0.9.4 recipe and existing channel artifacts are preserved. That recipe does not build this source version, and its publishing workflow is retired.

Development

Clone this repository, then create an isolated environment and install the declared extras:

uv venv --python 3.11
uv pip install -e '.[test,docs,dev]'
uv run pre-commit install

Usage

A good way to get started is to run the pyfolio examples in a Jupyter notebook. To do this, you first want to start a Jupyter notebook server:

jupyter notebook

From the notebook list page, navigate to the pyfolio examples directory and open a notebook. Execute the code in a notebook cell by clicking on it and hitting Shift+Enter.

Questions?

If you find a bug, feel free to open an issue in this repository.

You can also join our community.

Support

Please open an issue for support.

Contributing

Read the contribution guide before submitting an issue or pull request. This library accepts bug, security and compatibility fixes.

If you'd like to contribute, a great place to look is the issues marked with help-wanted.

For a list of core developers and outside collaborators, see the GitHub contributors list.