plotly.py README

The project's README from github.com/plotly/plotly.py. As one markdown file: README.md.

plotly.py

Latest Release
User forum
PyPI Downloads
License
Maintained by Plotly

Quickstart

pip install plotly

import plotly.express as px
fig = px.bar(x=["a", "b", "c"], y=[1, 3, 2])
fig.show()

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.



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.

Code and documentation copyright 2026 Plotly, Inc.

Code released under the MIT license.

Docs released under the Creative Commons license.

plotly.py (plotly/plotly.py)

plotly
Searching Database…

18.8K ·GitHub
What is this?An interactive, open-source graphing library for Python: you describe charts in Python code and get interactive figures rendered in the browser.
Is it a Python package I import, or something I host — how do the charts actually get drawn?It's a Python library you import. Under the hood it is a high-level, declarative layer over plotly.js, which renders the charts in the browser.
How do I add it to a project?Run pip install plotly (conda works too) — that's the whole quickstart, and the Python documentation has more examples.
Do I need anything extra to use it inside Jupyter?Only for interactive widget support: install the jupyter and anywidget packages alongside plotly, via pip or conda.
If I want to export a chart as a static image, does that just work?Not quite out of the box: export needs the kaleido package (v1.0+), and Kaleido requires Chrome or Chromium — if none is found on your system, install it with the plotlygetchrome command.
Do I have to live in Jupyter, or where else do the charts work?Beyond Jupyter, graphs can be viewed in other notebook software such as marimo, saved as standalone HTML files, or integrated into Dash applications.
Is it free to use, including in commercial work?Yes — plotly.py is MIT licensed; the code is copyright Plotly, Inc. and the docs are under Creative Commons.
What kinds of charts can it actually draw?Over 30 chart types ship with plotly.js: scientific charts, 3D graphs, statistical charts, SVG maps, financial charts, and more.
Does the company behind it offer paid help?Yes. Plotly, Inc. offers consulting, dashboard development, application integration, and feature additions via the contact link in the README.
Is it actively maintained?Yes — the README copyright notice reads 2026, and the repo runs CI workflows for docs builds, package builds, changelog, codegen and formatting checks.
Creator
plotly
Size
418.3 MB
Stars
18.8K
Age
12y
Commits · 90 Days