pandas-stubs

Type annotations for pandas

pandas-stubs Permissive license BSD-3-Clause Active ★ 326 v3.0.5.260730 released 2026-07-30

Install

pandas-stubs on PyPI

pip

pip install pandas-stubs

uv

uv add pandas-stubs

poetry

poetry add pandas-stubs

Package facts

License	BSD-3-Clause (permissive)
Python support	supports the current Python release (>=3.11)
Install friction	low — pure-Python wheel
Runtime dependencies	1 — numpy
Maintenance	actively maintained — 14 days since the last release
Last repo commit	2026-08-12
First released	2021-01-08
Popularity	one of the top 1,000 most-downloaded packages on PyPI (30-day window, as of 2026-08-13)
Known vulnerabilities	none known (OSV.dev, checked 2026-08-13)

Evidence: pandas_stubs-3.0.5.260730-py3-none-any.whl

Development Status :: 5 - Production/StableEnvironment :: ConsoleIntended Audience :: Science/ResearchOperating System :: OS IndependentProgramming Language :: PythonProgramming Language :: Python :: 3Programming Language :: Python :: 3 :: OnlyProgramming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.14Topic :: Scientific/EngineeringTyping :: Stubs Only

About pandas-stubs

from the package's own PyPI description — quoted content, verbatim

pandas-stubs: Public type stubs for pandas

PyPI Latest Release (image) Conda Latest Release (image) Package Status (image) License (image) Downloads (image) Gitter (image) Powered by NumFOCUS (image) Code style: black (image) [![Imports:...

Read as markdown · JSON record · Source repository · Homepage · Docs

AI interpretation — verify before relying

AI-generated interpretation of the package facts above; every digit, version, license, or vulnerability id it cites is grounded in the facts already shown on this page

Provides type stubs for pandas, enabling static type checkers like mypy and pyright to catch type errors in pandas code and suggest best practices for using the library.

Installs with minimal friction—a pure-Python wheel with only numpy as a runtime dependency. Actively maintained with a release 14 days ago and 326 GitHub stars.

BSD-3-Clause permissive license allows free use, modification, and distribution with minimal restrictions, suitable for both open-source and commercial projects.

Usage

pip install pandas-stubs

import pandas as pd

df = pd.DataFrame({'A': [1, 2], 'B': [3, 4]})
result = df.round(decimals=1)  # Type checker validates argument types

Requires Python >= 3.11 and pandas installed; type checking requires mypy, pyright, or compatible type checker.

Verdict: A well-maintained, actively developed type stub package (released 14 days ago) that integrates pandas with modern type checkers. Zero known vulnerabilities, permissive licensing, and low install friction make it a safe choice for teams adopting static type checking on pandas code.

Needs verification

Whether stubs cover the full pandas public API or remain intentionally narrower as suggested in the description.
Actual compatibility matrix between specific pandas versions and pandas-stubs releases beyond the versioning scheme.
Performance impact of type checking with these stubs on typical pandas workflows.

pandas type stubstype checking pandasmypy pandas annotationspandas type hintsstatic type checking dataframespyright pandas supportpandas type safety