---
id: grpcio-gcp
version: "0.2.2"
license: Apache License 2.0
license_treatment: permissive
maintenance: abandoned
---

# grpcio-gcp — gRPC extensions for Google Cloud Platform

License: permissive · Maintenance: abandoned · Downloads: 16.8M/mo

## What it is and what it does

grpcio-gcp is a gRPC extension that adds connection pooling and affinity-based request routing for Google Cloud Platform services. It wraps the standard gRPC channel to manage a pool of underlying channels and route requests to specific backend instances based on configuration rules, useful for services that benefit from session affinity.

The package works by loading an API configuration file in text protobuf format that defines channel pool parameters and per-method routing rules, then providing a secure_channel factory that returns a channel pool object compatible with the standard gRPC Channel interface. It is a specialized tool for GCP service integration rather than a general-purpose gRPC enhancement.

Use it for:

- Manage connection pooling to Google Cloud services that require session affinity and benefit from multiple underlying channels.
- Bind gRPC requests to specific backend instances using affinity keys to maintain session state across method calls.
- Configure per-method routing rules (BIND, BOUND, UNBIND) to control how requests are distributed across a pool of channels.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Extends gRPC with connection pooling and affinity-based routing for Google Cloud Platform services, managing multiple channels and binding requests to specific backend instances.

No. The package is abandoned (last release 2018-09-10) and targets Python 2.7 and Python 3.4–3.6, all end-of-life. For new projects, use current Google Cloud client libraries instead. Install only if maintaining legacy code that already depends on it.

## Install

pip install grpcio-gcp
uv add grpcio-gcp
poetry add grpcio-gcp

## Installing grpcio-gcp

Before you install: Low install friction with a single runtime dependency on grpcio. However, the package is abandoned—last release was 2018-09-10 with no updates since, and classifiers indicate support only for Python 2.7 and Python 3.4–3.6.

License in practice: Licensed under Apache License 2.0 (permissive), imposing no restrictions on use or redistribution in proprietary code, though you must retain license notices.

Quickstart:

pip install grpcio-gcp

import grpcio_gcp

config = grpcio_gcp.api_config_from_text_pb(config_text)
options = [(grpcio_gcp.API_CONFIG_CHANNEL_ARG, config)]
channel_pool = grpcio_gcp.secure_channel(target, credentials, options)

Requires a gRPC config file in text protobuf format defining ChannelPoolConfig and MethodConfig; package targets Python 2.7 and Python 3.4–3.6.

Verify before relying:

- Whether the package works with modern Python versions despite classifiers indicating only 2.7 and 3.4–3.6 support.
- Current state of Google Cloud client libraries' gRPC integration and whether this package remains necessary.
- Performance and stability of the channel pool implementation under production load.
- Whether grpcio dependency has breaking changes incompatible with this abandoned package.

## Package facts

- License: Apache License 2.0 (permissive)
- Python support: unspecified
- Install friction: low
- Maintenance: abandoned
- Downloads: 16.8M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

grpc connection pooling, grpc channel pool management, google cloud platform grpc, grpc request affinity routing, grpc load balancing gcp, grpc, connection-pooling, gcp

[View on SkillFed](https://skillfed.io/packages/grpcio-gcp) · [View on PyPI](https://pypi.org/project/grpcio-gcp/)