Installation

For most users, we recommend installing the official release of Plotnine.

Installing the official release

The official release can be installed from the command line using either pip, uv, or conda:

# Using pip:
$ pip install plotnine

# Using uv:
$ uv pip install plotnine

# Using conda:
$ conda install -c conda-forge plotnine

Note

For uv you need to have a virtual environment, which you can create using uv venv. Read more information about installing and using uv.

For some functionality you may need to install extra packages. Those packages include:

adjustText: For automatic label placement
geopandas: For working with for geographic data
scikit-learn: For Gaussian Process smoothing
scikit-misc: For LOESS smoothing

These four packages can be installed in one go by specifying 'plotnine[extra]' instead of plotnine:

# Using pip:
$ pip install 'plotnine[extra]'

# Using uv:
$ uv pip install 'plotnine[extra]'

# Using conda:
$ conda install -c conda-forge 'plotnine[extra]'

Installing the development version

Plotnine is under active development. It may happen that a bugfix or new feature is not yet available in the official release. In those cases you can install the latest development version from GitHub:

# Using pip:
$ pip install git+https://github.com/has2k1/plotnine.git

# Using uv:
$ uv pip install git+https://github.com/has2k1/plotnine.git

To contribute to Plotnine’s source code, you have to clone the Plotnine source repository and install the package in development mode:

$ git clone https://github.com/has2k1/plotnine.git
$ cd plotnine
$ pip install -e .