QONTOS Benchmarks

Reproducible evidence, methodology, and regression validation for the QONTOS platform.

The public proof layer for correctness claims across the SDK, simulator, and modular execution stack.

Overview · Installation · Quick Start · Docs Hub · Benchmark Suite · Methodology · Report Format

QONTOS Benchmarks is the public evidence repo for the QONTOS platform. It contains benchmark definitions, execution methodology, report schemas, and reproducible outputs used to validate correctness, performance, and regression behavior across the public QONTOS stack. This repository is the reference point for public technical claims made by QONTOS.

Start with docs/index.md for the lightweight docs hub and the key benchmark evidence pages. For the canonical install and release policy across the public repos, use the shared policy.

pip install "qontos-bench @ git+https://github.com/qontos/[email protected]"

Note: Once published to PyPI, this will simplify to pip install qontos-bench.

git clone https://github.com/qontos/qontos-benchmarks.git
cd qontos-benchmarks
pip install -e ".[dev]"
pytest

CI validates both paths: the released-tag install (on main push) and the local-checkout install (on every PR).

# Run the full benchmark suite
python -m qontos_bench

# Run a specific benchmark
python -m qontos_bench --benchmark bell_pair

# Generate a report
python -m qontos_bench --report json --output results.json

Each benchmark is executed through the full QONTOS pipeline:

1. Circuit normalization via CircuitNormalizer
2. Execution via LocalSimulatorExecutor (Qiskit Aer)
3. Fidelity computation: F = (expected state counts) / total_shots

Pass threshold: 0.85. Default shot count: 8,192.

These benchmarks validate pipeline correctness — that the ingest-normalize-execute path preserves circuit semantics. They are designed to detect regressions, not to measure hardware noise characteristics.

• Backend: Qiskit Aer AerSimulator (noiseless statevector)
• Shot count: 8,192 (configurable)
• Fidelity definition: fraction of shots landing in expected states
• All results are simulator-based until hardware QPU integration

{
  "timestamp": "2026-03-23T12:00:00Z",
  "backend": "aer_simulator",
  "shots": 8192,
  "benchmarks": [
    {
      "name": "bell_pair",
      "qubits": 2,
      "fidelity": 1.0,
      "passed": true,
      "counts": {"00": 4096, "11": 4096}
    }
  ]
}

Apache License 2.0

Built by Zhyra Quantum Research Institute (ZQRI) — Abu Dhabi, UAE