Seaborn is a Python visualization library based on matplotlib. It provides a high-level interface for drawing attractive statistical graphics.

Online documentation is available at seaborn.pydata.org.

The docs include a tutorial, example gallery, API reference, and other useful information.

To build the documentation locally, please refer to doc/README.md.

Seaborn supports Python 3.6+ and no longer supports Python 2.

Installation requires numpy, scipy, pandas, and matplotlib. Some functions will optionally use statsmodels if it is installed.

The latest stable release (and older versions) can be installed from PyPI:

pip install seaborn

You may instead want to use the development version from Github:

pip install git+https://github.com/mwaskom/seaborn.git#egg=seaborn

Testing seaborn requires installing additional packages listed in ci/utils.txt.

To test the code, run make test in the source directory. This will exercise both the unit tests and docstring examples (using pytest) and generate a coverate report.

The doctests require a network connection (unless all example datasets are cached), but the unit tests can be run offline with make unittests.

Code style is enforced with flake8 using the settings in the setup.cfg file. Run make lint to check.

Seaborn development takes place on Github: https://github.com/mwaskom/seaborn

Please submit bugs that you encounter to the issue tracker with a reproducible example demonstrating the problem. Questions about usage are more at home on StackOverflow, where there is a seaborn tag.