Skip to main content
python-sbom

python-sbom

PyPI Supported Python versions check Documentation Status Downloads OpenSSF Scorecard

Software bills of materials (SBOMs) for Python distributions. python-sbom writes a CycloneDX SBOM into every wheel you build, where PEP 770 (a Python Enhancement Proposal) tells installers to keep it. The SBOM records your project, the runtime dependencies it declares, any wheels it bundles, and the build toolchain, and a rebuild with the same inputs reproduces it byte for byte.

Use

python-sbom works with every build backend. Pick the integration for yours:

Backend Add to [build-system] requires Turn it on
hatchling python-sbom[hatch] [tool.hatch.build.hooks.python-sbom]
pdm-backend python-sbom[pdm] [tool.python-sbom]
setuptools python-sbom[setuptools] [tool.python-sbom]
any other, such as meson-python, maturin, scikit-build-core or flit-core python-sbom build-backend = "python_sbom.backend", and your backend in [tool.python-sbom]

With hatchling:

[build-system]
build-backend = "hatchling.build"
requires = ["hatchling>=1.28", "python-sbom[hatch]>=0.2"]

[tool.hatch.build.hooks.python-sbom]

With meson-python, or any backend without a plugin, python-sbom wraps it:

[build-system]
build-backend = "python_sbom.backend"
requires = ["meson-python>=0.18", "python-sbom>=0.2"]

[tool.python-sbom]
build-backend = "mesonpy"

For a wheel built outside the build interface, such as with maturin build, or renamed after it by auditwheel repair, embed the SBOM afterwards:

python-sbom embed dist/*.whl

To convert and validate SBOMs in continuous integration (CI), install the command line in a tool environment of its own with pipx or uv:

pipx install 'python-sbom[validate]'
python-sbom validate dist/

The documentation starts with a tutorial, then has a guide per backend, the options and commands, and how the SBOM is built. It also covers describing a zipapp, adding project knowledge through a content provider, and rendering an SBOM as SPDX (Software Package Data Exchange).

License

python-sbom's own code is under the MIT license. The wheel and source distribution also ship the schema files python-sbom validate checks documents against, unmodified from CycloneDX/specification, under the Apache-2.0 license. The package metadata covers both, so its license expression is MIT AND Apache-2.0.

Metadata

Release files for python-sbom 0.4.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for python-sbom 0.4.0
File Size Uploaded Provenance Actions
python_sbom-0.4.0.tar.gz 295.0 kB With provenance Details for python_sbom-0.4.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for python-sbom 0.4.0
File Interpreter ABI Platform Actions
python_sbom-0.4.0-py3-none-any.whl Python 3 none any Details for python_sbom-0.4.0-py3-none-any.whl

Total release size: 505.9 kB

Release files / python_sbom-0.4.0.tar.gz

Download URL python_sbom-0.4.0.tar.gz
Size 295.0 kB
Tags Source
SHA-256 checksum
How to use checksums
11467c49cf9302ce9fdbad4d30f38dcf174ec3afd82554241fd6884acf85510b
BLAKE2b-256 checksum
How to use checksums
2a10a988e40443b76f72f247198a47d029ea2cd879e6eb6896673b5c5c5d1537
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 19, 2026.

Transparency log

Release files / python_sbom-0.4.0-py3-none-any.whl

Download URL python_sbom-0.4.0-py3-none-any.whl
Size 210.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
8a0c472e9528b1da474eef4be890dbb5dc0f80da1064d650854fad438069343e
BLAKE2b-256 checksum
How to use checksums
915a1f37e450c6b369a691bd679e014ad72beec3cfb0d50d99460d0cc226b9c0
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 19, 2026.

Transparency log

Security for python-sbom 0.4.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for python_sbom-0.4.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 19, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page