Quick Start¶

This guide walks through the recommended workflow: Provider → Backend → Circuit → Run.

Before you start, install the SDK (Installation Procedure for CPU only Mode or Installation Procedure for GPU Enabled Mode) and have your Quantum Rings credentials ready. To save credentials locally, see Saving the Quantum Rings account locally.

Step 1 — Provider¶

Create a provider with your account token and name:

import QuantumRingsLib
from QuantumRingsLib import QuantumRingsProvider

provider = QuantumRingsProvider(token=<YOUR_TOKEN_HERE>, name=<YOUR_ACCOUNT_NAME_HERE>)

Step 2 — Backend¶

Obtain a backend from the provider.

For CPU-only execution use scarlet_quantum_rings. For GPU mode use amber_quantum_rings. For hybrid mode use serin_quantum_rings.

backend = provider.get_backend("scarlet_quantum_rings")

Step 3 — Circuit¶

Build a simple circuit (for example, a 2-qubit Bell state):

from QuantumRingsLib import QuantumCircuit

qc = QuantumCircuit(2)
qc.h(0)
qc.cx(0, 1)
qc.measure_all()

Step 4 — Run¶

Execute the circuit and retrieve the result:

job = backend.run(qc, shots=100)
result = job.result()
print(result.get_counts())

Minimal end-to-end example¶

import QuantumRingsLib
from QuantumRingsLib import QuantumCircuit, QuantumRingsProvider

provider = QuantumRingsProvider(token=<YOUR_TOKEN_HERE>, name=<YOUR_ACCOUNT_NAME_HERE>)
backend = provider.get_backend("scarlet_quantum_rings")

qc = QuantumCircuit(2)
qc.h(0)
qc.cx(0, 1)
qc.measure_all()

job = backend.run(qc, shots=100)
result = job.result()
print(result.get_counts())