This release is a pre-release and may not be stable for production use.
BlueQubit Python SDK
BlueQubit Python SDK is a quantum computing SDK that lets you build, optimize, and run quantum circuits on BlueQubit platform from Python. Whether you need quantum simulation on large CPU/GPU devices or quantum circuit optimization at scale, this quantum development kit has you covered.
Quick Start
-
Register on https://app.bluequbit.io and copy the API token.
-
Install Python SDK from PyPI:
pip install bluequbit
- Import and initialize the SDK (importing also Qiskit for circuit building):
import qiskit
import bluequbit
bq_client = bluequbit.init("<token>")
- An example of how to run a Qiskit circuit using the SDK:
qc_qiskit = qiskit.QuantumCircuit(2)
qc_qiskit.h(0)
qc_qiskit.x(1)
job_result = bq_client.run(qc_qiskit, job_name="testing_1")
state_vector = job_result.get_statevector()
# returns a NumPy array of [0. +0.j 0. +0.j 0.70710677+0.j 0.70710677+0.j]
- Here is an example to run the previous code asynchronously:
# This line is non-blocking.
job = bq_client.run(qc_qiskit, job_name="testing_1", asynchronous=True)
# This line blocks until the job is completed.
job_result = bq_client.wait(job.job_id)
# If you want to cancel a pending job.
bq_client.cancel(job.job_id)
- This is how you can use our
mps.cpudevice:
# a 40 qubit GHZ state
num_qubits = 40
qc = qiskit.QuantumCircuit(num_qubits)
qc.h(0)
for i in range(num_qubits - 1):
qc.cx(i, i+1)
qc.measure_all()
options = {
"mps_bond_dimension": 2,
}
result = bq_client.run(qc, device="mps.cpu", options=options) # should take ~30seconds
print(result.get_counts())
The mps.gpu device can be used in the same way.
Note that while mps.gpu is faster, you need to have a certain amount of minimal balance to be able to use it.
- An example of how to use our Pauli Path Simulator to compute observable expectations:
qc = qiskit.QuantumCircuit(3)
qc.h(0)
qc.h(1)
qc.h(2)
qc.ry(0.3, 0)
qc.rz(0.6, 1)
qc.rx(0.7, 2)
# observable
pauli_sum = [
("XYZ", -0.5),
("XXX", 0.2),
("XII", 0.3),
("III", 0.4),
]
options = {
"pauli_path_truncation_threshold": 0.1,
}
result = bq_client.run(qc, device="pauli-path", pauli_sum=pauli_sum, options=options)
expectation_value = result.expectation_value
# returns 0.9411262759533625
- An example of how to run a Pennylane circuit:
import pennylane as qml
from pennylane import numpy as np
# use "bluequbit.cpu" device name to run on CPU
dev = qml.device("bluequbit.cpu", wires=1, token="<token>")
# use "bluequbit.gpu" device name to run on GPU
# dev = qml.device("bluequbit.gpu", wires=1, token="<token>")
@qml.qnode(dev)
def circuit(angle):
qml.RY(angle, wires=0)
return qml.probs(wires=0)
probabilities = circuit(np.pi / 4)
# returns a NumPy array of [0.85355339 0.14644661]
To use the Pennylane plugin, you must have pennylane version 0.39 or above installed.
bluequbit.cpu supports Pennylane circuits with up to 32 qubits (wires).
bluequbit.gpu supports Pennylane circuits with up to 33 qubits (wires).
- This SDK requires Python versions 3.10 or above. The package is tested extensively on Python 3.10.
Full reference
Please find detailed reference at https://app.bluequbit.io/sdk-docs.
Questions and Issues
Please submit questions and issues to info@bluequbit.io.
1 maintainer
Release files for bluequbit 0.18.12b1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| bluequbit-0.18.12b1.tar.gz | 92.1 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| bluequbit-0.18.12b1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 194.0 kB
Release files / bluequbit-0.18.12b1.tar.gz
| Download URL | bluequbit-0.18.12b1.tar.gz |
|---|---|
| Size | 92.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
775b7b69c0a46abb65911c59a4689883a498244a8a6cbad17fa686aad48198d6
|
|
BLAKE2b-256 checksum How to use checksums |
790d30612abc0acf02f470028e65e73d571ee349fc0e5b5ff52fb0347b2c8b0e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 31, 2026.
Transparency logRelease files / bluequbit-0.18.12b1-py3-none-any.whl
| Download URL | bluequbit-0.18.12b1-py3-none-any.whl |
|---|---|
| Size | 101.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
6f329a1fea35b6813dd99649cfee2c04ab9e637533085e77c0c2f9a20c1ab12d
|
|
BLAKE2b-256 checksum How to use checksums |
3adb99077caed3599918d4704e67761f283d470a9c09ed4642c3418d4dad178f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 31, 2026.
Transparency log
