grpcio-tools

Protobuf code generator for gRPC

grpcio-tools Permissive license Apache-2.0 Active ★ 45,282 v1.83.0 released 2026-07-23

Install

grpcio-tools on PyPI

pip

pip install grpcio-tools

uv

uv add grpcio-tools

poetry

poetry add grpcio-tools

Package facts

License	Apache-2.0 (permissive)
Python support	supports the current Python release (>=3.10)
Install friction	medium — platform-specific wheel
Runtime dependencies	3 — protobuf, grpcio, setuptools
Maintenance	actively maintained — 21 days since the last release
Last repo commit	2026-08-13
First released	2016-05-10
Popularity	one of the top 1,000 most-downloaded packages on PyPI (30-day window, as of 2026-08-13)
Known vulnerabilities	none known (OSV.dev, checked 2026-08-13)

Evidence: grpcio_tools-1.83.0-cp310-cp310-linux_armv7l.whl; grpcio_tools-1.83.0-cp310-cp310-macosx_11_0_universal2.whl; grpcio_tools-1.83.0-cp310-cp310-manylinux2014_aarch64.manylinux_2_17_aarch64.whl; grpcio_tools-1.83.0-cp310-cp310-manylinux2014_i686.manylinux_2_17_i686.whl; grpcio_tools-1.83.0-cp310-cp310-manylinux2014_x86_64.manylinux_2_17_x86_64.whl; grpcio_tools-1.83.0-cp310-cp310-musllinux_1_2_aarch64.whl; grpcio_tools-1.83.0-cp310-cp310-musllinux_1_2_i686.whl; grpcio_tools-1.83.0-cp310-cp310-musllinux_1_2_x86_64.whl; grpcio_tools-1.83.0-cp310-cp310-win32.whl; grpcio_tools-1.83.0-cp310-cp310-win_amd64.whl; grpcio_tools-1.83.0-cp311-cp311-linux_armv7l.whl; grpcio_tools-1.83.0-cp311-cp311-macosx_11_0_universal2.whl; grpcio_tools-1.83.0-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.whl; grpcio_tools-1.83.0-cp311-cp311-manylinux2014_i686.manylinux_2_17_i686.whl; grpcio_tools-1.83.0-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.whl; grpcio_tools-1.83.0-cp311-cp311-musllinux_1_2_aarch64.whl; grpcio_tools-1.83.0-cp311-cp311-musllinux_1_2_i686.whl; grpcio_tools-1.83.0-cp311-cp311-musllinux_1_2_x86_64.whl; grpcio_tools-1.83.0-cp311-cp311-win32.whl; grpcio_tools-1.83.0-cp311-cp311-win_amd64.whl

Development Status :: 5 - Production/StableProgramming Language :: PythonProgramming Language :: Python :: 3

About grpcio-tools

from the package's own PyPI description — quoted content, verbatim

gRPC Python Tools

Package for gRPC Python tools.

Supported Python Versions

Python >= 3.6

Installation

The gRPC Python tools package is available for Linux, macOS, and Windows.

Installing From PyPI ~~~~~~~~~~~~~~~~~~~~

If you are installing locally...

$ pip install grpcio-tools

Else system wide (on Ubuntu)...

$ sudo pip install grpcio-tools

If you're on Windows make sure that you installed the :code:pip.exe component when you installed Python (if not go back and install it!) then invoke:

$ pip.exe install grpcio-tools

Windows users may need to invoke :code:pip.exe from a command line ran as administrator.

n.b. On Windows and on macOS one must have a recent release of :code:pip to retrieve the proper wheel from PyPI. Be sure to upgrade to the latest version!

You might also need to install Cython to handle installation via the source distribution if gRPC Python's system coverage with wheels does not happen to include your system.

Installing From Source ~~~~~~~~~~~~~~~~~~~~~~

Building from source requires that you have the Python headers (usually a package named :code:python-dev)...

Read as markdown · JSON record · Source repository · Homepage

AI interpretation — verify before relying

AI-generated interpretation of the package facts above; every digit, version, license, or vulnerability id it cites is grounded in the facts already shown on this page

Generates Python code and gRPC service stubs from Protocol Buffer definitions, enabling type-safe RPC service development.

Medium install friction due to platform-specific wheels and three runtime dependencies (protobuf, grpcio, setuptools). Active maintenance with a recent release (21 days old) and strong upstream project health.

Apache-2.0 is permissive; you may use, modify, and distribute this package freely in commercial and private projects provided you retain license notices.

Usage

pip install grpcio-tools==1.83.0
python -m grpc_tools.protoc -I. --python_out=. --grpc_python_out=. example.proto

Requires Python >= 3.10; source builds need python-dev headers, Cython, and a GCC-like compiler.

Verdict: Production-ready code generator for gRPC services with active maintenance, no known vulnerabilities, and permissive licensing. Install friction is moderate due to platform-specific wheels and build dependencies, but pre-built wheels cover common architectures. Suitable for teams building gRPC Python applications.

Needs verification

Whether pre-built wheels fully eliminate the need for Cython and compiler toolchain on all target platforms
Performance characteristics or limitations when generating large or complex proto files

protobuf code generatorgrpc python stubsproto file compilationrpc service codegengrpc python toolsprotobuf python compilergrpc service generation