Qrisp-Open Quantum Plugin

Beta. This plugin is in beta; its API and defaults may still change. Feedback is welcome in the Quantum Rings community.

A backend for the Qrisp quantum programming framework that submits circuits to the Open Quantum platform. Write high-level Qrisp programs and run them on real quantum hardware.

How it works

Qrisp already depends on Qiskit and can convert any circuit to a Qiskit circuit (QuantumCircuit.to_qiskit()). This backend uses that bridge to reuse the Open Quantum Qiskit plugin:

• OpenQuantumService handles authentication and backend discovery.
• The capability-aware OpenQuantumBackend (a Qiskit BackendV2) validates each circuit against the target device (gate set, coupling map, shot and qubit limits).
• export_circuit_to_qasm serialises to OpenQASM.

Submission runs through the framework-agnostic SchedulerClient in the core SDK. No separate QASM serializer or auth code is reimplemented here.

Installation

# Plugin (and core SDK + Qiskit plugin)
pip install openquantum-sdk-qrisp

# or via extras:
pip install "openquantum-sdk[qrisp]"

This pulls in qrisp, openquantum-sdk, and openquantum-sdk-qiskit.

Quick Start

from qrisp import QuantumVariable, h, cx
from qrisp_openquantum import OpenQuantumBackend

oq = OpenQuantumBackend(
    backend="ionq:aria-1",
    shots=1024,
    client_id="your_client_id",
    client_secret="your_client_secret",
)

qv = QuantumVariable(2)
h(qv[0])
cx(qv[0], qv[1])

print(qv.get_measurement(backend=oq, shots=1024))
# {'00': 0.5, '11': 0.5}

get_measurement returns Qrisp's decoded outcomes as probabilities (its own normalization, applied for every backend). To get integer shot counts, run a raw QuantumCircuit directly:

from qrisp import QuantumCircuit

qc = QuantumCircuit(2)
qc.h(0)
qc.cx(0, 1)
qc.measure([0, 1])

counts = qc.run(backend=oq, shots=1024)
# e.g. {'00': 518, '11': 506}

Authentication

Resolved in this order:

1. Pre-built service — pass service=OpenQuantumService(...) for full control (saved accounts, custom URLs, keyring).
2. Bearer token — pass token= or set OPENQUANTUM_TOKEN.
3. Client credentials — pass client_id= + client_secret= or set OPENQUANTUM_CLIENT_ID + OPENQUANTUM_CLIENT_SECRET.

OpenQuantumService.from_env() raises AuthenticationError when no credential resolves. Circuits are serialized with the public export_circuit_to_qasm helper from openquantum_sdk_qiskit. The older OPENQUANTUM_*_BASE URL names are not read here; those remain an MCP-only fallback.

Configuration

Backend-specific configuration

Some backends require extra fields. The free Quantum Rings simulator (qr:gpu-gb10) requires an engine:

oq = OpenQuantumBackend(
    backend="qr:gpu-gb10",
    shots=1024,
    configuration_data={"engine": "amber_quantum_rings"},
)

Bit ordering

Qrisp reads the leftmost character of a bitstring as the most-significant bit. The platform's counts are passed through unchanged by default. If a specific backend returns counts in the opposite order, construct the backend with reverse_bits=True.

License

Apache License 2.0