---
id: substrait-protobuf
version: "0.100.0"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# substrait-protobuf — Generated Substrait Protocol Buffer Code

License: permissive · Maintenance: active · Downloads: 117.1K/mo

## What it is and what it does

substrait-protobuf is a generated Python package that exposes protobuf message definitions for the Substrait specification. Substrait is a cross-platform standard for representing query plans and expressions, and this package provides the Python bindings needed to work with those definitions programmatically.

The package is automatically generated and published whenever a new Substrait specification version is released, ensuring the bindings stay synchronized with the specification. It depends only on protobuf and requires Python 3.10 or later. The bindings are organized into modules like substrait.algebra_pb2, substrait.plan_pb2, and substrait.type_pb2, allowing you to import and use the message types directly in your code.

Use it for:

- Serialize and deserialize Substrait query plans in Python applications that need to exchange plans with other systems.
- Build query optimization or analysis tools that work with Substrait algebra and type definitions.
- Integrate Substrait specification support into data processing frameworks or query engines written in Python.

## Worth the install?

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

Provides Python protobuf bindings for the Substrait specification, enabling serialization and deserialization of Substrait algebra, plan, and type definitions.

Yes, if you are building Python tools that need to work with Substrait query plans or expressions. The package is actively maintained, has no known vulnerabilities, and carries a permissive license. Install friction is minimal. It is a straightforward protobuf binding with no hidden dependencies or gotchas.

## Install

pip install substrait-protobuf
uv add substrait-protobuf
poetry add substrait-protobuf

## Installing substrait-protobuf

Before you install: Low install friction with a single protobuf dependency. Actively maintained with releases tracking the Substrait specification; last commit 2026-08-14 and release 5 days prior indicate current development.

License in practice: Apache-2.0 permissive license allows commercial and private use with minimal restrictions.

Quickstart:

pip install substrait-protobuf

import substrait.algebra_pb2
import substrait.plan_pb2
import substrait.type_pb2

Requires Python >= 3.10

Verify before relying:

- Whether the package is suitable for production use in query engines or data systems beyond protobuf serialization
- Performance characteristics when handling large or deeply nested Substrait plans

## Package facts

- License: Apache-2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 117.1K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

substrait protobuf bindings, substrait python serialization, substrait message definitions, query plan protocol buffers, substrait specification python, protobuf, substrait, query-interchange

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