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

Live API Benchmarks

Use the SDK's live execution mode to produce reproducible API artifacts from your machine. Each benchmark row captures request route, billing estimate, HTTP status, latency_ms, response_bytes, and response_sha256. This makes latency and behavior auditable without publishing proprietary backend implementation details.

Successful demo cases 26 / 26

All public demo execution cases returned a successful 2xx response in the published snapshot.

Median API latency 169.679 ms

End-to-end timing from the hosted demo endpoint for the published example run.

Response identity 26 hashes

Each case records response_sha256 for reproducible comparison without exposing private internals.

Run the API benchmark

pip install catalyst-q
catalyst-q-benchmark --execute-api --output-dir catalyst-q-live-api-benchmarks
catalyst-q-benchmark \
  --execute-api \
  --base-url https://api.strategic-innovations.ai/v3turbo \
  --output-dir catalyst-q-demo-api-benchmarks

Use --api-key for paid or production entitlements, --base-url for staging, and --timeout to make CI behavior explicit. The SDK docs domain also exposes a public v3turbo execution API for zero-credential smoke tests.

catalyst-q-benchmark \
  --execute-api \
  --base-url https://api.strategic-innovations.ai/v3turbo \
  --timeout 30 \
  --output-dir catalyst-q-live-api-benchmarks
published demo snapshot:
successful_api_cases: 26
median_latency_ms: 169.679
artifact: https://catalyst-q-sdk.strategic-innovations.ai/benchmarks/public/live-demo.json

Artifact fields

  • status_code for pass/fail and entitlement behavior.
  • latency_ms for end-to-end API timing.
  • response_bytes for payload-size tracking.
  • response_sha256 for reproducible response identity without exposing full data in summaries.

Example Python execution

from catalyst_q import CatalystQClient, QuantumCircuit, execute_prepared_request

client = CatalystQClient()
circuit = QuantumCircuit(2).h(0).cx(0, 1).measure(0, 0).measure(1, 1)
request = client.prepare_execute(circuit, workflow_id="live-bell", shots=1024)

result = execute_prepared_request(request, timeout=30)
print(result["ok"], result["status_code"], result["latency_ms"], result["response_sha256"])

Reproducibility policy

LayerWhat is measuredWhat is not claimed
Offline harnessSDK request generation, payload bytes, routes, billing estimates, suite coverage.Hosted execution latency or correctness.
Live API harnessHTTP status, latency_ms, response_bytes, response_sha256, parsed JSON when available.Formal asymptotic proof or private algorithm disclosure.
Published summaryStable case list and downloadable JSON artifact.User-specific production SLA or paid-tier performance.