types-Pillow
Typing stubs for Pillow
What it is and what it does
types-Pillow is a PEP 561 type stub package that provides type annotations for Pillow 10.2.*, allowing static type checkers to understand and validate code that uses Pillow's image processing functions. It has no runtime dependencies and is installed alongside your type checker to improve code quality during development.
The stubs are maintained in the typeshed repository and are tested against mypy 1.11.1, pyright 1.1.377, and pytype 2024.4.11. However, this package is now superseded: Pillow itself has included native type annotations since version 10.3.0, so you should uninstall types-Pillow if you upgrade to Pillow 10.3.0 or later.
Use it for:
- Enable type checkers to validate image processing code that imports Pillow without runtime overhead.
- Catch type errors in Pillow API calls during development before they reach production.
- Integrate Pillow type checking into a CI/CD pipeline using a static type checker.
- Use in an IDE to get inline type hints and autocomplete for Pillow functions.
Worth the install?
AI-flagged interpretation of the facts on this page — verify before relying
Provides type stubs for Pillow, enabling static type checkers to validate code using Pillow's image processing library.
Yes, if you are using Pillow 10.2.* and want static type checking. Install it alongside your type checker. However, if you are already on Pillow 10.3.0 or later, uninstall this package—Pillow now provides its own type annotations and this stub becomes redundant. No security vulnerabilities are known.
Install
types-pillow on PyPI
pip
pip install types-pillowuv
uv add types-pillowpoetry
poetry add types-pillowInstalling types-Pillow
Before you install
Low install friction with no runtime dependencies. Actively maintained and tested with current type checker versions. Note: Pillow itself includes type annotations since version 10.3.0, making this package redundant for newer Pillow versions.
License in practice
Apache-2.0 is permissive and places no restrictions on use, modification, or distribution in your own projects.
Quickstart
pip install types-Pillow
# Use with your type checker on code that imports Pillow
# Type checker will now understand Pillow's API
Requires Python >=3.8. Only useful if you are running a static type checker; does not affect runtime.
Verify before relying
- Whether type coverage is complete for all Pillow 10.2.* APIs or if some areas remain untyped.
- Compatibility with Pillow versions outside the 10.2.* range that this stub targets.
Package facts
| License | Apache-2.0 (permissive) |
| Python support | supports the current Python release (>=3.8) |
| Install friction | low — pure-Python wheel |
| Runtime dependencies | none |
| Maintenance | actively maintained — 722 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 4,193,698/month — #2,365 on PyPI (30-day window, as of 2026-08-14) |
| Known vulnerabilities | none known (OSV.dev, checked 2026-08-14) |
Evidence: types_Pillow-10.2.0.20240822-py3-none-any.whl
Tags
More Software Development packages
Provides backported and experimental type hints…
permissive · top 100 on PyPI
numpyNumPy provides an N-dimensional array object…
permissive · top 100 on PyPI
fastapiFastAPI is a Python web framework for building…
permissive · top 100 on PyPI
annotated-docProvides a way to document function parameters,…
permissive · top 100 on PyPI
typerTyper builds command-line applications from…
permissive · top 1,000 on PyPI
distlibDistlib provides low-level packaging utilities…
permissive · top 1,000 on PyPI
docutils-stubsProvides PEP 561 type stubs for docutils,…
permissive · top 15,000 on PyPI
pandas-stubsProvides type stubs for pandas, enabling static…
permissive · top 1,000 on PyPI
types-beautifulsoup4Provides type hints for beautifulsoup4 code via…
permissive · top 5,000 on PyPI
types-pyOpenSSLProvides type stubs for pyOpenSSL to enable…
permissive · top 5,000 on PyPI
types-tzlocalProvides type stubs for the tzlocal package,…
permissive · top 5,000 on PyPI
types-chardetProvides type stubs for character encoding…
permissive · top 5,000 on PyPI
types-python-slugifyProvides type stubs for the python-slugify…
permissive · top 5,000 on PyPI
types-emojiProvides type stubs for the emoji package,…
permissive · top 15,000 on PyPI
scipy-stubsProvides type stubs for the entire SciPy…
permissive · top 5,000 on PyPI
pillow-avif-pluginRegisters AVIF image format support with…
permissive · top 5,000 on PyPI