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.5.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.5.0
File Size Uploaded Provenance Actions
python_sbom-0.5.0.tar.gz 296.0 kB With provenance Details for python_sbom-0.5.0.tar.gz

Built distribution (wheel)

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

Total release size: 507.2 kB

Release files / python_sbom-0.5.0.tar.gz

Download URL python_sbom-0.5.0.tar.gz
Size 296.0 kB
Tags Source
SHA-256 checksum
How to use checksums
fc7b2c46fa40f52e587ac59cada775e83dcac231fafa90b7a71c3554527ddfb6
BLAKE2b-256 checksum
How to use checksums
eb2ac65b33d002f4cb910afbe3a9cae6fb12cdf348fe62fe48c2b746401b079f
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.5.0-py3-none-any.whl

Download URL python_sbom-0.5.0-py3-none-any.whl
Size 211.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
9d9e2075dd8d4ddcc60b52cd58551ec44239a939520bdee5be9f8f715cbae282
BLAKE2b-256 checksum
How to use checksums
7614fe9bb28561fdf76f3385446814e28683be7dce32ae1d2fe525a2d370a75d
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.5.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.5.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