plotly-stubs

What it is and what it does

plotly-stubs is a stub-only package that adds type annotations to plotly, the popular Python visualization library. It contains no runtime code—only `.pyi` files that tell type checkers like mypy what types plotly's functions and classes expect and return. When installed alongside plotly, it enables your IDE to provide accurate autocompletion and allows type checkers to catch type errors before runtime.

The package is designed for developers who use plotly with modern Python versions (3.11 through 3.14) and want static type safety. It has no runtime dependencies, so it adds no overhead to your environment—it only improves the development experience by making plotly's API surface visible to type-aware tools.

Use it for:

• Enable mypy or pyright type checking on code that uses plotly for data visualization.
• Get IDE autocompletion and parameter hints when writing plotly chart code.
• Catch type mismatches in plotly function calls before running your code.
• Integrate plotly into a strictly typed Python project without losing type safety.
• Document plotly API expectations in a codebase using type annotations.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Provides static type annotations (stubs) for the plotly library, enabling type checking and IDE autocompletion when using plotly in Python projects.

Yes, if you use plotly and want type checking support. The package is lightweight (no dependencies), actively maintained, and carries a permissive MIT license. Install it alongside plotly to unlock IDE autocompletion and type-checker integration with zero runtime cost. Only skip it if you do not use type checking or do not use plotly.

Install

plotly-stubs on PyPI

pip install plotly-stubs

uv add plotly-stubs

poetry add plotly-stubs

Installing plotly-stubs

Before you install

Low friction to install—a pure stub package with no runtime dependencies. Actively maintained as of the last commit on 2026-08-14, with regular releases since first release on 2025-02-18.

License in practice

MIT License permits free use, modification, and distribution with minimal restrictions, making it safe to add to any project without licensing concerns.

Quickstart

pip install plotly-stubs

# In your code, plotly imports now have type hints:
import plotly.graph_objects as go
fig = go.Figure()
fig.add_trace(go.Scatter(x=[1, 2], y=[3, 4]))
fig.show()

Requires plotly to be installed separately; stubs alone do not provide plotly functionality, only type information.

Verify before relying

• Coverage and completeness of type stubs relative to the full plotly API surface.
• Compatibility with specific plotly versions or version ranges.
• Whether stubs are kept in sync with plotly releases automatically or manually.

Package facts

Evidence: plotly_stubs-0.1.3-py3-none-any.whl

Keywords: plotly, stubs, types

Tags

More Scientific/Engineering packages