# plotnine
> A Grammar of Graphics for Python
- **URL**: https://www.freshcrate.ai/projects/plotnine
- **Author**: pypi
- **Category**: Frameworks
- **Latest version**: `v0.15.5` (2026-06-03)
- **License**: non-standard
- **Source**: https://github.com/has2k1/plotnine/actions
- **Homepage**: https://pypi.org/project/plotnine/
- **Language**: Python
- **GitHub**: 4,546 stars, 246 forks
- **Registry**: pypi (`plotnine`)
- **Tags**: `pypi`
## Description
# plotnine 
[](https://pypi.python.org/pypi/plotnine)
[](https://pypi.python.org/pypi/plotnine)
[](https://zenodo.org/badge/latestdoi/89276692)
[](https://github.com/has2k1/plotnine/actions?query=branch%3Amain+workflow%3A%22build%22)
[](https://codecov.io/github/has2k1/plotnine?branch=main)
plotnine is an implementation of a *grammar of graphics* in Python
based on [ggplot2](https://github.com/tidyverse/ggplot2).
The grammar allows you to compose plots by explicitly mapping variables in a
dataframe to the visual characteristics (position, color, size etc.) of objects that make up the plot.
Plotting with a *grammar of graphics* is powerful. Custom (and otherwise
complex) plots are easy to think about and build incrementally, while the
simple plots remain simple to create.
To learn more about how to use plotnine, check out the
[documentation](https://plotnine.org). Since plotnine
has an API similar to ggplot2, where it lacks in coverage the
[ggplot2 documentation](http://ggplot2.tidyverse.org/reference/index.html)
may be helpful.
## Example
```python
from plotnine import *
from plotnine.data import mtcars
```
Building a complex plot piece by piece.
1. Scatter plot
```python
(
ggplot(mtcars, aes("wt", "mpg"))
+ geom_point()
)
```
2. Scatter plot colored according some variable
```python
(
ggplot(mtcars, aes("wt", "mpg", color="factor(gear)"))
+ geom_point()
)
```
3. Scatter plot colored according some variable and
smoothed with a linear model with confidence intervals.
```python
(
ggplot(mtcars, aes("wt", "mpg", color="factor(gear)"))
+ geom_point()
+ stat_smooth(method="lm")
)
```
4. Scatter plot colored according some variable,
smoothed with a linear model with confidence intervals and
plotted on separate panels.
```python
(
ggplot(mtcars, aes("wt", "mpg", color="factor(gear)"))
+ geom_point()
+ stat_smooth(method="lm")
+ facet_wrap("gear")
)
```
5. Adjust the themes
I) Make it playful
```python
(
ggplot(mtcars, aes("wt", "mpg", color="factor(gear)"))
+ geom_point()
+ stat_smooth(method="lm")
+ facet_wrap("gear")
+ theme_xkcd()
)
```
II) Or professional
```python
(
ggplot(mtcars, aes("wt", "mpg", color="factor(gear)"))
+ geom_point()
+ stat_smooth(method="lm")
+ facet_wrap("gear")
+ theme_tufte()
)
```
## Installation
Official release
```console
# Using pip
$ pip install plotnine # 1. should be sufficient for most
$ pip install 'plotnine[extra]' # 2. includes extra/optional packages
$ pip install 'plotnine[test]' # 3. testing
$ pip install 'plotnine[doc]' # 4. generating docs
$ pip install 'plotnine[dev]' # 5. development (making releases)
$ pip install 'plotnine[all]' # 6. everything
# Or using conda
$ conda install -c conda-forge plotnine
# Or using pixi
$ pixi init name-of-my-project
$ cd name-of-my-project
$ pixi add python plotnine
```
Development version
```console
$ pip install git+https://github.com/has2k1/plotnine.git
```
## Contributing
Our documentation could use some examples, but we are looking for something
a little bit special. We have two criteria:
1. Simple looking plots that otherwise require a trick or two.
2. Plots that are part of a data analytic narrative. That is, they provide
some form of clarity showing off the `geom`, `stat`, ... at their
differential best.
If you come up with something that meets those criteria, we would love to
see it. See [plotnine-examples](https://github.com/has2k1/plotnine-examples).
If you discover a bug checkout the [issues](https://github.com/has2k1/plotnine/issues)
if i
## Recent releases
| Version | Date | Urgency | Changes |
| --- | --- | --- | --- |
| `v0.15.5` | 2026-06-03 | High | ## Bug Fixes - For interactive output, binary image data is now base64 encoded, making the output visible for `pyodide` blocks in `quarto-live` pages. |
| `v0.15.4` | 2026-05-05 | High | ## New - Bundled agent skills ## Bug Fixes - Allow `statsmodels==0.14.4` on `pyodide`, which bundles that version. Other platforms still require `statsmodels>=0.14.6` for pandas 3 compatibility. |
| `0.15.3` | 2026-04-21 | Low | Imported from PyPI (0.15.3) |
| `v0.15.3` | 2026-01-29 | Low | ### Enhancements - Removed warnings about copy-on-write for pandas >= 3.0.0 **Full Changelog**: https://github.com/has2k1/plotnine/compare/v0.15.2...v0.15.3 |
| `v0.15.3` | 2026-01-29 | Low | ### Enhancements - Removed warnings about copy-on-write for pandas >= 3.0.0 **Full Changelog**: https://github.com/has2k1/plotnine/compare/v0.15.2...v0.15.3 |
| `v0.15.3` | 2026-01-29 | Low | ### Enhancements - Removed warnings about copy-on-write for pandas >= 3.0.0 **Full Changelog**: https://github.com/has2k1/plotnine/compare/v0.15.2...v0.15.3 |
| `v0.15.3` | 2026-01-29 | Low | ### Enhancements - Removed warnings about copy-on-write for pandas >= 3.0.0 **Full Changelog**: https://github.com/has2k1/plotnine/compare/v0.15.2...v0.15.3 |
| `v0.15.3` | 2026-01-29 | Low | ### Enhancements - Removed warnings about copy-on-write for pandas >= 3.0.0 **Full Changelog**: https://github.com/has2k1/plotnine/compare/v0.15.2...v0.15.3 |
| `v0.15.3` | 2026-01-29 | Low | ### Enhancements - Removed warnings about copy-on-write for pandas >= 3.0.0 **Full Changelog**: https://github.com/has2k1/plotnine/compare/v0.15.2...v0.15.3 |
| `v0.15.3` | 2026-01-29 | Low | ### Enhancements - Removed warnings about copy-on-write for pandas >= 3.0.0 **Full Changelog**: https://github.com/has2k1/plotnine/compare/v0.15.2...v0.15.3 |
## Citation
- HTML: https://www.freshcrate.ai/projects/plotnine
- Markdown: https://www.freshcrate.ai/projects/plotnine.md
- Dependencies JSON: https://www.freshcrate.ai/api/projects/plotnine/deps
_Generated by freshcrate.ai. Indexes pypi releases for AI-agent ecosystem packages._