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 11, 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 11, 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.17.tar.gz (421.0 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.17-cp314-cp314-win_amd64.whl (6.5 MB view details)

Uploaded CPython 3.14Windows x86-64

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

Uploaded CPython 3.14macOS 14.0+ ARM64

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

Uploaded CPython 3.13Windows x86-64

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

Uploaded CPython 3.13macOS 14.0+ ARM64

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

Uploaded CPython 3.12Windows x86-64

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

Uploaded CPython 3.12macOS 14.0+ ARM64

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

Uploaded CPython 3.11Windows x86-64

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

Uploaded CPython 3.11macOS 14.0+ ARM64

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

Uploaded CPython 3.10Windows x86-64

qoro_maestro-0.2.17-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.17-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.17.tar.gz.

File metadata

  • Download URL: qoro_maestro-0.2.17.tar.gz
  • Upload date:
  • Size: 421.0 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.17.tar.gz
Algorithm Hash digest
SHA256 e2cb353fa164c9772e2bcb3183bf43d6ff504b09d191b1801eb266f6704a5b85
MD5 bac8834c33262c24abae1ba5ea12c4ff
BLAKE2b-256 ea735e9b7c031855e5296f8581f3095f55eda2b142c5c8c55c14f81caa445b29

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for qoro_maestro-0.2.17-cp314-cp314-win_amd64.whl
Algorithm Hash digest
SHA256 0b14d5a63fe4ba01294ed95cc997c871596e7feeb455947129df66b7636d79e3
MD5 66b10d09261af4e29c632c94dda2cce4
BLAKE2b-256 0f8bc946f8d10d2fb96093af80ac473664500562cb4c65ca9ed32e8882350f68

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for qoro_maestro-0.2.17-cp314-cp314-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 1b5ce4f81412c30d903f768ee2c86f4c8b47197fcae86fc446cc8fa0599c236c
MD5 4a5126b77c0bbc53efcd4739952f491d
BLAKE2b-256 9f6c72994b4f40ffd24716ee2d794f4409dd5ae702e9e0a191d905ba737ff8be

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for qoro_maestro-0.2.17-cp314-cp314-macosx_14_0_arm64.whl
Algorithm Hash digest
SHA256 e7d51f1131b5fcfe50559773b0f2973cbbbf65934512b9f4ee44fa8ffbbf5e9c
MD5 8c054c831e7acea0b492b7790bafaefb
BLAKE2b-256 851e321f9e197bf343516040a60c8ca4522df2216fae640c9f519563f6c3ded4

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for qoro_maestro-0.2.17-cp313-cp313-win_amd64.whl
Algorithm Hash digest
SHA256 2bd77957b83449097e1265eec0d689f6c5a85ce96230efb734bd7e6a4905a164
MD5 288533d6010c0ed4425c3b5f1a9204b3
BLAKE2b-256 fbdd71e1efd3f06a2237c992dfcc220280bff825d437345e88c2b68218a87182

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for qoro_maestro-0.2.17-cp313-cp313-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 a56c0249adcbb2cc4c909890cdc01008d9e886ae95f0978908e92e4c762e8fca
MD5 873d4b9625663ac7dc0afcb7c7ec9037
BLAKE2b-256 33fc7145c2a31f55c77618d488e904d3d4f939f23c5ce7bcfb437076d1edfefb

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for qoro_maestro-0.2.17-cp313-cp313-macosx_14_0_arm64.whl
Algorithm Hash digest
SHA256 5f96865ad8a31b739104e68471fbc78ba307b3e33bb030e38f5999a9e721a7a1
MD5 c41fde5887c87e19b54fe57cc40608a3
BLAKE2b-256 028dbe6d6a92e65f25994d43ddeabf8de18b811040c37777d9bdb63c9b6338b4

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for qoro_maestro-0.2.17-cp312-cp312-win_amd64.whl
Algorithm Hash digest
SHA256 b5b5fff41f9cb8c6894362d64168cbdaa46bffd386cbd166264c747053131800
MD5 f4e7afb05676f2a920b6675ee2f8a579
BLAKE2b-256 8ffbf73148f51add8be53afde22ab67a524fb8d54550c72ba23d375a03f3b1c1

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for qoro_maestro-0.2.17-cp312-cp312-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 18bdac5107ac9b920bfba13de3b502b64d8ad6df94c381acfab9a8827189c025
MD5 5102a7347daa6a9ed2204960652b2979
BLAKE2b-256 0abb745452feb51029458509c46ca054b0992971a69221536f3025e75618984f

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for qoro_maestro-0.2.17-cp312-cp312-macosx_14_0_arm64.whl
Algorithm Hash digest
SHA256 ac3c2df12b15aa7c8341a38f5481157a5b6792abedd3631664c3870a83e559da
MD5 23c0e5f9ff57635e8dd7b4f6224143ff
BLAKE2b-256 42c99d6a0f1e0db97b38077b2e63b24e02be01c5e9afebd5ad896f71def7ab8a

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for qoro_maestro-0.2.17-cp311-cp311-win_amd64.whl
Algorithm Hash digest
SHA256 72e5635625536b8a579bb721271d4b76be9f242110847b3005a695e3a6d1afaf
MD5 49b44c264321d98162592ef966dcd964
BLAKE2b-256 09feb29c165be5909c74fc9757f8d7bee526e7968c1a188ff0de05bbf82badfb

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for qoro_maestro-0.2.17-cp311-cp311-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 191b252548cf7558387fdb7e18c2d1421ea8ee12b52a609fa77a1b814bfe2361
MD5 83d21b6d354102da3fb4fdf41fe7f23c
BLAKE2b-256 fe2fc0e04e4deca81a286a26d239414265dfc0233946b784a81a48fe1092976e

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for qoro_maestro-0.2.17-cp311-cp311-macosx_14_0_arm64.whl
Algorithm Hash digest
SHA256 4000a3a01657fd80405930d7e742d00281e0c0d7413f2d5479bd64d00ff1ba4f
MD5 e1c1114783875f8e1bf624d6abb633ed
BLAKE2b-256 759d76f76299c68a6847053dde5f61af7b5d424604b26bd463b43e3368b10e88

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for qoro_maestro-0.2.17-cp310-cp310-win_amd64.whl
Algorithm Hash digest
SHA256 1835a65b913c126b83f896556a7903cb695b6b87c2ebce7370730ac686b533e3
MD5 fa5e4577b2b7d4950c8034a51793e1cc
BLAKE2b-256 78db31993c2d03f2656a508937f0467614be4f4bd11bf2921e9e2d591d1d8f2a

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for qoro_maestro-0.2.17-cp310-cp310-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 649a1175a5157ad6ca68ebb345c2f7bdb05e7217dd30df8577e4ad94c6179247
MD5 bf4beb87c53eaf9b4fb9882319f08795
BLAKE2b-256 240bc6818425179d022f529b92de4da9c6c6b339697e67b0512db42383cf4f61

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for qoro_maestro-0.2.17-cp310-cp310-macosx_14_0_arm64.whl
Algorithm Hash digest
SHA256 8f6bfb98e7715c2a41704b3cbff6cf14c8e4e91355e14784c2ad382cdbc04545
MD5 daee7753a33bd4743287c05f7d861933
BLAKE2b-256 5eaa1901a28f9061b2a0edb5125df577e564ed3facc9fa4f10876893f78ffd36

See more details on using hashes here.

Provenance

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

This release

0.2.17 This release

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