Maestro
A unified interface for quantum circuit simulation, from your laptop to GPU workstations and MPI clusters. Build circuits in Python, import Qiskit circuits or OpenQASM 2.0, and run them through a common simulation API. Maestro also provides C/C++ interfaces and a native JSON request API.
What Maestro Can Do
- Simulate ideal and noisy circuits — sample measurement outcomes, access states and probabilities, and run circuits with mid-circuit measurements, resets, and classical control.
- Choose the right simulation method — statevector, density matrix, matrix product state (MPS), matrix product operator (MPO), tensor network, stabilizer, extended stabilizer, Pauli propagation, and path integral. Select a backend explicitly or use Maestro's prediction-based backend selection in network execution.
- Accelerate on GPUs and clusters — use NVIDIA GPU backends, distribute a statevector across local GPUs, or scale across nodes with MPI.
- Model hardware noise — Pauli and coherent errors, T1/T2 relaxation, crosstalk, readout errors, and time-correlated noise, with Monte Carlo execution and exact channel evolution on supported density-matrix and MPO backends.
- Study algorithms and error correction — compute Pauli expectation values, inner products, and mirror fidelity; use Stim/Sinter integration for quantum error correction sampling.
- Tune performance — gate fusion, optimized shot sampling, MPS/MPO swap routing, configurable tensor truncation, and parallel execution.
Quick Start
Requires Python 3.10 or newer. Pre-built wheels are available for Linux, macOS, and Windows.
pip install qoro-maestro
from maestro.circuits import QuantumCircuit
qc = QuantumCircuit()
qc.h(0)
qc.cx(0, 1)
qc.measure([(0, 0), (1, 1)])
result = qc.execute(shots=1024)
print(result["counts"]) # Approximately {"00": 512, "11": 512}
The default is CPU statevector simulation. Reuse the same circuit with a different backend by passing a maestro.SimulatorConfig to execute().
For source builds and the C++ library, see the installation guide.
CPU, GPU, and Distributed Execution
| Execution | Supported methods |
|---|---|
| CPU (QCSim; optional Qiskit Aer integration) | Statevector, density matrix, MPS, MPO, tensor network, stabilizer, extended stabilizer, Pauli propagation, path integral; availability varies by backend |
| NVIDIA GPU | Statevector, density matrix, MPS, MPO, tensor network, Pauli propagation, using CUDA and NVIDIA cuQuantum libraries |
| Local multi-GPU | Statevector distributed across GPUs within one node (DistributedGpu) |
| MPI + GPU | Statevector distributed across MPI ranks and GPUs on one or multiple nodes (DistributedMpiGpu) |
Maestro also supports p-block composite simulation and an optional QuEST statevector backend.
With the GPU plugin installed, select a single GPU using:
import maestro
config = maestro.SimulatorConfig(
simulator_type=maestro.SimulatorType.Gpu,
simulation_type=maestro.SimulationType.Statevector,
gpu_device=0,
)
result = qc.execute(shots=1024, config=config)
For larger statevectors, DistributedGpu spreads the state across local GPU memory. DistributedMpiGpu extends this to MPI clusters, allowing simulations beyond a single GPU's memory capacity. Both distributed backends currently support statevector simulation only.
GPU execution requires the corresponding acceleration plugin and compatible NVIDIA hardware and CUDA libraries. Distributed GPU plugins are Linux-only; MPI execution additionally requires CUDA-aware MPI. Run the same program on every rank, with matching simulation calls, using a launcher such as mpirun. See the GPU, multi-GPU, and MPI guide for plugin setup, licensing where required, device selection, and a complete MPI example.
Documentation
Browse the Doxygen documentation.
- Installation and source builds
- Python quick start and configuration · Circuit building · Simulation backends
- Noise modeling · Observables and algorithms · QEC with Stim/Sinter
- GPU and MPI execution
- C++ tutorial · C++ API reference
- Examples · Release notes
Citation
@article{bertomeu2025maestro,
title={Maestro: Intelligent Execution for Quantum Circuit Simulation},
author={Bertomeu, Oriol and Ghayas, Hamzah and Roman, Adrian and DiAdamo, Stephen},
organization={Qoro Quantum},
year={2025}
}
License
GPL-3.0 — see LICENSE or https://www.gnu.org/licenses/gpl-3.0.en.html.
1 maintainer
Metadata
1 maintainer
Release files for qoro-maestro 0.3.6
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| qoro_maestro-0.3.6.tar.gz | 931.1 kB | Details |
Built distributions (wheels)
Total release size: 234.8 MB
Release files / qoro_maestro-0.3.6.tar.gz
| Download URL | qoro_maestro-0.3.6.tar.gz |
|---|---|
| Size | 931.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
193be2ae1dd7519c55217731d3f88892d3b482b2769344a22a39f9e8e8116ffc
|
|
BLAKE2b-256 checksum How to use checksums |
e122162199fda0a2627e014c7d59bb258166db1d61c9aac536a4985b3d959afe
|
| 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 Oct 12, 2026.
Transparency logRelease files / qoro_maestro-0.3.6-cp314-cp314-win_amd64.whl
| Download URL | qoro_maestro-0.3.6-cp314-cp314-win_amd64.whl |
|---|---|
| Size | 13.8 MB |
| Tags | CPython 3.14 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
40c279d37a00cb52e335eef1c57aaf9f08a32a2012ee43449dfb846cb33ec5b6
|
|
BLAKE2b-256 checksum How to use checksums |
96873bbaa39ea1b365f528d9184c0bff6b69a785fb902af86ebc7a5f94cc9477
|
| 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 Oct 12, 2026.
Transparency logRelease files / qoro_maestro-0.3.6-cp314-cp314-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
| Download URL | qoro_maestro-0.3.6-cp314-cp314-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl |
|---|---|
| Size | 19.2 MB |
| Tags | CPython 3.14 Linux glibc 2.27+ x86-64 Linux glibc 2.28+ x86-64 |
|
SHA-256 checksum How to use checksums |
cf0925a063e45e8993c144f8e09a7c689cd91ba93b375151b9d856bd3dffd4c6
|
|
BLAKE2b-256 checksum How to use checksums |
c03ea2268e19d24dc7fb4fd66ef1e5cf92b253d6f0158025373f5482fc6df36f
|
| 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 Oct 12, 2026.
Transparency logRelease files / qoro_maestro-0.3.6-cp314-cp314-macosx_14_0_arm64.whl
| Download URL | qoro_maestro-0.3.6-cp314-cp314-macosx_14_0_arm64.whl |
|---|---|
| Size | 14.0 MB |
| Tags | CPython 3.14 macOS 14.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
20bb8125cebd6399b9f3ec8e8791d92ff98bce58afd48d740b530b347af3bbd7
|
|
BLAKE2b-256 checksum How to use checksums |
2305a75f4c672f7681e9a49b5af33da5c7f84c1c5a4bd433fe36fd02c34cf2e3
|
| 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 Oct 12, 2026.
Transparency logRelease files / qoro_maestro-0.3.6-cp313-cp313-win_amd64.whl
| Download URL | qoro_maestro-0.3.6-cp313-cp313-win_amd64.whl |
|---|---|
| Size | 13.5 MB |
| Tags | CPython 3.13 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
6a1c0a7305e2778c7cf67ca93b947422edcdf1caca8dd3dc57196143782edb6b
|
|
BLAKE2b-256 checksum How to use checksums |
0f1cbbdc4ec5548004dff4a08beaab14a5ae35c284e03427741204ff1d58ff3c
|
| 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 Oct 12, 2026.
Transparency logRelease files / qoro_maestro-0.3.6-cp313-cp313-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
| Download URL | qoro_maestro-0.3.6-cp313-cp313-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl |
|---|---|
| Size | 19.2 MB |
| Tags | CPython 3.13 Linux glibc 2.27+ x86-64 Linux glibc 2.28+ x86-64 |
|
SHA-256 checksum How to use checksums |
f9ab8f96819d5067ea3018d93ab6c178cda7174e010e56c55877cbf21e77f5a5
|
|
BLAKE2b-256 checksum How to use checksums |
06e9342d12dc4b8746401ad199f55ad5d4617a07fe8b5b724f51316d2eeb6b6d
|
| 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 Oct 12, 2026.
Transparency logRelease files / qoro_maestro-0.3.6-cp313-cp313-macosx_14_0_arm64.whl
| Download URL | qoro_maestro-0.3.6-cp313-cp313-macosx_14_0_arm64.whl |
|---|---|
| Size | 14.0 MB |
| Tags | CPython 3.13 macOS 14.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
4050b580d477b738c88edc36618fadacc147b25ac36ac771309734cd77b2ebf7
|
|
BLAKE2b-256 checksum How to use checksums |
eeb3c6d501b5548bb139f6996ea4b52ac9c604d9f3c2456257b8a6ac013bf84d
|
| 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 Oct 12, 2026.
Transparency logRelease files / qoro_maestro-0.3.6-cp312-cp312-win_amd64.whl
| Download URL | qoro_maestro-0.3.6-cp312-cp312-win_amd64.whl |
|---|---|
| Size | 13.5 MB |
| Tags | CPython 3.12 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
a122efed707f1805b80acfa5ae7720987041077b1687736bc2513809f8953974
|
|
BLAKE2b-256 checksum How to use checksums |
d25ed9ee7e534e126035288016543e65539da4f59294251b8d7e4adafcbce9b7
|
| 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 Oct 12, 2026.
Transparency logRelease files / qoro_maestro-0.3.6-cp312-cp312-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
| Download URL | qoro_maestro-0.3.6-cp312-cp312-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl |
|---|---|
| Size | 19.2 MB |
| Tags | CPython 3.12 Linux glibc 2.27+ x86-64 Linux glibc 2.28+ x86-64 |
|
SHA-256 checksum How to use checksums |
6c9829c15eae8ddc7be7beedd50c1219de71add1b26446821d9f078c70e9365b
|
|
BLAKE2b-256 checksum How to use checksums |
9b33f70c9afd930d6fd832abac83e33d837e18d3c91173ea255b21790b3e71bd
|
| 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 Oct 12, 2026.
Transparency logRelease files / qoro_maestro-0.3.6-cp312-cp312-macosx_14_0_arm64.whl
| Download URL | qoro_maestro-0.3.6-cp312-cp312-macosx_14_0_arm64.whl |
|---|---|
| Size | 14.0 MB |
| Tags | CPython 3.12 macOS 14.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
59f25749c9718af209988468bed98d001409382b83f4707955a28f4db5c4461c
|
|
BLAKE2b-256 checksum How to use checksums |
6af012a09ea5ecff06377863012724b0dfcf0717ea0cc6bd2ff2d4c0781c4199
|
| 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 Oct 12, 2026.
Transparency logRelease files / qoro_maestro-0.3.6-cp311-cp311-win_amd64.whl
| Download URL | qoro_maestro-0.3.6-cp311-cp311-win_amd64.whl |
|---|---|
| Size | 13.5 MB |
| Tags | CPython 3.11 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
97b83c3add93cd429163fefec34907a7136ef27d6e1fe414f5d1426ff246bcf5
|
|
BLAKE2b-256 checksum How to use checksums |
8e5de2ca3ac87abba4fd21b0e27d08a090a848318b0292b1264942f667a103a5
|
| 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 Oct 12, 2026.
Transparency logRelease files / qoro_maestro-0.3.6-cp311-cp311-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
| Download URL | qoro_maestro-0.3.6-cp311-cp311-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl |
|---|---|
| Size | 19.2 MB |
| Tags | CPython 3.11 Linux glibc 2.27+ x86-64 Linux glibc 2.28+ x86-64 |
|
SHA-256 checksum How to use checksums |
6ea8efcf0522cd17cb425ece8c4118704c0b3279b30a7caf387efe9ee1070124
|
|
BLAKE2b-256 checksum How to use checksums |
2fb0dda2d68a448696eb898e26697e4f5a4cfafeb737faac8504f1690deb0b04
|
| 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 Oct 12, 2026.
Transparency logRelease files / qoro_maestro-0.3.6-cp311-cp311-macosx_14_0_arm64.whl
| Download URL | qoro_maestro-0.3.6-cp311-cp311-macosx_14_0_arm64.whl |
|---|---|
| Size | 14.0 MB |
| Tags | CPython 3.11 macOS 14.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
704040a9d8688e125b268eb8e0f372c8c4ced4a434033c77ca4fee2efb5b49f4
|
|
BLAKE2b-256 checksum How to use checksums |
6933bbf462c4b57ec7874bdb1051dcba1a1a361f89cc607b22f4b77feff9f723
|
| 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 Oct 12, 2026.
Transparency logRelease files / qoro_maestro-0.3.6-cp310-cp310-win_amd64.whl
| Download URL | qoro_maestro-0.3.6-cp310-cp310-win_amd64.whl |
|---|---|
| Size | 13.5 MB |
| Tags | CPython 3.10 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
0d5a692c1c8d2fe4aaecedf99737fb16f823634bb68ef51025515391d90257d8
|
|
BLAKE2b-256 checksum How to use checksums |
d3d86efa73800eeb48dd8c4595a525f05d778e32d47a07f1871ec5ddaba6e52b
|
| 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 Oct 12, 2026.
Transparency logRelease files / qoro_maestro-0.3.6-cp310-cp310-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
| Download URL | qoro_maestro-0.3.6-cp310-cp310-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl |
|---|---|
| Size | 19.2 MB |
| Tags | CPython 3.10 Linux glibc 2.27+ x86-64 Linux glibc 2.28+ x86-64 |
|
SHA-256 checksum How to use checksums |
45efba33d768ce2ed859e505c8e12a908385a5038b3e8c66aa82476433364143
|
|
BLAKE2b-256 checksum How to use checksums |
1dbefb80d7937e4e19d28f87a7342c0a342b7db5a37b15d3981bdf92732cead7
|
| 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 Oct 12, 2026.
Transparency logRelease files / qoro_maestro-0.3.6-cp310-cp310-macosx_14_0_arm64.whl
| Download URL | qoro_maestro-0.3.6-cp310-cp310-macosx_14_0_arm64.whl |
|---|---|
| Size | 14.0 MB |
| Tags | CPython 3.10 macOS 14.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
6f8b5568c3b89e70ca3e0459c3b2fa93eb91686d79802aef1c78a8f505b92613
|
|
BLAKE2b-256 checksum How to use checksums |
2faaab75b665ee9fae2c3d7fc926c5f68c93f1269d04a282020fa1653f30227e
|
| 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 Oct 12, 2026.
Transparency log
