veriqant-bench 0.1.0

Standardized, reproducible benchmark suites for quantum processors — produces signed Quantum Performance Records (QPRs)

veriqant-bench

Standardized, reproducible benchmark suites for quantum processors. Runs against local simulators by default and against live QPUs behind an explicit --live flag. Every run produces a Quantum Performance Record (QPR) — a versioned, hash-sealed JSON document containing everything needed to re-run and independently verify the benchmark: seed, OpenQASM 3 circuits, transpiler settings, raw counts, SDK versions.

pip install veriqant-bench            # core (QPR schema + verification)
pip install veriqant-bench[local]     # + Qiskit Aer simulation (no account needed)
pip install veriqant-bench[braket]    # + Amazon Braket (local simulator + live)
pip install veriqant-bench[ibm]       # + IBM Quantum runtime
pip install veriqant-bench[qec]       # + QEC decoding (PyMatching) + Stim oracle
pip install veriqant-bench[signing]   # + Ed25519 QPR signing

CLI

# Run benchmarks (one sealed, self-verified QPR per run; last line prints
# the output path and the record's content hash):
veriqant-bench run rb --adapter aer --qubits 0 --out results/
veriqant-bench run rb --adapter aer --qubits 0,1 --out results/        # 2Q RB
veriqant-bench run mirror --qubits 0,1,2 --depths 2,4,8 --out results/
veriqant-bench run qv --widths 2,3,4 --circuits 50 --out results/
veriqant-bench run throughput --batches 5 --out results/
veriqant-bench run qec --code repetition --distances 3,5,7 --rounds 7 \
    --criteria ab-lq-2026 --noise noise.json --out results/
veriqant-bench run qec --code surface --distance 3 --rounds 3 --out results/
veriqant-bench run rb --noise noise.json --seed 42 --out results/     # noisy Aer

# Static, self-contained HTML report (inputs verified first):
veriqant-bench report results/ -o report.html

veriqant-bench verify results/run.qpr.json   # re-derive hashes, check consistency
veriqant-bench schema                        # print the bundled QPR JSON Schema
veriqant-bench adapters list                 # registered adapters + availability
veriqant-bench adapters probe aer_simulator  # capabilities, calibration, smoke run
veriqant-bench version

--seed is optional: when omitted, one is generated and printed; either way it is recorded in the QPR, so every run is reproducible.

Development

uv sync
uv run pytest                                # fast: no coverage gate
uv run pytest -n auto                        # parallel (pytest-xdist)
uv run pytest -m "not slow"                  # skip multi-second simulator runs
uv run pytest -n auto --cov=veriqant_bench --cov-fail-under=90   # the CI gate
uv run ruff check . && uv run ruff format --check . && uv run mypy

Writing an adapter

Implement the veriqant_bench.adapters.QPUAdapter protocol, register it under the veriqant_bench.adapters entry-point group, and certify it by subclassing veriqant_bench.adapters.conformance.AdapterConformanceSuite in your tests.

See docs/QPR-SPEC.md at the repository root for the record format.