This release is a pre-release and may not be stable for production use.
Kipu Quantum Hub Quantum SDK
The Kipu Quantum Hub Quantum SDK is for developing quantum circuits using Qiskit to be run on quantum devices provided by the Kipu Quantum Hub. This library is an extension for Qiskit. This means that you are able to seamlessly integrate and reuse your existing Qiskit code, leveraging the power and familiarity of a framework you are already accustomed to.
Getting Started
Check out the following guides on how to get started with Kipu Quantum Hub:
Requirements
- Python 3.11+
uvfor development and dependency management
Installation
The package is released on PyPI and can be installed via pip:
pip install --upgrade qhub-quantum
To install a pre-release version, use the following command:
pip install --pre --upgrade qhub-quantum
A pre-release is published from
mainwithout review, and its number is a build counter, not a forecast of the next stable version.1.13.2rc2can ship as1.14.0.
Stable releases are gated behind a merge request; see the release process.
Usage
Working with Qiskit Backends
You can execute a Qiskit circuit on a selected backend, retrieve its job object, and its results:
from qhub.quantum.sdk import HubQiskitProvider
from qiskit import QuantumCircuit, transpile
# Initialize the provider
provider = HubQiskitProvider()
# Select a backend, full list of backends can be found at https://platform.planqk.de/quantum-backends
backend = provider.get_backend("azure.ionq.simulator")
# Create a Qiskit circuit
circuit = QuantumCircuit(3, 3)
circuit.h(0)
circuit.cx(0, 1)
circuit.cx(1, 2)
circuit.measure(range(3), range(3))
# Transpile the circuit for the selected backend
circuit = transpile(circuit, backend)
# Execute the circuit on the selected backend
job = backend.run(circuit, shots=100)
# Monitor job status and get results
print(f"Status: {job.status()}")
print(f"Result: {job.result()}")
Working with Braket Devices
You can execute a Braket circuit on a selected device, retrieve its task object, and its results:
from braket.circuits import Circuit
from qhub.quantum.sdk import HubBraketProvider
# Select the IonQ Forte device
device = HubBraketProvider().get_device("aws.ionq.forte")
# Create a Braket circuit
circuit = Circuit().h(0).cnot(0, 1).cnot(1, 2)
# Execute the circuit with 100 shots
task = device.run(circuit, 100)
# Monitor task status and get results
print(f"Status: {task.state()}")
print(f"Result: {task.result()}")
Development
To create a new virtual environment, for example, run:
uv venv
uv sync
Then, to activate the environment:
source .venv/bin/activate
Update dependencies and lock files:
uv sync -U
Testing
Run the test suite with:
pytest
Linting
Lint and format with ruff:
ruff check .
ruff format .
License
Apache-2.0 | Copyright 2023-present Kipu Quantum GmbH
4 maintainers
Metadata
4 maintainers
Release files for qhub-quantum 1.14.0rc2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| qhub_quantum-1.14.0rc2.tar.gz | 2.8 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| qhub_quantum-1.14.0rc2-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 2.9 MB
Release files / qhub_quantum-1.14.0rc2.tar.gz
| Download URL | qhub_quantum-1.14.0rc2.tar.gz |
|---|---|
| Size | 2.8 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
4deefe51edbf75b5c623518a884145bb392e1e6a3322b40a47e02fe11fb74bae
|
|
BLAKE2b-256 checksum How to use checksums |
f13fc738cbbc91c8dfff9e0b147686484f060e472b0c6407e543bd6be3038fed
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.11.33 {"installer":{"name":"uv","version":"0.11.33","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / qhub_quantum-1.14.0rc2-py3-none-any.whl
| Download URL | qhub_quantum-1.14.0rc2-py3-none-any.whl |
|---|---|
| Size | 173.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
b94cbc39c99fc3a8bf91d179864a4560755338d87fbcb1d81f6b0756a19c2e15
|
|
BLAKE2b-256 checksum How to use checksums |
9d11cd93bec82d4a4e2a05eea2ced576d8dea110e6917fadb61cf35d45ef6cc7
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.11.33 {"installer":{"name":"uv","version":"0.11.33","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
