explaingit

b7n0de/proofbundle

Analysis updated 2026-05-18

2PythonAudience · researcherComplexity · 3/5LicenseSetup · easy

TLDR

A tool that turns AI evaluation results into signed, tamper-proof receipts anyone can verify offline.

Mindmap

mindmap
  root((proofbundle))
    What it does
      Signed receipts
      Offline verification
      Tamper detection
    Tech stack
      Python
      Ed25519 signatures
      Merkle trees
    Use cases
      Verify eval results
      Prove threshold met
      Audit random samples
    Audience
      AI researchers
      Evaluation auditors

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Sign an AI evaluation result so anyone can later verify it was not tampered with.

USE CASE 2

Prove a benchmark score met a threshold without revealing the exact number.

USE CASE 3

Let an outside auditor spot-check random samples from a published evaluation run.

USE CASE 4

Pre-register an evaluation plan before running it to prevent cherry-picked results.

What is it built with?

PythonEd25519Merkle treesSD-JWT

How does it compare?

b7n0de/proofbundle0-bingwu-0/live-interpreter010zx00x1/faresnipe
Stars222
LanguagePythonPythonPython
Setup difficultyeasymoderateeasy
Complexity3/52/52/5
Audienceresearchergeneralgeneral

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min
MIT licensed, free to use for any purpose including commercial use, as long as the copyright notice is kept.

In plain English

proofbundle is a small Python tool that creates a tamper-proof receipt for an AI evaluation result. When someone reports a safety score or a capability benchmark for an AI model, there is usually no way to check the claim yourself, you just have to trust the lab that published it. proofbundle turns that kind of result into a single signed file that anyone can check offline, without a server or network connection, to confirm two specific things: that a stated party actually signed those exact numbers, and that nobody has quietly changed them since. It is important to understand what this tool does not do. A receipt does not prove the number itself is true, that the evaluation was designed well, that the issuer was honest, or that the underlying computation was correct. It only proves authorship and integrity, similar to how a cash register receipt proves a transaction happened and was not altered, not that the store treated the customer fairly. The README is upfront that this narrow guarantee is the entire point of the project, not a shortcoming. The technical approach relies on standard cryptographic signatures (Ed25519) and a tree-based structure called a Merkle tree that lets someone verify a large set of results piece by piece without needing everything at once. Optional features include selective disclosure, so a threshold can be proven while the exact score stays hidden, transparency log support so signed claims can be tracked publicly over time, and a per-sample auditing feature that lets an outside auditor spot-check random samples from a run. It also supports pre-registering an evaluation plan before running it, to make cherry-picked results after the fact visible. This is aimed at people building or reviewing AI evaluation pipelines: researchers running benchmarks, auditors checking published safety claims, or teams integrating with existing evaluation frameworks like inspect_ai or pytest. It installs via pip and includes a one-command demo that shows both a valid receipt and a set of deliberately tampered ones failing verification.

Copy-paste prompts

Prompt 1
Show me how to install proofbundle and run its offline demo to see a valid versus tampered receipt.
Prompt 2
Help me sign my AI eval results into a proofbundle receipt and verify it offline.
Prompt 3
Explain what a proofbundle receipt actually proves and what it does not prove.
Prompt 4
Walk me through using proofbundle's selective disclosure to hide my exact score while proving a threshold.

Frequently asked questions

What is proofbundle?

A tool that turns AI evaluation results into signed, tamper-proof receipts anyone can verify offline.

What language is proofbundle written in?

Mainly Python. The stack also includes Python, Ed25519, Merkle trees.

What license does proofbundle use?

MIT licensed, free to use for any purpose including commercial use, as long as the copyright notice is kept.

How hard is proofbundle to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is proofbundle for?

Mainly researcher.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.