softqcos-sdk 3.5.0

SoftQCOS™ SDK — Full-coverage Python client for the QCOS™ API Gateway

SoftQCOS™ SDK v2.0

Full-coverage Python client for the SoftQuantus QCOS™ API Gateway — all 293 API routes, typed, with sync & async support.

pip install softqcos-sdk

Quick Start

from softqcos_sdk import QCOSClient

client = QCOSClient(api_key="sk-...")

# Submit a quantum job
job = client.jobs.submit(qasm="OPENQASM 2.0; ...", shots=1024)
result = client.jobs.wait(job["job_id"])
print(result["counts"])

# Or use the blocking shortcut
result = client.execute(qasm="OPENQASM 2.0; ...", shots=1024)

Product APIs

Property	Product	Prefix
client.jobs	QCOS Jobs™	/api/v2/jobs/*
client.circuits	QCOS Circuits™	/api/v2/circuits/*
client.bench	QCOS Bench™	/api/v2/bench/*
client.calibration	QCOS GlassBox™	/api/v2/glassbox/*
client.billing	QCOS ROI Engine™	/api/v2/roi/*
client.network	QCOS QuantumNet™	/api/v1/network/*
client.qec	QCOS QEC Runtime™	/api/v1/qec/*
client.isolation	QCOS ZoneGuard™	/api/v1/isolation/*
client.dri	QCOS DRI™	/api/v1/dri/*
client.ledger	QCOS QuantumLedger™	/api/v1/ledger/*
client.navcore	QCOS NavCore™	/api/v1/*
client.acos	ACOS-ISA™	/api/v1/acos/*
client.macro	Quantum Macro™	/api/v1/macro/*
client.admin	QCOS Admin	/api/admin/*
client.evidence	QCOS Evidence™	/api/v2/evidence/*
client.backends	QCOS Backends™	/api/v2/backends/*

Async Client

from softqcos_sdk import AsyncQCOSClient

async with AsyncQCOSClient(api_key="sk-...") as client:
    result = await client.get("/api/v2/jobs")

Configuration

Environment Variable	Description	Default
QCOS_API_KEY	API key (required if not passed to ctor)	—
QCOS_API_URL	API gateway URL	https://api.softquantus.com

Examples

# Calibration
devices = client.calibration.devices()
state = client.calibration.device_state("ibm_brisbane")

# Benchmarking
report = client.bench.run(backend="aer_simulator", suite="standard")
client.bench.verify(report["benchmark_id"])

# DRI — Device Reliability Index
dri = client.dri.run(backend="ibm_brisbane")
proof = client.dri.proof_run(backend="ibm_brisbane")

# Billing & ROI
estimate = client.billing.calculate(backend="ibm_brisbane", shots=10000)
plans = client.billing.plans()

# NavCore — GNSS/PNT
nav = client.navcore.navigate(lat=48.8566, lon=2.3522)
qrng = client.navcore.qrng_bytes(num_bytes=32)
key = client.navcore.pqc_keypair(algorithm="dilithium3")

# Network — Multi-QPU
topo = client.network.topology()
result = client.network.teleport(source="qpu_a", target="qpu_b", state=[1, 0])

# Error handling
from softqcos_sdk import QCOSError, AuthenticationError, RateLimitError

try:
    result = client.jobs.submit(qasm="invalid")
except RateLimitError as e:
    print(f"Rate limited — retry after {e.retry_after}s")
except AuthenticationError:
    print("Invalid API key")
except QCOSError as e:
    print(f"API error: {e}")

License

Copyright © 2024-2026 SoftQuantus innovative OÜ. All Rights Reserved.

QCOS™ is a trademark of SoftQuantus innovative OÜ. Registry Code: 17048927 | Tallinn, Estonia

• License: https://softquantus.com/legal/license
• EULA: https://softquantus.com/legal/eula
• Portal: https://platform.softquantus.com