types-protobuf
Typing stubs for protobuf
Decision gist · record as of 2026-08-14
Yes, if you use protobuf and run static type checking. Install it alongside your type checker (mypy or pyright) in your development environment to catch protobuf-related type errors early. The stub coverage is partial, so verify it covers your specific protobuf usage; if gaps exist, the typeshed project accepts contributions.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python >= 3.10; type checking requires mypy 2.1.0 or pyright 1.1.409 (or compatible versions).
- Low friction: a pure-Python stub package with no runtime dependencies, distributed as a wheel.
- Maintained actively through the typeshed project with recent releases.
License · maintenance · safety
Apache-2.0 (permissive) — Licensed under Apache-2.0 (permissive), imposing no significant restrictions on use or distribution in most contexts.
last release 2026-05-18 (88 days) · last repo commit 2026-08-13 · 37 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 70,687,775 downloads/mo, #469 on PyPI
Alternatives
Verify before relying
pip install types-protobuf
# In your code, type checkers will now understand protobuf imports:
import protobuf
# mypy or pyright can now validate protobuf usage statically- Whether the stub coverage is sufficient for your specific protobuf usage patterns (package is marked as partial).
- Compatibility with type checker versions other than those explicitly tested (mypy 2.1.0, pyright 1.1.409).
What it is and what it does
types-protobuf is a type stub package that bridges the gap between the protobuf library and Python's static type checkers. It provides type annotations for protobuf's public API, allowing mypy, pyright, and other type checkers to understand and validate code that imports and uses protobuf without needing to run the code. The stubs are generated from protobuf v34.1 (matching protobuf~=7.34.1) using mypy-protobuf and libprotoc, and are part of the broader typeshed project.
The package is marked as partial, meaning not all protobuf APIs may have complete type coverage yet. It has no runtime dependencies and installs as a pure-Python wheel, making it lightweight to add to development environments. Type checking support has been verified against mypy 2.1.0 and pyright 1.1.409.
Use it for
- Enable mypy or pyright to catch type errors in code that constructs and manipulates protobuf messages.
- Validate protobuf field access and method calls during static analysis before running integration tests.
- Integrate protobuf type checking into a CI/CD pipeline without adding runtime overhead.
- Provide IDE autocompletion and type hints for protobuf APIs in editors that support type stubs.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you use protobuf and run static type checking.
Install it alongside your type checker (mypy or pyright) in your development environment to catch protobuf-related type errors early. The stub coverage is partial, so verify it covers your specific protobuf usage; if gaps exist, the typeshed project accepts contributions.
Install
types-protobuf on PyPI
Before you install
Low friction: a pure-Python stub package with no runtime dependencies, distributed as a wheel. Maintained actively through the typeshed project with recent releases.
Requires Python >= 3.10; type checking requires mypy 2.1.0 or pyright 1.1.409 (or compatible versions).
License in practice
Licensed under Apache-2.0 (permissive), imposing no significant restrictions on use or distribution in most contexts.
Quickstart
pip install types-protobuf
# In your code, type checkers will now understand protobuf imports:
import protobuf
# mypy or pyright can now validate protobuf usage staticallyVerify before relying
- Whether the stub coverage is sufficient for your specific protobuf usage patterns (package is marked as partial).
- Compatibility with type checker versions other than those explicitly tested (mypy 2.1.0, pyright 1.1.409).
Package facts
| License | Apache-2.0 permissive |
| Python support | Supports the current Python release >=3.10 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | None |
| Maintenance | Actively maintained 88 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 70,687,775 / month, #469 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Programming Language :: Python :: 3Typing :: Stubs Only |
Evidence: types_protobuf-7.34.1.20260518-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “type checking protobuf”
- types-protobufProvides type stubs for the protobuf package, enabling static type…
- googleapis-common-protos-stubsProvides type stubs for googleapis-common-protos, enabling static…
- mypy-protobufGenerates mypy-compatible stub files (.pyi) from protobuf…
Give your agent the search over MCP, or paste the wish link into any chat.
More Software Development packages
Provides backported and experimental type hints for Python 3.9+, allowing use of newer typing features on older Python versions and enabling early experimentation with type system PEPs before they enter the standard library.
NumPy provides an N-dimensional array object and a comprehensive suite of mathematical, linear algebra, Fourier transform, and random number functions for scientific computing in Python.
FastAPI is a Python web framework for building REST APIs using type hints, with automatic request validation, serialization, and interactive API documentation.
Provides a way to document function parameters, class attributes, return types, and variables inline using Python's `Annotated` type hint syntax instead of traditional docstrings.
Typer builds command-line applications from Python functions using type hints, automatically generating help text, argument parsing, and shell completion.
Install it if you are building CLIs in Python.
Distlib provides low-level packaging utilities for building, distributing, and managing Python software—including metadata handling, version specifiers, wheel support, script installation, and dependency resolution.
See also mypy-protobuf · types-polib · types-cffi · googleapis-common-protos-stubs · types-pexpect · types-mock · types-grpcio · types-PySocks · types-grpcio-health-checking · types-tensorflow