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 20, 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 20, 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.19.tar.gz (484.5 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.19-cp314-cp314-win_amd64.whl (6.7 MB view details)

Uploaded CPython 3.14Windows x86-64

qoro_maestro-0.2.19-cp314-cp314-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl (5.2 MB view details)

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

qoro_maestro-0.2.19-cp314-cp314-macosx_14_0_arm64.whl (5.1 MB view details)

Uploaded CPython 3.14macOS 14.0+ ARM64

qoro_maestro-0.2.19-cp313-cp313-win_amd64.whl (6.6 MB view details)

Uploaded CPython 3.13Windows x86-64

qoro_maestro-0.2.19-cp313-cp313-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl (5.2 MB view details)

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

qoro_maestro-0.2.19-cp313-cp313-macosx_14_0_arm64.whl (5.1 MB view details)

Uploaded CPython 3.13macOS 14.0+ ARM64

qoro_maestro-0.2.19-cp312-cp312-win_amd64.whl (6.6 MB view details)

Uploaded CPython 3.12Windows x86-64

qoro_maestro-0.2.19-cp312-cp312-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl (5.2 MB view details)

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

qoro_maestro-0.2.19-cp312-cp312-macosx_14_0_arm64.whl (5.1 MB view details)

Uploaded CPython 3.12macOS 14.0+ ARM64

qoro_maestro-0.2.19-cp311-cp311-win_amd64.whl (6.6 MB view details)

Uploaded CPython 3.11Windows x86-64

qoro_maestro-0.2.19-cp311-cp311-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl (5.2 MB view details)

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

qoro_maestro-0.2.19-cp311-cp311-macosx_14_0_arm64.whl (5.1 MB view details)

Uploaded CPython 3.11macOS 14.0+ ARM64

qoro_maestro-0.2.19-cp310-cp310-win_amd64.whl (6.6 MB view details)

Uploaded CPython 3.10Windows x86-64

qoro_maestro-0.2.19-cp310-cp310-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl (5.2 MB view details)

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

qoro_maestro-0.2.19-cp310-cp310-macosx_14_0_arm64.whl (5.1 MB view details)

Uploaded CPython 3.10macOS 14.0+ ARM64

File details

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

File metadata

  • Download URL: qoro_maestro-0.2.19.tar.gz
  • Upload date:
  • Size: 484.5 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.19.tar.gz
Algorithm Hash digest
SHA256 4c158cdf2c132150e588792e61f85e6052765ea99faf7e53780889196e6a6e42
MD5 a2d18dad0cb20b730b12aa3e54150de9
BLAKE2b-256 576db9d0a86e499c09b370053a4f5312cfcf5bdecbc9b422fe9bfde2d3ec1c72

See more details on using hashes here.

Provenance

The following attestation bundles were made for qoro_maestro-0.2.19.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.19-cp314-cp314-win_amd64.whl.

File metadata

File hashes

Hashes for qoro_maestro-0.2.19-cp314-cp314-win_amd64.whl
Algorithm Hash digest
SHA256 509d1570e552137b4dc92c24f5e86fe8594345652c935825916bc6f3a3ba34b1
MD5 1be02f31e9578a8e6f765f8e597d220f
BLAKE2b-256 10925832c52dceb419f5ad07f47bc52ddf8919fb66c0c2015fa9ee822b92d2b6

See more details on using hashes here.

Provenance

The following attestation bundles were made for qoro_maestro-0.2.19-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.19-cp314-cp314-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for qoro_maestro-0.2.19-cp314-cp314-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 5cfd79851af0db3de2075cca7ce56e2ba5ddcd5cae7b45302caf12b48efa4931
MD5 47b95d5202c27d8d569c159f1dd0ca68
BLAKE2b-256 bbad237bde95bbcebfa845debb4f3bfeb21305a2ef13a430fa7f5c80813996e7

See more details on using hashes here.

Provenance

The following attestation bundles were made for qoro_maestro-0.2.19-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.19-cp314-cp314-macosx_14_0_arm64.whl.

File metadata

File hashes

Hashes for qoro_maestro-0.2.19-cp314-cp314-macosx_14_0_arm64.whl
Algorithm Hash digest
SHA256 72265bc842756fde0cd9e87711bcba0999b680f3647665a5c7f7a5aca7450d61
MD5 37dcce7bfa9f3417b149be3a93b94ee0
BLAKE2b-256 f222323e40a400f1fde1cca4ffd1ac1a57b7ce571ab207e25e27469086db1860

See more details on using hashes here.

Provenance

The following attestation bundles were made for qoro_maestro-0.2.19-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.19-cp313-cp313-win_amd64.whl.

File metadata

File hashes

Hashes for qoro_maestro-0.2.19-cp313-cp313-win_amd64.whl
Algorithm Hash digest
SHA256 374dffb4dab08bf6b3b5ed34792d609562163652c3a5601885ca0897fe4fb670
MD5 8519180c96fe6f38257309174c4e3a48
BLAKE2b-256 d775077a899081f8064342c50596eb7a3c0e9a61b7363f2a16211961f093450b

See more details on using hashes here.

Provenance

The following attestation bundles were made for qoro_maestro-0.2.19-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.19-cp313-cp313-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for qoro_maestro-0.2.19-cp313-cp313-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 7913a4074467c62f2b73417816fe41dd7397d622e357003ec913726af68a0dab
MD5 fbfb7130aaac2a2d3b73cacdef29c7d4
BLAKE2b-256 832b191e0fd15a028649b531d528210acfdb07840931ff6bfac04b1b702ce65e

See more details on using hashes here.

Provenance

The following attestation bundles were made for qoro_maestro-0.2.19-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.19-cp313-cp313-macosx_14_0_arm64.whl.

File metadata

File hashes

Hashes for qoro_maestro-0.2.19-cp313-cp313-macosx_14_0_arm64.whl
Algorithm Hash digest
SHA256 0bbf132698636a58e0a4abc46516a6533421e4e588a17ca40625dc51626a4b76
MD5 2ea0f98365235584625d52faef597926
BLAKE2b-256 8b59995f0f3f721334f7d7007dd6582da665143def7803817f6de46b8ec0d3ef

See more details on using hashes here.

Provenance

The following attestation bundles were made for qoro_maestro-0.2.19-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.19-cp312-cp312-win_amd64.whl.

File metadata

File hashes

Hashes for qoro_maestro-0.2.19-cp312-cp312-win_amd64.whl
Algorithm Hash digest
SHA256 6bb86ad3602c25783b200dab71cc59203a940c7ae1ff5b40bb11638145da06d3
MD5 68fe848da4754e459fe54e9d21832713
BLAKE2b-256 7af45db943182ff9570aa8da4cf7b176c02f3af67f6db77a3eae513b387390e2

See more details on using hashes here.

Provenance

The following attestation bundles were made for qoro_maestro-0.2.19-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.19-cp312-cp312-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for qoro_maestro-0.2.19-cp312-cp312-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 3e87d413e21b39429469b6efe60122e145559b63abbf339e3182793855642ce9
MD5 bec422933b50626c031aaa2dde30739b
BLAKE2b-256 b77fd7200e06c0c6c1ab6fcaf8d34a1831b4be336b6a6cf807911940f0e56ae5

See more details on using hashes here.

Provenance

The following attestation bundles were made for qoro_maestro-0.2.19-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.19-cp312-cp312-macosx_14_0_arm64.whl.

File metadata

File hashes

Hashes for qoro_maestro-0.2.19-cp312-cp312-macosx_14_0_arm64.whl
Algorithm Hash digest
SHA256 17fe6c104158a97c3b7a00e4915884862654b802f1d646e798d5306c3db74aaf
MD5 407ccddb6c0bcc2cda0b115060b5d8f6
BLAKE2b-256 f13a66a07914840c3c1f29dc791036c5c717dee6ca896da0ece68b6c5cc20ebb

See more details on using hashes here.

Provenance

The following attestation bundles were made for qoro_maestro-0.2.19-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.19-cp311-cp311-win_amd64.whl.

File metadata

File hashes

Hashes for qoro_maestro-0.2.19-cp311-cp311-win_amd64.whl
Algorithm Hash digest
SHA256 32e47cdb15e7bba02592ccffd984dd20ad9fdc283a14eb0a2ad0516dce3728d1
MD5 661cf2ca7e1c9359a2d183b475f5ac07
BLAKE2b-256 2628b5fc95c564b4959e8ffc178d16d85d56a40968e9ddc87f63b39062bf4690

See more details on using hashes here.

Provenance

The following attestation bundles were made for qoro_maestro-0.2.19-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.19-cp311-cp311-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for qoro_maestro-0.2.19-cp311-cp311-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 0b690e3e4f5593fbfe169c6b0acbd1dd2d4e5491fd0147ef4bb24441682d5fa6
MD5 98d0d2f19001e4d56fefec88b6ea1c61
BLAKE2b-256 abaf72a3d1951c9fc479535ad310a8dc9d86a03e9827364970e60a715c61f7a1

See more details on using hashes here.

Provenance

The following attestation bundles were made for qoro_maestro-0.2.19-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.19-cp311-cp311-macosx_14_0_arm64.whl.

File metadata

File hashes

Hashes for qoro_maestro-0.2.19-cp311-cp311-macosx_14_0_arm64.whl
Algorithm Hash digest
SHA256 6c8bc7497f0084d37ad7fd45af3fa06f64d29da8c8f7fa876af7b9a2f75934d7
MD5 c4faec525b0c0d002dfd7d80a20e9e0b
BLAKE2b-256 0a800b909c378676f2cc46d5b6930d560c012cc4e15d681fea164ad8074512e2

See more details on using hashes here.

Provenance

The following attestation bundles were made for qoro_maestro-0.2.19-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.19-cp310-cp310-win_amd64.whl.

File metadata

File hashes

Hashes for qoro_maestro-0.2.19-cp310-cp310-win_amd64.whl
Algorithm Hash digest
SHA256 779252c023761c2be4b0f20d94fad8bab36bcbac33ff136a9032a2db1ba1ef8c
MD5 af9e79afa47c1508a870e93166552352
BLAKE2b-256 bd5ee8cd8b98b2ca4033b2ba11b30a74749f3f185bf96b61230b55160167f041

See more details on using hashes here.

Provenance

The following attestation bundles were made for qoro_maestro-0.2.19-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.19-cp310-cp310-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for qoro_maestro-0.2.19-cp310-cp310-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 2658afef6792e729b3d98330f9efcb7ad895b63d8fc559521923e1d0a4227670
MD5 e91912454790fa65af0229d8524d9e0c
BLAKE2b-256 5dfbe867abf63002d848cca587ecda7fbc5cad48f64ccabb53a1034ac30cfe49

See more details on using hashes here.

Provenance

The following attestation bundles were made for qoro_maestro-0.2.19-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.19-cp310-cp310-macosx_14_0_arm64.whl.

File metadata

File hashes

Hashes for qoro_maestro-0.2.19-cp310-cp310-macosx_14_0_arm64.whl
Algorithm Hash digest
SHA256 c7e40ca98f74f7613ae5484aede0578f5295ff64a3a51f99968f31ea3eda59be
MD5 5613554a7dff9e6f48631792609dcae8
BLAKE2b-256 39e252f0fc717fd2962fbdd3ffb3d9c91b1d2bc369ce284a4f4b4ad9321233fb

See more details on using hashes here.

Provenance

The following attestation bundles were made for qoro_maestro-0.2.19-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

This release

0.2.19 This release

16 files

0.2.18

16 files

0.2.17

16 files

0.2.16

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