CQ Catalyst-Q SDK

Exact Quantum and Optimization Execution for Production Teams

Submit Standard Inputs. Get Exact Results.

Catalyst-Q is a breakthrough simulator API and Python SDK for QASM circuits, SDK circuit objects, and optimization model payloads. Build with the inputs your team already uses, then validate outputs with reproducible benchmark artifacts.

pip install catalyst-q

# Controlled hosted index:
pip install --index-url https://catalyst-q-sdk.strategic-innovations.ai/simple catalyst-q

Public benchmark harness

Catalyst-Q ships a reproducible public benchmark harness in catalyst_q.benchmarks. It prepares SDK requests against respected public benchmark families and publishes a downloadable JSON artifact. The harness validates request generation, payload shape, billing estimates, and suite coverage. It is not a formal complexity proof and does not describe private execution internals.

Benchmark families 19 suites

QED-C, SupermarQ, QASMBench, MQT Bench, SATLIB, TSPLIB, OR-Library, Biq Mac, MIPLIB, and utility-scale datasets.

Runnable cases 26 cases

14 quantum request-prep cases and 12 solver request-prep cases.

Scale coverage 10,000 max qubits

The harness includes free-tier smoke cases and utility-scale request-shape cases.

Official corpus evidence

The current published official-corpus run covers SATLIB uf20-91: 1,000 named SATLIB random 3-SAT instances with 3,000 raw result rows across Catalyst-Q live API, Kissat, and CaDiCaL. It validates hosted SAT correctness on this corpus; it is not a SAT runtime superiority claim.

SolverValid recordsValid rateMedian runtime secondsTotal runtime seconds
Catalyst-Q live API1000 / 10001.0000000.54528125748.303935
Kissat local baseline1000 / 10001.0000000.01145670810.898355
CaDiCaL local baseline1000 / 10001.0000000.0092496048.845314

Source SHA256: be2835295e8500bb28f0314eba70bd0deaff1250b187260f7b6d0772bdf111a5. Source: https://www.cs.ubc.ca/~hoos/SATLIB/Benchmarks/SAT/RND3SAT/uf20-91.tar.gz.


The second published run covers OR-Library mknap1: 5 of 7 official multidimensional knapsack instances, with Catalyst-Q live API matching the official optimum on every selected case.

SolverValid recordsValid rateMedian runtime secondsTotal runtime seconds
Catalyst-Q live API5 / 51.0000000.0769667080.378504
Exact B&B reference5 / 51.0000000.0029670.014968

Source SHA256: 727c5f90b6acafa0896ce4b5b5559e2995303b735ee083a07e9b724738fac283. Source: https://people.brunel.ac.uk/~mastjjb/jeb/orlib/files/mknap1.txt.

Run it locally

catalyst-q-benchmark --output-dir catalyst-q-public-benchmarks
catalyst-q-benchmark --execute-api --output-dir catalyst-q-live-api-benchmarks
from catalyst_q import write_public_benchmark_artifacts

write_public_benchmark_artifacts("public-benchmark-results")
write_public_benchmark_artifacts("live-results", execute_api=True, timeout=30)
cd catalyst-q-benchmarks
PYTHONPATH=src:../sdk/python python scripts/run_official_corpus.py \
  --corpus satlib-uf20 \
  --execute-api \
  --policy-tier enterprise \
  --output-dir results/official_corpora/satlib_uf20_91

The generated report includes per-case suite, family, workload type, size label, compute units, payload bytes, request route, and citation URL. With --execute-api, each row also records status_code, latency_ms, response_bytes, and response_sha256.

Rigor guardrails

  • Use fixed deterministic cases for repeatable SDK results.
  • Keep public claims tied to generated artifacts.
  • Separate request-preparation validation from hosted execution results.
  • Use public suite names and source URLs instead of internal method names.

Coverage chart

Case matrix

IDSuiteFamilyTypeSizeCompute unitsPayload bytes
qedc_bernstein_vazirani_8QED-C Application-Oriented BenchmarksBernstein-Vaziranicircuit8-bit hidden string285,6961,778
supermarq_ghz_16SupermarQGHZcircuit16 qubits524,2882,060
supermarq_qaoa_ring_8SupermarQQAOA ringcircuit8 qubits, one layer393,2162,781
qasmbench_qft_5_qasmQASMBenchQFTqasm5 qubits112,6401,430
mqtbench_grover_6MQT BenchGrovercircuit6 qubits282,6242,107
satlib_random_3sat_20SATLIBRandom 3-SATsolver20 variables, 86 clauses1,7201,737
tsplib_euclidean_10TSPLIBEuclidean TSPsolver10 cities1001,166
orlib_mknap_12OR-Library Knapsack0/1 knapsacksolver12 items576883
orlib_portfolio_8OR-Library PortfolioCardinality-constrained portfoliosolver8 assets641,432
biqmac_qubo_6Biq Mac LibraryBinary quadratic optimizationsolver6 binary variables36985
biqmac_maxcut_6Biq Mac LibraryMax-Cutsolver6 nodes, 9 weighted edges541,049
cafa6_dag_optimization_12Catalyst BiocomputationDAG Optimizationsolver12 nodes, 11 dependencies1441,494
cafa6_full_adder_4Catalyst ArithmeticAddercircuit4 qubits36,8641,197
toy_shor_15_period_demoCatalyst ArithmeticToy Shor Period Democircuit8 qubits, classroom N=151,0241,360
google_echo_8Catalyst SamplingLoschmidt Echocircuit8 qubits442,3682,651
sat_competition_100SAT CompetitionRandom 3-SATsolver100 variables, 400 clauses5,7321,578
miplib_mknap_100MIPLIB 2017Integer Linear Programmingsolver100 items, 5 constraints2,427564
qasmbench_qft_500QASMBench AdvantageQuantum Fourier Transformcircuit500 qubits, 125,250 gates8,903,542173,722
benchpress_tfim_100SupermarQ & IBM BenchpressHamiltonian Simulationcircuit100 qubits, 10 steps186,96013,429
supermarq_qaoa_10000SupermarQ & IBM BenchpressQAOAcircuit10,000 qubits, 285,000 gates14,038,141209,077
qchem_femoco_108Quantum Chemistry (VQE)Hamiltonian Simulationcircuit108 qubits, 50,000 gates2,068,77449,968
large_arithmetic_4096_surrogateStructured ArithmeticReversible Arithmeticcircuit4,096 qubits, 100,000 gates4,262,95184,547
darpa_qbi_logistics_vrp_1000DARPA QBI (Utility Scale)Vehicle Routingsolver1,000 nodes, 100 vehicles100,000,0005,977,562
darpa_qbi_power_grid_2000DARPA QBI (Utility Scale)Unit Commitmentsolver2,000 generators, 24 periods1,152,00035,067
darpa_qbi_finance_2500DARPA QBI (Utility Scale)Portfolio Optimizationsolver2,500 assets6,250,00037,532,593
darpa_qbi_materials_hubbard_256DARPA QBI (Utility Scale)Materials Sciencecircuit256 qubits, 40,000 gates19,260,243,9682,910,233

External benchmark sources

SuiteWhy it mattersSource
QED-C Application-Oriented BenchmarksApplication-oriented quantum benchmarks with volumetric performance framing.QED-C publication
SupermarQScalable application benchmarks and hardware-agnostic feature vectors.SupermarQ paper page
QASMBenchOpenQASM suite for NISQ evaluation, compilers, schedulers, and simulators.PNNL QASMBench
MQT BenchCross-level benchmark generation for quantum software tooling.MQT Bench
SATLIBUniform SAT benchmark test bed using DIMACS CNF conventions.SATLIB
TSPLIBStandard TSP and related routing problem instance library.TSPLIB
OR-LibraryOperations research datasets for knapsack and portfolio optimization.Knapsack / Portfolio
Biq Mac LibraryBinary quadratic optimization and Max-Cut instances for optimization method testing.Biq Mac Library