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 Jul 21, 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 Jul 21, 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.15.tar.gz (418.3 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.15-cp314-cp314-win_amd64.whl (6.5 MB view details)

Uploaded CPython 3.14Windows x86-64

qoro_maestro-0.2.15-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.15-cp314-cp314-macosx_14_0_arm64.whl (4.9 MB view details)

Uploaded CPython 3.14macOS 14.0+ ARM64

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

Uploaded CPython 3.13Windows x86-64

qoro_maestro-0.2.15-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.15-cp313-cp313-macosx_14_0_arm64.whl (4.9 MB view details)

Uploaded CPython 3.13macOS 14.0+ ARM64

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

Uploaded CPython 3.12Windows x86-64

qoro_maestro-0.2.15-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.15-cp312-cp312-macosx_14_0_arm64.whl (4.9 MB view details)

Uploaded CPython 3.12macOS 14.0+ ARM64

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

Uploaded CPython 3.11Windows x86-64

qoro_maestro-0.2.15-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.15-cp311-cp311-macosx_14_0_arm64.whl (4.9 MB view details)

Uploaded CPython 3.11macOS 14.0+ ARM64

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

Uploaded CPython 3.10Windows x86-64

qoro_maestro-0.2.15-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.15-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.15.tar.gz.

File metadata

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

File hashes

Hashes for qoro_maestro-0.2.15.tar.gz
Algorithm Hash digest
SHA256 9eea0dab421a3b70453840dfd7bae6c2eb3e58881857091b5102ef08a3c616d3
MD5 07b65e6f1cfffd50894d03cfccbfce2b
BLAKE2b-256 c5d3b76991f3acb7c10dd1e10698c3418795d4f6fa94dd55d98e843de967c88a

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for qoro_maestro-0.2.15-cp314-cp314-win_amd64.whl
Algorithm Hash digest
SHA256 5954ee026c5572c268746ee27ff94c15f59df2201bd0fd18576f760a949530f5
MD5 e9a7deceed2d9cc52d1c7a6b417c0a18
BLAKE2b-256 de58d08334dcf4f88db1bec74e0c137594eaef0501c7a4c68bc390a260335ebb

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for qoro_maestro-0.2.15-cp314-cp314-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 1506e01f8f64e479566ba0c41f884e65f18b09e98fc7f8efa3dbf0c4e767c1af
MD5 5add6e3e7905dce51a721447bf4ef0a2
BLAKE2b-256 dabc7953908df05ad6ccb59fdd0f3dd83fc1b7521ff03469215b5655432395b7

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for qoro_maestro-0.2.15-cp314-cp314-macosx_14_0_arm64.whl
Algorithm Hash digest
SHA256 118d44c465c393a1df5a1cb4233185844e98ff97ace572bcc68fa9bc2b97abc1
MD5 5ffd0d522bb60b6c1be7e5cbf5d175c9
BLAKE2b-256 9cc62649e1734a5593c8fa26a136ca10656962b3ab062f8269f023386dcad192

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for qoro_maestro-0.2.15-cp313-cp313-win_amd64.whl
Algorithm Hash digest
SHA256 e0a4f1080d5b93c8fc3b9db8516e0e7d4669789f282bdf175cdd1ba08f141c85
MD5 cedc0e7ca91a433b854232b16671ca6f
BLAKE2b-256 3bf1a5c788f2553e964ffff9cadc9a0a0d611e802a22a3e48b87bcd5772f3e90

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for qoro_maestro-0.2.15-cp313-cp313-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 bf0c69ec5bdea87968e399712f1de0f9b66ca58499b6a46c60efa7e295be33c9
MD5 21db3bc22200751b7b0a202b698f8dab
BLAKE2b-256 885e9a6a10147beb75004f3f7917663ed4f7b7f6d284248a0090ab877084546e

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for qoro_maestro-0.2.15-cp313-cp313-macosx_14_0_arm64.whl
Algorithm Hash digest
SHA256 3684190d8716c6a7f69c4afb3a4aece9d3549361e8b74f53df161942976860c5
MD5 9b50b2e247a293e795d560d4442e179c
BLAKE2b-256 6830543816d0bbd31691c9abd3904d1a2fde193ab3910ad0c96658b098fb320b

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for qoro_maestro-0.2.15-cp312-cp312-win_amd64.whl
Algorithm Hash digest
SHA256 c3b66ce2a98267ce63565b6322ec53873ba8faeb78e8ab7cd19c38556fbe290c
MD5 e7ad72d4543b1618e168b11d5b2e8344
BLAKE2b-256 80d4c42972e043f5b4bea6c44f3c5cfc1889522a2c0138f4498b6459484366ae

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for qoro_maestro-0.2.15-cp312-cp312-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 ff6034137383671f49f74a1f4a98ab94717e922657f203d0ad100f13d8e16c68
MD5 5b2e93d81493f463f107a32b7303c386
BLAKE2b-256 2354d5cc7e6cfbcb20d6fbdefaf270d60ac27317dda14159c80c6fb05848a4f6

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for qoro_maestro-0.2.15-cp312-cp312-macosx_14_0_arm64.whl
Algorithm Hash digest
SHA256 2dabdab4aa05eb3426f86f3f35d58121a823d96d470aac7f845cbe184cd328ab
MD5 d49f0bfa37bd039bd87186c1234aa291
BLAKE2b-256 d43c5bfc3b39c041a851e44d72e0ace2cce0452f64d9aa5e0439a18ee88a9b93

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for qoro_maestro-0.2.15-cp311-cp311-win_amd64.whl
Algorithm Hash digest
SHA256 846debfccd55469362eda41501d21d611a43c08e4b544cada09fdb0fc891391e
MD5 75066d65f57eb6f99ca0c811fc8ed95e
BLAKE2b-256 978871613d559b7b995f58e90b5a4dc259eb603c593e8cbab6a0cd164248f8b6

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for qoro_maestro-0.2.15-cp311-cp311-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 c05783d95654c5c81b44b03bd3adf5ba955a53290afb236315a451f87fb56de8
MD5 b0c10fbde6c7bbdd2536f5f4a6df5dd2
BLAKE2b-256 e01d5c8caed6a1fa5f40872c8200c188195a255dc57ecaf1bf1c1b08be871409

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for qoro_maestro-0.2.15-cp311-cp311-macosx_14_0_arm64.whl
Algorithm Hash digest
SHA256 77c9051d1d7140eb48a0dc3b5e20e2c27ca1a6ac42e9f5179d64f3a458133d98
MD5 fcc3044c420ba05ec0abe3d8bf009a97
BLAKE2b-256 1084eae7d92e36d4278150c4f4cdd5b66ab9c2eab0913ae62aeb1b54b656514f

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for qoro_maestro-0.2.15-cp310-cp310-win_amd64.whl
Algorithm Hash digest
SHA256 c04369280cd6019f4188d1f34ba9407a5e03edbe9e32683eda7e8954f94fb0e5
MD5 87ff11ec43b7b71d9997ae07a13f38bb
BLAKE2b-256 fb311a64b12cc102da31a4071f8caf1bf14eec4da62630cbb63b934edf44cd4b

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for qoro_maestro-0.2.15-cp310-cp310-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 da8f15abc0e1d99b86a1fef7f5a27f4c8077d210fd7b2305d2906bb120ded974
MD5 1c0b4cf26a1779adc3b4b410a8b5634e
BLAKE2b-256 eb345a893cb2992b24e8a91e8961e271e8297bdc42f2b26b650bb38f21335e65

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for qoro_maestro-0.2.15-cp310-cp310-macosx_14_0_arm64.whl
Algorithm Hash digest
SHA256 bca3f9830ad2cae9ac9d18e0722ac144415aef4b28c88f5866ab59fb9957dd63
MD5 86d792369e6b8f26660831c45585699d
BLAKE2b-256 a3a0643de1c46b9fb8c0a37db2dbd8470389614a35d41ccfecdb53a3ae01044a

See more details on using hashes here.

Provenance

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

0.2.16

16 files

This release

0.2.15 This release

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