Skip to main content

ACOS Quick Start

Add attestation and continuous optimization in 5 minutes.

Prerequisites​

Step 1: Install the SDK​

pip install qcos-sdk[acos]

Step 2: Configure API Key​

export QCOS_API_KEY="qcos_live_your_key_here"

Step 3: Get Attestation for a Job​

from qcos import Client
from qcos.acos import AttestationClient

# Run a job first
client = Client()
job = client.optimize(
    qasm="OPENQASM 2.0; ...",
    backend="ionq_simulator",
    shots=1024
)

# Get attestation
attestation = AttestationClient()
cert = attestation.attest(job.job_id)

print(f"Attestation ID: {cert.attestation_id}")
print(f"Quality Score: {cert.quality_score:.2%}")
print(f"Fidelity: {cert.fidelity_estimate:.2%}")

Step 4: Check Backend Quality​

from qcos.acos import QualityMonitor

monitor = QualityMonitor()

# Get current quality status
status = monitor.get_status("ionq_aria")

print(f"Backend: {status.backend}")
print(f"Fidelity: {status.fidelity:.2%}")
print(f"Status: {status.status}")  # 'optimal', 'good', 'degraded'
print(f"Trend: {status.trend}")    # 'improving', 'stable', 'degrading'

Step 5: Use Continuous Optimization​

from qcos.acos import ContinuousOptimizer

optimizer = ContinuousOptimizer()

# Optimize for current calibration
result = optimizer.optimize(
    qasm="OPENQASM 2.0; ...",
    backend="ionq_aria",
    use_current_calibration=True
)

print(f"Original depth: {result.original_depth}")
print(f"Optimized depth: {result.optimized_depth}")
print(f"Improvement: {result.improvement:.1%}")
print(f"Expected fidelity: {result.expected_fidelity:.2%}")

Step 6: Set Up Alerts​

from qcos.acos import AlertManager

alerts = AlertManager()

# Alert when fidelity drops
alerts.create(
    name="fidelity-alert",
    backend="ionq_aria",
    metric="fidelity",
    condition="below",
    threshold=0.90,
    webhook="https://your-app.com/alert"
)

print("Alert created!")

Step 7: View Historical Quality​

from qcos.acos import QualityMonitor
from datetime import datetime, timedelta

monitor = QualityMonitor()

# Get last 24 hours
history = monitor.get_history(
    backend="ionq_aria",
    start=datetime.now() - timedelta(hours=24),
    end=datetime.now()
)

for point in history.data_points:
    print(f"{point.timestamp}: Fidelity {point.fidelity:.2%}")

Complete Example​

#!/usr/bin/env python3
"""ACOS Complete Example"""

from qcos import Client
from qcos.acos import AttestationClient, ContinuousOptimizer, QualityMonitor

def main():
    # Initialize clients
    client = Client()
    attestation = AttestationClient()
    optimizer = ContinuousOptimizer()
    monitor = QualityMonitor()

    # Check backend quality first
    print("Checking backend quality...")
    status = monitor.get_status("ionq_simulator")
    print(f"Backend status: {status.status}")
    print(f"Current fidelity: {status.fidelity:.2%}")

    # Optimize circuit for current conditions
    print("\nOptimizing circuit...")
    qasm = """
    OPENQASM 2.0;
    include "qelib1.inc";
    qreg q[3];
    creg c[3];
    h q[0];
    cx q[0],q[1];
    cx q[1],q[2];
    measure q -> c;
    """

    optimized = optimizer.optimize(
        qasm=qasm,
        backend="ionq_simulator",
        use_current_calibration=True
    )

    print(f"Original depth: {optimized.original_depth}")
    print(f"Optimized depth: {optimized.optimized_depth}")
    print(f"Improvement: {optimized.improvement:.1%}")

    # Execute optimized circuit
    print("\nExecuting optimized circuit...")
    job = client.optimize(
        qasm=optimized.optimized_qasm,
        backend="ionq_simulator",
        shots=1024
    )

    print(f"Job ID: {job.job_id}")

    # Get attestation
    print("\nGetting attestation...")
    cert = attestation.attest(
        job.job_id,
        include_metrics=True
    )

    print(f"Attestation ID: {cert.attestation_id}")
    print(f"Quality Score: {cert.quality_score:.2%}")
    print(f"Fidelity Estimate: {cert.fidelity_estimate:.2%}")

    # Export attestation
    cert.export("attestation.json")
    print("\nAttestation saved to attestation.json")

    print("\n✅ ACOS workflow complete!")

if __name__ == "__main__":
    main()

REST API Direct Usage​

Get Attestation​

curl -X POST https://api.softquantus.com/api/v2/acos/attest \
  -H "Authorization: Bearer $QCOS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"job_id": "job_xyz789"}'

Check Backend Quality​

curl https://api.softquantus.com/api/v2/acos/quality/ionq_aria \
  -H "Authorization: Bearer $QCOS_API_KEY"

Optimize with Current Calibration​

curl -X POST https://api.softquantus.com/api/v2/acos/optimize \
  -H "Authorization: Bearer $QCOS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "qasm": "OPENQASM 2.0; ...",
    "backend": "ionq_aria",
    "use_current_calibration": true
  }'

Next Steps​

© 2024-2026 SoftQuantus Innovative OÜ