plotly.py is an interactive, browser-based graphing library for Python ✨

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, standalone HTML files, or hosted online on plot.ly.

Contact us for Plotly.js consulting, dashboard development, application integration, and feature additions. Sharing your graphs online or in dashboards? Consider a plot.ly subscription.

• Online Documentation
• Contributing
• Changelog
• Code of Conduct
• Version 3 Migration Guide
• New! Announcing Dash
• Community

To install plotly.py and enable Jupyter or Jupyter Lab support, run:

pip install plotly==3.1.0
pip install "notebook>=5.3" "ipywidgets>=7.2"  # only necessary for Jupyter Notebook environments

If you're using older versions of notebook or ipywidgets you may need to manually activate the widget extensions (this should not be needed for notebook>=5.3 and ipywidgets>=7.2)

jupyter nbextension enable --py widgetsnbextension --sys-prefix
jupyter nbextension enable --py plotlywidget --sys-prefix

In addition, to add JupyterLab support run the following commands

pip install jupyterlab==0.32.1
export NODE_OPTIONS=--max-old-space-size=4096
jupyter labextension install @jupyter-widgets/[email protected] # install the Jupyter widgets extension
jupyter labextension install [email protected]  # FigureWidget support
jupyter labextension install @jupyterlab/[email protected]  # offline iplot support

If you're migrating from plotly.py version 2, please check out the migration guid

Code and documentation copyright 2018 Plotly, Inc.

Code released under the MIT license.

Docs released under the Creative Commons license.