Skip to main content

roro-quantum (Python SDK)

Run quantum circuits on the RoRo Quantum cloud with an API key.

pip install roro-quantum            # REST client
pip install "roro-quantum[qiskit]"  # + Qiskit BackendV2 provider

Quickstart

from roro import RoRoClient
from qiskit import QuantumCircuit

qc = QuantumCircuit(2)   # no explicit creg — measure_all() adds its own
qc.h(0); qc.cx(0, 1)
qc.measure_all()

roro = RoRoClient(api_key="qcs_live_…")
job = roro.submit_run("roro.sim.sv", shots=5000, circuit=qc, wait=True)
print(job["status"], job["counts"])   # completed {'00': ~2500, '11': ~2500}

You can also pass raw QASM 2.0 via qasm=... instead of circuit=....

Tip: don't call measure_all() on a circuit built as QuantumCircuit(2, 2) — Qiskit then appends a second classical register and your counts come back as 4-bit keys ('0000', '1100') instead of '00'/'11'.

"roro.sim.sv" is a target id — the targetId field of each machines() entry. (On the wire submit_run sends it as machineTargetId; the API accepts targetId as an alias.)

Qiskit provider

from qiskit import QuantumCircuit
from roro.provider import RoRoProvider

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

backend = RoRoProvider(api_key="qcs_live_…").get_backend("roro.sim.sv")
result = backend.run(qc, shots=5000).result()
print(result.get_counts())

API

Method Description
RoRoClient(api_key, base_url=…) Create a client
.machines() List available targets
.submit_run(target, shots=1024, qasm=None, circuit=None) Submit a run
.runs(limit=None, offset=None) / .run(id) List runs (newest first; paginate with limit 1–200 + offset, omit for full history) / fetch one

Errors raise roro.RoRoError (with .status). Get your API key in the console. Full docs: https://roroquantum.com/docs/.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

roro_quantum-0.4.1.tar.gz (15.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

roro_quantum-0.4.1-py3-none-any.whl (14.9 kB view details)

Uploaded Python 3

File details

Details for the file roro_quantum-0.4.1.tar.gz.

File metadata

  • Download URL: roro_quantum-0.4.1.tar.gz
  • Upload date:
  • Size: 15.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/7.0.0 CPython/3.12.13

File hashes

Hashes for roro_quantum-0.4.1.tar.gz
Algorithm Hash digest
SHA256 0cbc983176093133bb96062b85ab7b96f242ab26a7e53091a6d2bd0ef4f59273
MD5 5fedd151297415458b30f2daa85ce7db
BLAKE2b-256 3e50f64ee82fc98efeef8ee2512b8c5001b99393352d663584bc7a7710e3fda8

See more details on using hashes here.

File details

Details for the file roro_quantum-0.4.1-py3-none-any.whl.

File metadata

  • Download URL: roro_quantum-0.4.1-py3-none-any.whl
  • Upload date:
  • Size: 14.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/7.0.0 CPython/3.12.13

File hashes

Hashes for roro_quantum-0.4.1-py3-none-any.whl
Algorithm Hash digest
SHA256 250316d56a6b40234207ad50f57ee05f063ace26bca17c0db4c107ca73dfd91d
MD5 0fb461c82fa844c1cf9df5b972872f26
BLAKE2b-256 ec4ee5500af9312908987c5ff28f49a91b04677c50889cb8ae392ea7dafd3b22

See more details on using hashes here.

Release history Release notifications | RSS feed

This release

0.4.1 This release

2 files

0.3.0

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page