protobuf-py
Idiomatic Protocol Buffers for Python.
Decision gist · record as of 2026-08-14
Yes, with conditions. The package is actively maintained, has low install friction, and offers genuine ergonomic improvements over alternatives (readable code, native type hints, direct field assignment). However, it is still in Alpha status with a first release only months old; production use should weigh stability risk against the benefits of better developer experience. No known vulnerabilities and permissive licensing are in its favor.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.10 or later.
- Code generation from .proto files requires external tooling; generated message classes must be created before importing and using them.
- Low friction: pure wheel distribution, single runtime dependency (protobuf-py-ext), and active maintenance with a release within the past week.
License · maintenance · safety
Apache-2.0 (permissive) — Apache-2.0 permissive license allows use in commercial and open-source projects without significant restrictions.
last release 2026-08-07 (7 days) · last repo commit 2026-08-14 · 88 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 338,468 downloads/mo, #7,431 on PyPI
Alternatives
Verify before relying
from protobuf_py import Message
# After code generation from .proto files:
user = Message(id="123", first_name="Alice")
data = user.to_binary()
user = Message.from_binary(data)
print(user.to_json())- Whether protobuf-py-ext is a compiled extension or pure Python, and what system dependencies it may require.
- Performance benchmarks comparing encoder/decoder speed to other Protobuf implementations.
- Stability guarantees given the Alpha development status and recent first release date.
- Whether proto2 support is actually implemented or only proto3 is supported.
What it is and what it does
protobuf-py is a Protocol Buffer implementation for Python that generates readable, type-annotated message classes from .proto files. Unlike alternatives that generate opaque runtime-constructed classes, protobuf-py produces inspectable Python code with proper IDE support and native type hints. It includes a Rust-backed encoder/decoder for performance and claims 100% conformance with the Protobuf specification.
The library depends only on protobuf-py-ext at runtime and requires Python 3.10 or later. It supports typed oneofs with pattern matching, well-known types with helper methods, and reflection over message fields. Generated code uses direct field assignment and includes IDE-friendly presence checking.
Use it for
- Define and serialize structured data for APIs using .proto schemas with full type safety.
- Build message-driven systems where field presence tracking and oneof pattern matching improve code clarity.
- Generate typed message classes that are inspectable and work well with IDE autocomplete and type checkers.
- Serialize and deserialize binary data using the to_binary() and from_binary() methods.
- Work with well-known types like Timestamp and Duration using built-in helper methods.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, with conditions.
The package is actively maintained, has low install friction, and offers genuine ergonomic improvements over alternatives (readable code, native type hints, direct field assignment). However, it is still in Alpha status with a first release only months old; production use should weigh stability risk against the benefits of better developer experience. No known vulnerabilities and permissive licensing are in its favor.
Install
protobuf-py on PyPI
Before you install
Low friction: pure wheel distribution, single runtime dependency (protobuf-py-ext), and active maintenance with a release within the past week.
Requires Python 3.10 or later. Code generation from .proto files requires external tooling; generated message classes must be created before importing and using them.
License in practice
Apache-2.0 permissive license allows use in commercial and open-source projects without significant restrictions.
Quickstart
from protobuf_py import Message
# After code generation from .proto files:
user = Message(id="123", first_name="Alice")
data = user.to_binary()
user = Message.from_binary(data)
print(user.to_json())Verify before relying
- Whether protobuf-py-ext is a compiled extension or pure Python, and what system dependencies it may require.
- Performance benchmarks comparing encoder/decoder speed to other Protobuf implementations.
- Stability guarantees given the Alpha development status and recent first release date.
- Whether proto2 support is actually implemented or only proto3 is supported.
Package facts
| License | Apache-2.0 permissive |
| Python support | Supports the current Python release >=3.10 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 1 packageprotobuf-py-ext |
| Maintenance | Actively maintained 7 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 338,468 / month, #7,431 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 3 - AlphaIntended Audience :: DevelopersOperating System :: OS IndependentProgramming Language :: Python :: 3Programming Language :: Python :: 3 :: OnlyProgramming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.14Programming Language :: Python :: Free ThreadingTopic :: File FormatsTopic :: Software Development :: Libraries :: Python ModulesTyping :: Typed |
Evidence: protobuf_py-0.3.0-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 › “protobuf python library”
- protobuf-pyGenerates well-typed, readable Python code from Protocol Buffer…
- dbt-protosProvides Python Protocol Buffer bindings for dbt's public data…
- flyteidl2Provides Python protobuf message definitions and serialization…
Give your agent the search over MCP, or paste the wish link into any chat.
More Python Modules packages
Converts domain names between Unicode and ASCII-compatible encoding (Punycode) according to IDNA 2008 and Unicode Technical Standard 46, with security validation and broader script coverage than the standard library.
Install it if you work with internationalized domain names, need to validate domains, or use HTTP clients that depend on it transitively.
Setuptools is a Python build backend and package management tool that handles building, distributing, and installing Python packages, including support for C/C++ extension modules.
PyYAML parses and emits YAML 1.1 data format, enabling serialization and deserialization of configuration files and Python objects to and from human-readable YAML text.
Pydantic validates Python data structures against type hints, coercing and checking input at runtime to ensure it matches a declared schema.
Provides reusable metadata objects for use with PEP-593 `typing.Annotated` to express common constraints like bounds, collection sizes, and predicates on types.
Install it if you use or build libraries that need to express type constraints in a standardized, inspectable way—or if you want to annotate your own types with…
Provides runtime tools to inspect and introspect Python type annotations, enabling programmatic examination of type hints at execution time.
See also protobuf-py-ext · proto-schema-parser · betterproto · protovalidate · betterproto-rust-codec · protoc-gen-connect-python · betterproto2 · baml-bridge · proto-plus · dbt-protos