types-grpcio

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

Provides type stubs for the grpcio package, enabling static type checkers like mypy and pyright to validate code that uses gRPC.

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

pip install types-grpcio

uv add types-grpcio

poetry add types-grpcio

Installing types-grpcio

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.

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 APIs

Requires Python 3.10 or later.

Verify 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

Evidence: types_grpcio-1.83.0.20260730-py3-none-any.whl

Tags

More Software Development packages