Installing and getting started

To install the latest release of seaborn, you can use pip:

pip install seaborn

It’s also possible to install the released version using conda:

conda install seaborn

Alternatively, you can use pip to install the development version directly from github:

pip install git+

Another option would be to to clone the github repository and install from your local copy:

pip install .


  • Python 2.7 or 3.5+

Mandatory dependencies


To test seaborn, run make test in the root directory of the source distribution. This runs the unit test suite (using pytest, but many older tests use nose asserts). It also runs the example code in function docstrings to smoke-test a broader and more realistic range of example usage.

The full set of tests requires an internet connection to download the example datasets (if they haven’t been previously cached), but the unit tests should be possible to run offline.


Please report any bugs you encounter through the github issue tracker. It will be most helpful to include a reproducible example on one of the example datasets (accessed through load_dataset()). It is difficult debug any issues without knowing the versions of seaborn and matplotlib you are using, as well as what matplotlib backend you are using to draw the plots, so please include those in your bug report.