back to home

plotly / plotly.py

The interactive graphing library for Python :sparkles:

18,277 stars
2,776 forks
778 issues
PythonTypeScriptJavaScript

AI Architecture Analysis

This repository is indexed by RepoMind. By analyzing plotly/plotly.py in our AI interface, you can instantly generate complete architecture diagrams, visualize control flows, and perform automated security audits across the entire codebase.

Our Agentic Context Augmented Generation (Agentic CAG) engine loads full source files into context, avoiding the fragmentation of traditional RAG systems. Ask questions about the architecture, dependencies, or specific features to see it in action.

Embed this Badge

Showcase RepoMind's analysis directly in your repository's README.

[![Analyzed by RepoMind](https://img.shields.io/badge/Analyzed%20by-RepoMind-4F46E5?style=for-the-badge)](https://repomind-ai.vercel.app/repo/plotly/plotly.py)
Preview:Analyzed by RepoMind

Repository Summary (README)

Preview

plotly.py

<table> <tr> <td>Latest Release</td> <td> <a href="https://pypi.org/project/plotly/"/> <img src="https://badge.fury.io/py/plotly.svg"/> </td> </tr> <tr> <td>User forum</td> <td> <a href="https://community.plotly.com/"/> <img src="https://img.shields.io/badge/help_forum-discourse-blue.svg"/> </td> </tr> <tr> <td>PyPI Downloads</td> <td> <a href="https://pepy.tech/project/plotly"/> <img src="https://pepy.tech/badge/plotly/month"/> </td> </tr> <tr> <td>License</td> <td> <a href="https://opensource.org/licenses/MIT"/> <img src="https://img.shields.io/badge/License-MIT-yellow.svg"/> </td> </tr> </table> <div align="center"> <a href="https://dash.plotly.com/project-maintenance"> <img src="https://dash.plotly.com/assets/images/maintained-by-plotly.png" width="400px" alt="Maintained by Plotly"> </a> </div>

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.

<p align="center"> <a href="https://plotly.com/python/" target="_blank"> <img src="https://raw.githubusercontent.com/cldougl/plot_images/add_r_img/plotly_2017.png"> </a></p>

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 either the kaleido package (recommended, supported as of plotly version 4.9) or the orca command line utility (legacy as of plotly version 4.9).

Kaleido

The kaleido package has no dependencies and can be installed using pip

pip install -U kaleido

or conda

conda install -c conda-forge python-kaleido

Extended Geo Support

Some plotly.py features rely on fairly large geographic shape files. The county choropleth figure factory is one such example. These shape files are distributed as a separate plotly-geo package. This package can be installed using pip...

pip install plotly-geo==1.0.0

or conda

conda install -c plotly plotly-geo=1.0.0

plotly-geo can be found on Github at https://github.com/plotly/plotly-geo.

Copyright and Licenses

Code and documentation copyright 2019 Plotly, Inc.

Code released under the MIT license.

Docs released under the Creative Commons license.