trailofbits/gh-action-adapt-sigstore-pypi — explained in plain English
Analysis updated 2026-07-25 · repo last pushed 2026-07-24
Add a step to your GitHub Actions release workflow so your PyPI package includes verifiable build provenance.
Convert GitHub-generated Sigstore bundles into PyPI-compatible attestation files before publishing a new package version.
Give package installers cryptographic proof that your PyPI release was built from a specific GitHub commit.
| trailofbits/gh-action-adapt-sigstore-pypi | 0-bingwu-0/live-interpreter | 010zx00x1/faresnipe | |
|---|---|---|---|
| Stars | 2 | 2 | 2 |
| Language | Python | Python | Python |
| Last pushed | 2026-07-24 | — | — |
| Maintenance | Active | — | — |
| Setup difficulty | easy | moderate | easy |
| Complexity | 2/5 | 2/5 | 2/5 |
| Audience | ops devops | general | general |
Figures from each repo's GitHub metadata at analysis time.
Requires an existing GitHub Actions release workflow that already generates Sigstore bundles, this action only does the conversion step.
When you publish a Python package to PyPI, you may want to prove to users exactly how it was built, what source code it came from, what build system was used, and so on. GitHub offers a tool that generates this kind of "proof" in a format called a Sigstore bundle. The problem is that PyPI expects this proof in a slightly different format, called a PyPI attestation. This action bridges that gap by converting GitHub's Sigstore bundles into the format PyPI can actually understand and display. In practice, you use it as a step in your GitHub Actions release workflow. First, another GitHub action generates the Sigstore bundles that describe your build. Then this action takes those bundles as input, translates them, and writes out converted attestation files to a directory you specify (or a temporary one if you don't). From there, you can upload those attestations alongside your package when publishing to PyPI. This is most useful for Python package maintainers who want to give their users strong, verifiable assurance that the package on PyPI was built from the expected source, not tampered with or replaced. For example, a library author releasing a new version to PyPI could use this so that anyone who installs the package can cryptographically verify it was built from the correct GitHub commit. It's particularly relevant for security-conscious projects or those following supply-chain hardening practices. The tool is narrowly scoped, it does one conversion step and nothing else. The README doesn't go into detail about the underlying differences between the two formats or what happens to fields that don't map cleanly between them. It's a small, focused utility designed to slot into an existing publishing pipeline rather than stand on its own.
A GitHub Actions step that converts GitHub Sigstore build-proof bundles into the format PyPI expects, so Python package publishers can attach verifiable build attestations to their releases.
Mainly Python. The stack also includes Python, GitHub Actions, Sigstore.
Active — commit in last 30 days (last push 2026-07-24).
Setup difficulty is rated easy, with roughly 5min to a first successful run.
Mainly ops devops.
This repo across BitVibe Labs
double-check against the repo, no cap.