+5
日增长
18,904
stars
2,897
forks
270
watchers
2,284
prs
3,403
issues
109
releases
README
plotly.py
Latest Release
User forum
PyPI Downloads
License
Quickstart
Graph Objects
pip install plotly
python
import plotly.graph_objects as go
fig = go.Figure()
fig.add_trace(go.Bar(x=["a", "b", "c"], y=[1, 3, 2]))
fig.show()
Plotly Express
pip install plotly[express]
python
import plotly.express as px
fig = px.bar(x=["a", "b", "c"], y=[1, 3, 2])
fig.show()
You'll also need to install a supported dataframe library.
See the Python documentation for more examples.
Overview
plotly.py is an interactive, open-source, and browser-based graphing library for Python :sparkles:
Built on top of plotly.js, plotly.py is a high-level, declarative charting library. plotly.js ships with over 30 chart types, including scientific charts, 3D graphs, statistical charts, SVG maps, financial charts, and more.
plotly.py is MIT Licensed. Plotly graphs can be viewed in Jupyter notebooks, other Python notebook software such as marimo, as standalone HTML files, or integrated into Dash applications.
Contact us for consulting, dashboard development, application integration, and feature additions.
---
- Online Documentation
- Contributing to plotly
- Changelog
- Code of Conduct
- Community forum
---
Installation
plotly.py may be installed using pip
pip install plotly
or conda.
conda install -c conda-forge plotly
Jupyter Widget Support
For use as a Jupyter widget, install jupyter and anywidget
packages using pip:
pip install jupyter anywidget
or conda:
conda install jupyter anywidget
Static Image Export
plotly.py supports static image export,
using the kaleido
package (version 1.0 or greater).
Kaleido has minimal dependencies and can be installed
using pip
pip install -U kaleido
or conda
conda install -c conda-forge python-kaleido
Kaleido requires Chrome or Chromium to generate images. By default, Kaleido will use the Chrome or Chromium version already installed on your system. If you don't have it installed or Kaleido can't find it, you may need to install it by running the command:
plotly_get_chrome
on your command line.
Copyright and Licenses
Code and documentation copyright 2026 Plotly, Inc.
Code released under the MIT license.
Docs released under the Creative Commons license.Top issues
#3535Make marker size absolute in scatterplot26 comments · 2021-12-29#801Plotting DataFrame with timedelta64 (y-axis)25 comments · 2017-07-22#2570Choropleth_mapbox and FigureWidget - 'mapbox._derived' Value Error24 comments · 2020-06-15#1103Add type annotation stubs24 comments · 2018-08-09#1074pass config options to FigureWidget23 comments · 2018-07-26#413Orientation of y-axis in Heatmap23 comments · 2016-02-25#1938Add continuous color scale to strip, box, and violin plots22 comments · 2019-12-02#2306incorrect representation of mixed rgb and rgba colors in mesh3d20 comments · 2020-03-23
Latest release
v7.1.0 v7.1.0 2026-09-15Added - Support marginal_x/marginal_y="heatmap" in density_heatmap, drawing a single-row/column heatmap strip in the margin colored by the same z/histfunc aggregate as the main plot and sharing its color scale [5706], with thanks to @lucasjamar for the contribution! - Add support for custom tick values in mpl_to_plotly when the matplotlib tick positions don't follow an arithmetic progression, including custom tick labels and tick values on date axes [5262], with thanks to @robertoffmoura for the contribution! Fixed - Fix Plotly Express treating unsigned integer columns (uint8, uint16, u