---
id: grpc-gateway-protoc-gen-openapiv2
version: "0.1.0"
license: unclear
license_treatment: permissive
maintenance: abandoned
---

# grpc-gateway-protoc-gen-openapiv2 — Provides the missing pieces for gRPC Gateway.

License: permissive · Maintenance: abandoned · Downloads: 212.4K/mo

## What it is and what it does

This package fills a gap in the gRPC Gateway ecosystem by providing Python code generation support for protoc annotations used by gRPC Gateway. When you use gRPC Gateway to generate service definitions with OpenAPI annotations, this package ensures the resulting Python code has the necessary imports and dependencies (primarily from googleapis-common-protos) to actually run. It is a build-time tool—you install it, use it as a protoc plugin during your code generation step, and the output integrates with your gRPC service definitions.

The package itself is minimal and focused: it depends only on googleapis-common-protos and provides the glue between gRPC Gateway's protoc annotations and Python's protobuf ecosystem. However, it has not been maintained since its initial release on 2021-05-09, meaning it may not work with significantly newer versions of dependencies that have been released since then.

Use it for:

- Generate Python gRPC service stubs from proto files that use gRPC Gateway OpenAPI annotations.
- Integrate gRPC Gateway-annotated protobuf definitions into a Python microservice project.
- Build a Python API server that exposes both gRPC and HTTP/JSON endpoints via gRPC Gateway.
- Support proto-first development workflows where gRPC Gateway annotations drive both API documentation and service implementation.

## Worth the install?

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

Generates Python support code for gRPC Gateway protoc annotations, enabling use of gRPC Gateway-generated protobuf definitions in Python projects.

No, unless you are maintaining legacy code that already depends on this package. The package is abandoned with no updates since 2021-05-09 and will not receive fixes for compatibility issues with newer dependencies. If you are starting a new gRPC Gateway project in Python, investigate whether gRPC Gateway's own Python support or alternative tooling has evolved to make this package unnecessary.

## Install

pip install grpc-gateway-protoc-gen-openapiv2
uv add grpc-gateway-protoc-gen-openapiv2
poetry add grpc-gateway-protoc-gen-openapiv2

## Installing grpc-gateway-protoc-gen-openapiv2

Before you install: Package has been abandoned since its only release on 2021-05-09 with no updates or maintenance activity. Install friction is low, but the lack of maintenance means no bug fixes or compatibility updates for newer dependencies.

License in practice: Licensed under BSD (permissive), so you can use and modify the code freely in commercial or private projects without restriction.

Quickstart:

pip install grpc-gateway-protoc-gen-openapiv2

The package provides protoc plugin support; use it as part of your protobuf code generation workflow with gRPC Gateway annotations.

Requires Python >=3.6 and googleapis-common-protos as a runtime dependency.

Verify before relying:

- Whether the generated code remains compatible with current gRPC and protobuf library versions.
- Whether gRPC Gateway annotation support has evolved since 2021 in ways this package does not handle.
- Real-world usage patterns and whether 212406 monthly downloads reflect active use or legacy dependencies.

## Package facts

- License: not declared (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: abandoned
- Downloads: 212.4K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

grpc gateway python support, protoc code generation grpc, grpc gateway protobuf python, openapi grpc gateway, protoc plugin grpc gateway, grpc, protobuf, code-generation

[View on SkillFed](https://skillfed.io/packages/grpc-gateway-protoc-gen-openapiv2) · [View on PyPI](https://pypi.org/project/grpc-gateway-protoc-gen-openapiv2/)