types-grpcio
Typing stubs for grpcio
Decision gist · record as of 2026-08-14
Yes, if you use grpcio and want static type checking. Install it alongside grpcio to enable type checkers to validate your gRPC code. No runtime cost, low friction, and actively maintained. The partial coverage is not a blocker unless you hit unannotated APIs.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.10 or later.
- Low install friction with no runtime dependencies.
- Actively maintained as part of the typeshed project, with a recent release 15 days old.
License · maintenance · safety
Apache-2.0 (permissive) — Licensed under Apache-2.0 (permissive), imposing no restrictions on use in proprietary or open-source projects.
last release 2026-07-30 (15 days) · last repo commit 2026-08-14 · 37 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 2,404,990 downloads/mo, #3,078 on PyPI
Alternatives
Verify before relying
pip install types-grpcio
import grpcio
# Type checkers now understand grpcio APIs- Whether coverage of grpcio's API surface is sufficient for your specific use cases, given the package is marked as partial.
- Compatibility with type checkers other than mypy 2.3.0, pyright 1.1.411, and ty 0.0.59.
What it is and what it does
types-grpcio is a type stub package that provides type annotations for the grpcio library. It allows static type checkers to understand and validate code that calls gRPC functions and classes, catching type errors before runtime. The stubs are generated from the typeshed project and kept in sync with grpcio versions.
This is a stub-only package with no runtime dependencies—it exists purely to improve your development experience through type checking. It's marked as partial, meaning some annotations may be incomplete; the typeshed project welcomes contributions to fill gaps. The package is tested against mypy 2.3.0, pyright 1.1.411, and ty 0.0.59.
Use it for
- Enable type checkers to validate gRPC client and server code in your project.
- Catch type mismatches in gRPC service definitions and method calls during development.
- Improve IDE autocomplete and inline documentation for grpcio APIs.
- Validate gRPC message marshalling and RPC handler signatures in a type-safe workflow.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you use grpcio and want static type checking.
Install it alongside grpcio to enable type checkers to validate your gRPC code. No runtime cost, low friction, and actively maintained. The partial coverage is not a blocker unless you hit unannotated APIs.
Install
types-grpcio on PyPI
Before you install
Low install friction with no runtime dependencies. Actively maintained as part of the typeshed project, with a recent release 15 days old.
Requires Python 3.10 or later.
License in practice
Licensed under Apache-2.0 (permissive), imposing no restrictions on use in proprietary or open-source projects.
Quickstart
pip install types-grpcio
import grpcio
# Type checkers now understand grpcio APIsVerify before relying
- Whether coverage of grpcio's API surface is sufficient for your specific use cases, given the package is marked as partial.
- Compatibility with type checkers other than mypy 2.3.0, pyright 1.1.411, and ty 0.0.59.
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 15 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 2,404,990 / month, #3,078 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_grpcio-1.83.0.20260730-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 › “grpcio type hints”
- types-grpcioProvides type stubs for the grpcio package, enabling static type…
- types-grpcio-health-checkingProvides type stubs for grpcio-health-checking, enabling static type…
- grpc-stubsProvides type stubs for gRPC Python, enabling static type checking of…
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 grpc-stubs · types-google-cloud-ndb · types-networkx · types-pika-ts · types-grpcio-health-checking · types-Pygments · types-protobuf · types-gunicorn · grpcio-testing · types-antlr4-python3-runtime