protoc-gen-openapiv2
Provides the missing pieces for gRPC Gateway.
Decision gist · record as of 2026-08-14
No. The package is abandoned (last release 2022-12-02, no commits since) and has zero repository stars. While install friction is low and the license is permissive, the lack of maintenance means it will not track upstream gRPC Gateway or protobuf changes. Consider whether a maintained alternative or direct gRPC Gateway integration exists before adopting this.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires protobuf and googleapis-common-protos as runtime dependencies; designed for protobuf major version as of 2022.
- Low install friction with only two runtime dependencies (googleapis-common-protos and protobuf), but the package is abandoned—last release was 2022-12-02 with no subsequent maintenance.
License · maintenance · safety
permissive license (permissive) — Licensed under BSD (permissive), which places no significant restrictions on use or redistribution.
last release 2022-12-02 (1351 days) · last repo commit 2022-12-02
0 known vulnerabilities (OSV.dev, 2026-08-14) · 2,023,032 downloads/mo, #3,356 on PyPI
Alternatives
Verify before relying
pip install protoc-gen-openapiv2
Then use protoc with the plugin during your build process to generate Python code from proto files with gRPC Gateway annotations.- Whether the generated code remains compatible with current protobuf major versions beyond the 2022 release date.
- Whether gRPC Gateway upstream changes since 2022-12-02 have introduced incompatibilities with this generator.
- Active community or alternative maintained forks for this functionality.
What it is and what it does
protoc-gen-openapiv2 is a protoc plugin that generates Python code to support gRPC Gateway protoc annotations. It fills a gap in the gRPC Gateway ecosystem by providing the missing Python runtime support that the generated code depends on, specifically providing access to google.api.annotations_pb2 and related protocol buffer definitions through googleapis-common-protos.
The package is designed to work with the new protobuf major version (as of 2022) and requires protobuf as a runtime dependency. It is a code generation tool rather than a runtime library—you install it to run protoc during your build process, not to import and use directly in application code.
Use it for
- Generate Python gRPC service stubs from proto files that use gRPC Gateway annotations for REST API exposure.
- Build microservices that expose both gRPC and HTTP/REST endpoints from a single proto definition.
- Integrate gRPC Gateway-annotated proto files into Python projects that need OpenAPI v2 support.
- Support proto-based API contracts that require both gRPC and REST client generation.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
No.
The package is abandoned (last release 2022-12-02, no commits since) and has zero repository stars. While install friction is low and the license is permissive, the lack of maintenance means it will not track upstream gRPC Gateway or protobuf changes. Consider whether a maintained alternative or direct gRPC Gateway integration exists before adopting this.
Install
protoc-gen-openapiv2 on PyPI
Before you install
Low install friction with only two runtime dependencies (googleapis-common-protos and protobuf), but the package is abandoned—last release was 2022-12-02 with no subsequent maintenance.
Requires protobuf and googleapis-common-protos as runtime dependencies; designed for protobuf major version as of 2022.
License in practice
Licensed under BSD (permissive), which places no significant restrictions on use or redistribution.
Quickstart
pip install protoc-gen-openapiv2
Then use protoc with the plugin during your build process to generate Python code from proto files with gRPC Gateway annotations.Verify before relying
- Whether the generated code remains compatible with current protobuf major versions beyond the 2022 release date.
- Whether gRPC Gateway upstream changes since 2022-12-02 have introduced incompatibilities with this generator.
- Active community or alternative maintained forks for this functionality.
Package facts
| License | permissive license permissive |
| Python support | Supports the current Python release >=3.6 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 2 packagesgoogleapis-common-protosprotobuf |
| Maintenance | Abandoned 1,351 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 2,023,032 / month, #3,356 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | License :: OSI Approved :: BSD LicenseOperating System :: OS IndependentProgramming Language :: Python :: 3 |
Evidence: protoc_gen_openapiv2-0.0.1-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “protoc plugin openapi v2”
- protoc-gen-openapiv2Generates Python support code for gRPC Gateway protoc annotations,…
- grpc-gateway-protoc-gen-openapiv2Generates Python support code for gRPC Gateway protoc annotations,…
- essentials-openapiGenerates OpenAPI v2 and v3 documentation in JSON and YAML formats,…
Give your agent the search over MCP, or paste the wish link into any chat.
More Build Tools packages
Provides reusable utilities for Python packaging interoperability, including version handling, specifiers, markers, requirements, tags, and metadata parsing according to standards like PEP 440 and PEP 425.
Wraps any iterable to display a real-time progress bar in the terminal or Jupyter notebook, showing iteration count, elapsed time, and estimated time remaining.
pip is the standard installer for Python packages, enabling you to download and install packages from the Python Package Index and other indexes into your Python environment.
Hatchling is a standards-compliant Python build backend that handles packaging, metadata, and distribution of Python projects when configured in a project's pyproject.toml file.
Generates Python gRPC service stubs and message classes from Protocol Buffer definitions, enabling developers to build gRPC clients and servers.
pre-commit is a framework for installing and running git hooks written in any language before commits are made, automating code quality and validation checks across multi-language projects.
Install it if your team needs consistent, automated validation at commit time.
See also grpc-gateway-protoc-gen-openapiv2 · hatch-protobuf · protoc-gen-connect-python · pbtools · aristaproto · betterproto-fw · betterproto2 · betterproto2-compiler · logic2-automation · ansys-api-tools-filetransfer