Introduction to Softquantus QCOS

Important (repo naming): the Python SDK import name is softqcos_sdk (distribution: softqcos-sdk). The import name softqcos is reserved for the QCOS core library in this monorepo. Internal engineering documentation lives in the private docs/ folder of the repository (employees only). This public site contains only end‑user documentation for the SDK/CLI/API and licensing deliverables.

Softquantus QCOS (Quantum Circuit Optimization Service) is a professional-grade platform for executing and optimizing quantum circuits across multiple quantum cloud providers. Built by Softquantus for researchers, developers, and enterprises who need reliable, high-performance quantum computing infrastructure.

What's New in v2.1 🚀

Multi-Supplier Support - Access 17+ quantum providers through a single unified API:

• Azure Quantum: IonQ, Rigetti, Quantinuum, PASQAL (up to 100 qubits)
• IBM Quantum: IBM simulators and QPUs (up to 127 qubits)
• AWS Braket: Amazon, IonQ, Rigetti, OQC, IQM, QuEra (up to 256 qubits)

Read more: v2.1 Overview

What is QCOS?

QCOS provides three ways to interact with our quantum execution infrastructure:

Interface	Best For	Features
Python SDK	Application development	Multi-supplier, async support, Qiskit/Cirq integration
CLI	Scripting & automation	Batch processing, provider selection, CI/CD
REST API	Custom integrations	Language-agnostic, webhooks, enterprise features

Key Features

🌐 Multi-Supplier Access (New in v2.1)

Execute on 17+ quantum providers across 3 major cloud platforms:

• Automatic failover across suppliers
• Cost optimization - choose cheapest provider
• Provider discovery - list available backends dynamically
• Unified API - same interface for all suppliers

⚡ GPU-Accelerated Execution

Execute quantum circuits on NVIDIA A100 GPUs through the LUMI supercomputer, one of the world's most powerful HPC systems.

• Up to 100 qubits for state vector simulation
• 10-100x faster than CPU-based simulators
• cuStateVec backend for optimal GPU utilization

🔐 Enterprise Security

• API key authentication with role-based access
• Encryption in transit (TLS 1.3) and at rest
• SOC2-ready infrastructure
• Audit logging for compliance

📊 Transparent Pricing

Tier	Jobs/Day	Max Qubits	Providers	Price
Free	100	34	Simulators only	$0
Pro	1,000	127	All simulators + QPUs	$99/mo
Enterprise	Unlimited	256	All providers	Custom

Quick Start

Option 1: Python SDK

from softqcos_sdk import QCOSClient

# Initialize client
client = QCOSClient(api_key="your-api-key")

# Execute a Bell state circuit
result = client.execute(
    qasm="""
    OPENQASM 2.0;
    include "qelib1.inc";
    qreg q[2];
    creg c[2];
    h q[0];
    cx q[0],q[1];
    measure q -> c;
    """,
    shots=1024
)

print(result.counts)
# {'00': 512, '11': 512}

Option 2: Command Line

# Install CLI
pip install softqcos-cli

# Configure credentials
softqcos configure --api-key your-api-key

# Execute circuit from file
softqcos execute circuit.qasm --shots 1024

# View results
softqcos status <job-id>

Option 3: REST API

# Legacy LUMI execution
curl -X POST https://sqt-prod-azure-api-ca.icybay-7dfb32ea.westeurope.azurecontainerapps.io/execute \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your-api-key" \
  -d '{
    "qasm": "OPENQASM 2.0; ...",
    "shots": 1024
  }'

# Multi-supplier execution (v2.1)
curl -X POST https://sqt-prod-azure-api-ca.icybay-7dfb32ea.westeurope.azurecontainerapps.io/api/v1/azure_quantum/execute \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your-api-key" \
  -d '{
    "qasm": "OPENQASM 2.0; ...",
    "backend": "ionq.simulator",
    "shots": 1024
  }'

Architecture Overview

┌─────────────────────────────────────────────────────────────┐
│                        QCOS Platform v2.1                    │
├─────────────────────────────────────────────────────────────┤
│                                                              │
│   ┌──────────┐   ┌──────────┐   ┌──────────┐                │
│   │ Python   │   │   CLI    │   │  REST    │                │
│   │   SDK    │   │          │   │   API    │                │
│   └────┬─────┘   └────┬─────┘   └────┬─────┘                │
│        │              │              │                       │
│        └──────────────┼──────────────┘                       │
│                       │                                      │
│                       ▼                                      │
│        ┌──────────────────────────────┐                     │
│        │  API Gateway (Azure Apps)     │                     │
│        │  sqt-prod-azure-api-ca        │                     │
│        └──────────────┬───────────────┘                     │
│                       │                                      │
│           ┌───────────┼───────────┐                         │
│           │           │           │                         │
│           ▼           ▼           ▼                         │
│    ┌──────────┐ ┌──────────┐ ┌─────────┐                   │
│    │  Azure   │ │   IBM    │ │  AWS    │                   │
│    │ Quantum  │ │ Quantum  │ │ Braket  │                   │
│    └────┬─────┘ └────┬─────┘ └────┬────┘                   │
│         │            │            │                         │
│    4 providers  4 backends  9+ devices                      │
│    (up to 100q) (up to 127q) (up to 256q)                   │
│                                                              │
│                       +                                      │
│                       │                                      │
│                       ▼                                      │
│        ┌──────────────────────────────┐                     │
│        │     LUMI Supercomputer        │                     │
│        │   AMD Instinct MI250X GPUs    │                     │
│        │   cuStateVec Simulator        │                     │
│        │   (Legacy /execute endpoint)  │                     │
│        └──────────────────────────────┘                     │
│                                                              │
└─────────────────────────────────────────────────────────────┘

Supported Formats

QCOS accepts quantum circuits in multiple formats:

• OpenQASM 2.0 - Industry standard quantum assembly
• OpenQASM 3.0 - Next-generation format (beta)
• Qiskit QuantumCircuit - Direct Python object (SDK only)
• Cirq Circuit - Google's quantum framework (SDK only)

Next Steps

• Installation Guide - Set up SDK, CLI, or API access
• Authentication - Get your API key
• First Circuit - Run your first quantum circuit
• Use Cases - Industry-specific examples

Support

• 📧 Email: support@softquantus.com
• 💬 Discord: Join Community
• 📚 GitHub: Issue Tracker

---

Patent Pending: FR2513440 | © 2025 SoftQuantus. All rights reserved.