Maestro

Built and tested on Ubuntu

A unified interface for quantum circuit simulation. Write your circuit once — Maestro picks the best backend and runs it on CPU, GPU, or distributed HPC.

Features

  • One API, many backends — compile from Qiskit / QASM to any supported simulator
  • Automatic backend selection — a prediction engine analyzes your circuit and routes it to the fastest backend
  • CPU simulation — statevector, MPS, Pauli propagation, Clifford/stabilizer
  • GPU acceleration — statevector (cuStateVec), MPS (custom CUDA), tensor network, Pauli propagation
  • Distributed simulation — p-block composite mode for distributed quantum computing
  • Expectation values — direct observable estimation (Pauli strings) for VQA workflows
  • Performance optimizations — automatic multi-threading, multi-processing, and optimized sampling

Quick Start

pip install qoro-maestro  # Linux, macOS & Windows

Or build from source:

chmod +x build.sh
./build.sh

For detailed build instructions, see INSTALL.md.

How It Works

Qiskit / QASM circuit
        ↓
Maestro Intermediate Representation
        ↓
Feature extraction  →  Prediction engine  →  Backend selection
        ↓
Execution (CPU / GPU / Distributed)
  1. Ingest — accepts circuits from Qiskit or QASM
  2. Convert — compiles to Maestro's intermediate representation
  3. Analyze — extracts features (gate density, entanglement, locality)
  4. Route — prediction engine estimates runtimes and selects the fastest backend
  5. Execute — runs on the chosen backend with automatic performance tuning

Backends

Type Backends
CPU Statevector (Aer, QCSim), MPS, Pauli propagation, Clifford/stabilizer
GPU Statevector (cuStateVec), MPS (CUDA), tensor network, Pauli propagation
Distributed p-block composite simulation

Each backend is accessed through a C++ adapter that maps Maestro's IR to the simulator's native API.

Documentation

Resource Link
Installation INSTALL.md
Tutorial & API TUTORIAL.md
Python examples maestro-examples

To generate API docs with Doxygen:

cd build
cmake ..
make doc
# Opens at docs/html/index.html

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.

Project links

Data verified by PyPI on Aug 4, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (0.3.1)

Owner

PyPI data
Data sourced directly from PyPI's database.

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for stephen.diadamo from gravatar.com stephen.diadamo

Credits

Author: Qoro Quantum

GitHub Statistics

Data verified by PyPI on Aug 4, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License

GNU General Public License v3 (GPLv3) (GPL-3.0)

Requires

Python >=3.10

Provides Extra

aer

Tags

quantum simulation circuit qiskit quantum-computing

Classifiers

Report project as malware

Download files

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

Source Distribution

qoro_maestro-0.2.16.tar.gz (418.9 kB view details)

Uploaded Source

Built Distributions

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

qoro_maestro-0.2.16-cp314-cp314-win_amd64.whl (6.5 MB view details)

Uploaded CPython 3.14Windows x86-64

qoro_maestro-0.2.16-cp314-cp314-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl (5.1 MB view details)

Uploaded CPython 3.14manylinux: glibc 2.27+ x86-64manylinux: glibc 2.28+ x86-64

qoro_maestro-0.2.16-cp314-cp314-macosx_14_0_arm64.whl (4.9 MB view details)

Uploaded CPython 3.14macOS 14.0+ ARM64

qoro_maestro-0.2.16-cp313-cp313-win_amd64.whl (6.4 MB view details)

Uploaded CPython 3.13Windows x86-64

qoro_maestro-0.2.16-cp313-cp313-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl (5.1 MB view details)

Uploaded CPython 3.13manylinux: glibc 2.27+ x86-64manylinux: glibc 2.28+ x86-64

qoro_maestro-0.2.16-cp313-cp313-macosx_14_0_arm64.whl (4.9 MB view details)

Uploaded CPython 3.13macOS 14.0+ ARM64

qoro_maestro-0.2.16-cp312-cp312-win_amd64.whl (6.4 MB view details)

Uploaded CPython 3.12Windows x86-64

qoro_maestro-0.2.16-cp312-cp312-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl (5.1 MB view details)

Uploaded CPython 3.12manylinux: glibc 2.27+ x86-64manylinux: glibc 2.28+ x86-64

qoro_maestro-0.2.16-cp312-cp312-macosx_14_0_arm64.whl (4.9 MB view details)

Uploaded CPython 3.12macOS 14.0+ ARM64

qoro_maestro-0.2.16-cp311-cp311-win_amd64.whl (6.4 MB view details)

Uploaded CPython 3.11Windows x86-64

qoro_maestro-0.2.16-cp311-cp311-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl (5.1 MB view details)

Uploaded CPython 3.11manylinux: glibc 2.27+ x86-64manylinux: glibc 2.28+ x86-64

qoro_maestro-0.2.16-cp311-cp311-macosx_14_0_arm64.whl (4.9 MB view details)

Uploaded CPython 3.11macOS 14.0+ ARM64

qoro_maestro-0.2.16-cp310-cp310-win_amd64.whl (6.4 MB view details)

Uploaded CPython 3.10Windows x86-64

qoro_maestro-0.2.16-cp310-cp310-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl (5.1 MB view details)

Uploaded CPython 3.10manylinux: glibc 2.27+ x86-64manylinux: glibc 2.28+ x86-64

qoro_maestro-0.2.16-cp310-cp310-macosx_14_0_arm64.whl (4.9 MB view details)

Uploaded CPython 3.10macOS 14.0+ ARM64

File details

Details for the file qoro_maestro-0.2.16.tar.gz.

File metadata

  • Download URL: qoro_maestro-0.2.16.tar.gz
  • Upload date:
  • Size: 418.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for qoro_maestro-0.2.16.tar.gz
Algorithm Hash digest
SHA256 9590f0db01757184768273bc1ef1a8d208cf688b111a7da9072d11d6deca22a6
MD5 ca8f5861eb94bb76fdee921950e810e9
BLAKE2b-256 885823cfc44e70e824eaf14f4e16e57eaa40d99f4784cda95a4f6f8c18950d7e

See more details on using hashes here.

Provenance

The following attestation bundles were made for qoro_maestro-0.2.16.tar.gz:

Publisher: publish-pypi.yml on QoroQuantum/maestro

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file qoro_maestro-0.2.16-cp314-cp314-win_amd64.whl.

File metadata

File hashes

Hashes for qoro_maestro-0.2.16-cp314-cp314-win_amd64.whl
Algorithm Hash digest
SHA256 daa4d739201d78211744b410c60efd52affd9d1f50c5d2172da895dc2792a44b
MD5 f8c59719e121a0a1bac90d027ed201bd
BLAKE2b-256 c11874d4d9110847cf37ad154bc261c019b60ba8e3af41d99b2190767349db66

See more details on using hashes here.

Provenance

The following attestation bundles were made for qoro_maestro-0.2.16-cp314-cp314-win_amd64.whl:

Publisher: publish-pypi.yml on QoroQuantum/maestro

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file qoro_maestro-0.2.16-cp314-cp314-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for qoro_maestro-0.2.16-cp314-cp314-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 51013bef9d18ea72d09ed3437d585d52a79dc74a57cff40b08247007beb4685d
MD5 8952b363091163cc3c41dbfb33f4b546
BLAKE2b-256 5d864dead6eaea092f044138b4a8ced890247dc2bbc7d742a806df3547df6cce

See more details on using hashes here.

Provenance

The following attestation bundles were made for qoro_maestro-0.2.16-cp314-cp314-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl:

Publisher: publish-pypi.yml on QoroQuantum/maestro

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file qoro_maestro-0.2.16-cp314-cp314-macosx_14_0_arm64.whl.

File metadata

File hashes

Hashes for qoro_maestro-0.2.16-cp314-cp314-macosx_14_0_arm64.whl
Algorithm Hash digest
SHA256 d129a351b58b6bf8308a571276c0f87f89891cef9d24088ba68d6b98a2003d79
MD5 47e3b24c765f91b9e869eca2c78be797
BLAKE2b-256 0b8c79d301e1cb9cd1d28702bf69b27be7b7b8d0e25a498c8063d17453c8de8f

See more details on using hashes here.

Provenance

The following attestation bundles were made for qoro_maestro-0.2.16-cp314-cp314-macosx_14_0_arm64.whl:

Publisher: publish-pypi.yml on QoroQuantum/maestro

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file qoro_maestro-0.2.16-cp313-cp313-win_amd64.whl.

File metadata

File hashes

Hashes for qoro_maestro-0.2.16-cp313-cp313-win_amd64.whl
Algorithm Hash digest
SHA256 10c6ff8b1d820f344938769b91ca209ff19efff9fe1f9e3be36a87a629f7917a
MD5 0545dd49c7ebce28e87ece9e91469dd1
BLAKE2b-256 5bdd730aa25245d8c8f83962b1d18c68db993b05643c727419a3f6b72af3579a

See more details on using hashes here.

Provenance

The following attestation bundles were made for qoro_maestro-0.2.16-cp313-cp313-win_amd64.whl:

Publisher: publish-pypi.yml on QoroQuantum/maestro

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file qoro_maestro-0.2.16-cp313-cp313-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for qoro_maestro-0.2.16-cp313-cp313-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 926109c9339558063bba2a4a4381e4e26462fd75241f33153a56c41f978fcb04
MD5 185ebebabae2a5f8c743f188d0527372
BLAKE2b-256 1f4a7bc29cd80c8ebd02f54ff93df67bca23d6535203ef90a90566bca8269277

See more details on using hashes here.

Provenance

The following attestation bundles were made for qoro_maestro-0.2.16-cp313-cp313-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl:

Publisher: publish-pypi.yml on QoroQuantum/maestro

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file qoro_maestro-0.2.16-cp313-cp313-macosx_14_0_arm64.whl.

File metadata

File hashes

Hashes for qoro_maestro-0.2.16-cp313-cp313-macosx_14_0_arm64.whl
Algorithm Hash digest
SHA256 7f68a3dc421f4162504dae1969e2e5b1a675d956f6d23243113da78dc62bbd70
MD5 94c7291f1f2e85016b490cd992cef9a1
BLAKE2b-256 66017c170e3db74710224a6089eecab11b2d8e96e8f79b8e648b1acdc8a64ede

See more details on using hashes here.

Provenance

The following attestation bundles were made for qoro_maestro-0.2.16-cp313-cp313-macosx_14_0_arm64.whl:

Publisher: publish-pypi.yml on QoroQuantum/maestro

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file qoro_maestro-0.2.16-cp312-cp312-win_amd64.whl.

File metadata

File hashes

Hashes for qoro_maestro-0.2.16-cp312-cp312-win_amd64.whl
Algorithm Hash digest
SHA256 96a506988d70cd240a37b1ed01b5aac1636dd6e6ab5320e16b101f336a8354a7
MD5 f0479421744ad779b87ff77c09b356dc
BLAKE2b-256 1455415c4c4a1144865522a79a64b5739f713a579b85227308cbb12323271349

See more details on using hashes here.

Provenance

The following attestation bundles were made for qoro_maestro-0.2.16-cp312-cp312-win_amd64.whl:

Publisher: publish-pypi.yml on QoroQuantum/maestro

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file qoro_maestro-0.2.16-cp312-cp312-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for qoro_maestro-0.2.16-cp312-cp312-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 7ad73755667f58ac5103afee21b6de560a1e7e53ab1db6644585dd3751a97d42
MD5 b6733de1b053c0cb4e3b7725d6b3f662
BLAKE2b-256 985759f0c91a86ae7dbfde2b8cd28bc1aa03e9397703e6a5dac752e7116d4bde

See more details on using hashes here.

Provenance

The following attestation bundles were made for qoro_maestro-0.2.16-cp312-cp312-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl:

Publisher: publish-pypi.yml on QoroQuantum/maestro

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file qoro_maestro-0.2.16-cp312-cp312-macosx_14_0_arm64.whl.

File metadata

File hashes

Hashes for qoro_maestro-0.2.16-cp312-cp312-macosx_14_0_arm64.whl
Algorithm Hash digest
SHA256 dd928df3309333773da5f2de69195974a7e34b60737ecd29839225eeca3dbdd7
MD5 a8a784855ae0e4e217a4d33a6defdd57
BLAKE2b-256 3ca22d59e7924498ea11e0acde18864de31061680d280389a7edb109ec802040

See more details on using hashes here.

Provenance

The following attestation bundles were made for qoro_maestro-0.2.16-cp312-cp312-macosx_14_0_arm64.whl:

Publisher: publish-pypi.yml on QoroQuantum/maestro

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file qoro_maestro-0.2.16-cp311-cp311-win_amd64.whl.

File metadata

File hashes

Hashes for qoro_maestro-0.2.16-cp311-cp311-win_amd64.whl
Algorithm Hash digest
SHA256 162b1f3feb31838cb70acea2e02488dbc79b9194aee0d13c0b1cdab0c33d575f
MD5 445321f955dc12bc7bbe26164b87c27e
BLAKE2b-256 befa3e6f4f010a2be49be3a833a2ba8608b7ca2c6581b6aca5b092b192edd62f

See more details on using hashes here.

Provenance

The following attestation bundles were made for qoro_maestro-0.2.16-cp311-cp311-win_amd64.whl:

Publisher: publish-pypi.yml on QoroQuantum/maestro

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file qoro_maestro-0.2.16-cp311-cp311-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for qoro_maestro-0.2.16-cp311-cp311-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 c06d3ad2172e01ec278be8459221f3edbac866d17d0946e5f8110a4c79340db1
MD5 33263687436a591d24a0dfc77417e386
BLAKE2b-256 ba352e9740c5703b0145b4a2fb24b15701aba8b5d803f9786309d917d4cd7b13

See more details on using hashes here.

Provenance

The following attestation bundles were made for qoro_maestro-0.2.16-cp311-cp311-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl:

Publisher: publish-pypi.yml on QoroQuantum/maestro

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file qoro_maestro-0.2.16-cp311-cp311-macosx_14_0_arm64.whl.

File metadata

File hashes

Hashes for qoro_maestro-0.2.16-cp311-cp311-macosx_14_0_arm64.whl
Algorithm Hash digest
SHA256 26d8911e9d0cc77fab2946554a69abca44b1892964fab3bb14e176fd1af76611
MD5 81f25b71c28c45cebff59c03b95e863d
BLAKE2b-256 0790140570af2f8e2534b23a2edc429b1c2ea7013b8f8d57ad4f93fc97fea34c

See more details on using hashes here.

Provenance

The following attestation bundles were made for qoro_maestro-0.2.16-cp311-cp311-macosx_14_0_arm64.whl:

Publisher: publish-pypi.yml on QoroQuantum/maestro

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file qoro_maestro-0.2.16-cp310-cp310-win_amd64.whl.

File metadata

File hashes

Hashes for qoro_maestro-0.2.16-cp310-cp310-win_amd64.whl
Algorithm Hash digest
SHA256 a6e52ec75af1897461fcad52a1bf1af03fe37fc91be4bc6482d536e4ea5bb117
MD5 89186315defd4e5edf54753776595f37
BLAKE2b-256 8e57b973268c901368b6fc79f4670e822ee434d231364032575f875b0104f5dc

See more details on using hashes here.

Provenance

The following attestation bundles were made for qoro_maestro-0.2.16-cp310-cp310-win_amd64.whl:

Publisher: publish-pypi.yml on QoroQuantum/maestro

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file qoro_maestro-0.2.16-cp310-cp310-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for qoro_maestro-0.2.16-cp310-cp310-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 72dab9f632fc5715cf367bc6495094fb6f97691fbe5d71dbfbfd68aeadf0447d
MD5 92ae5ba901b9307ebb8724bf88e6fb46
BLAKE2b-256 0c0a381fd7b65896d6108608de5214e97d9cd109ca47a628ab27c7a459afb2a0

See more details on using hashes here.

Provenance

The following attestation bundles were made for qoro_maestro-0.2.16-cp310-cp310-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl:

Publisher: publish-pypi.yml on QoroQuantum/maestro

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file qoro_maestro-0.2.16-cp310-cp310-macosx_14_0_arm64.whl.

File metadata

File hashes

Hashes for qoro_maestro-0.2.16-cp310-cp310-macosx_14_0_arm64.whl
Algorithm Hash digest
SHA256 7bdfac15fe69bcb947c5ad4c2bc5427c75619545c47219a7fb375b3c981d61ad
MD5 e671aeb54ed77f92a43c4f1d482cf28f
BLAKE2b-256 92e466c5fefcd46f18c9fca05aadd340f8dd94b370bb4928c2e2a441232213b2

See more details on using hashes here.

Provenance

The following attestation bundles were made for qoro_maestro-0.2.16-cp310-cp310-macosx_14_0_arm64.whl:

Publisher: publish-pypi.yml on QoroQuantum/maestro

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

0.3.1

16 files

0.3.0

16 files

0.2.19

16 files

0.2.18

16 files

0.2.17

16 files

This release

0.2.16 This release

16 files

0.2.15

16 files

0.2.14

16 files

0.2.12

16 files

0.2.11

16 files

0.2.10

10 files

0.2.9

10 files

0.2.8

10 files

0.2.7

10 files

0.2.6

10 files

0.2.5

10 files

0.2.4

10 files

0.2.3

7 files

0.2.2

7 files

0.2.1

7 files

0.2.0.post1

7 files

0.2.0.post0

7 files

0.2.0

7 files

0.1.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