grpc-stubs

What it is and what it does

grpc-stubs is a PEP 561-compliant stub-only package that provides type information for the gRPC library, allowing developers to use static type checkers like mypy to validate gRPC code. It depends only on grpcio and installs as a pure Python wheel with no compiled dependencies.

The package is now archived and abandoned as of 2025-04-28. The maintainer has transferred active development to typeshed, the community-maintained repository of type stubs for the Python ecosystem. While the last release was recent, no new features or fixes should be expected from this repository; users should plan to migrate to typeshed's gRPC stubs for ongoing support.

Use it for:

• Type-check gRPC service definitions and client code with mypy before runtime.
• Enable IDE autocompletion and inline type hints for gRPC imports and calls.
• Validate gRPC message and service definitions in a CI/CD pipeline using mypy.
• Provide type safety for gRPC-based microservices during development.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Provides type stubs for gRPC Python, enabling static type checking of gRPC code with mypy and other type checkers.

No. The package is archived and abandoned; the maintainer explicitly directs users to typeshed for ongoing support. While it has no known vulnerabilities and low install friction, installing a stub package with no active maintenance creates a maintenance debt. Install typeshed's gRPC stubs instead, or use a tool that automatically pulls stubs from typeshed.

Install

grpc-stubs on PyPI

pip install grpc-stubs

uv add grpc-stubs

poetry add grpc-stubs

Installing grpc-stubs

Before you install

Low install friction with a single runtime dependency on grpcio. However, the package is archived as of 2025-04-28 and marked abandoned; active development has moved to typeshed. The last release was 473 days ago.

License in practice

MIT license is permissive and imposes no restrictions on use, modification, or distribution.

Quickstart

pip install grpc-stubs

Then use with mypy or another PEP 561-compliant type checker to validate gRPC code:

mypy your_grpc_code.py

Requires grpcio to be installed; intended for development/type-checking workflows, not runtime.

Verify before relying

• Whether typeshed's gRPC stubs are a drop-in replacement or require migration steps.
• Current compatibility with Python versions beyond 3.8, given the package is archived.
• Whether the stubs remain accurate for recent grpcio versions post-abandonment.

Package facts

Evidence: grpc_stubs-1.53.0.6-py3-none-any.whl

Tags

More Software Development packages