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, MPO, Pauli propagation, path integral, Clifford/stabilizer, extended stabilizer, density matrix
  • GPU acceleration — statevector (cuStateVec), MPS (custom CUDA and cuTensorNet), MPO (cuTensorNet, cuBlas and custrom CUDA) tensor network (cuTensorNet), Pauli propagation (cuPauliProp), density matrix (cuDensityMatrix)
  • 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 Sep 7, 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 Sep 7, 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.3.0.tar.gz (556.1 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.3.0-cp314-cp314-win_amd64.whl (7.1 MB view details)

Uploaded CPython 3.14Windows x86-64

qoro_maestro-0.3.0-cp314-cp314-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl (5.6 MB view details)

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

qoro_maestro-0.3.0-cp314-cp314-macosx_14_0_arm64.whl (5.4 MB view details)

Uploaded CPython 3.14macOS 14.0+ ARM64

qoro_maestro-0.3.0-cp313-cp313-win_amd64.whl (7.0 MB view details)

Uploaded CPython 3.13Windows x86-64

qoro_maestro-0.3.0-cp313-cp313-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl (5.6 MB view details)

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

qoro_maestro-0.3.0-cp313-cp313-macosx_14_0_arm64.whl (5.4 MB view details)

Uploaded CPython 3.13macOS 14.0+ ARM64

qoro_maestro-0.3.0-cp312-cp312-win_amd64.whl (7.0 MB view details)

Uploaded CPython 3.12Windows x86-64

qoro_maestro-0.3.0-cp312-cp312-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl (5.6 MB view details)

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

qoro_maestro-0.3.0-cp312-cp312-macosx_14_0_arm64.whl (5.4 MB view details)

Uploaded CPython 3.12macOS 14.0+ ARM64

qoro_maestro-0.3.0-cp311-cp311-win_amd64.whl (7.0 MB view details)

Uploaded CPython 3.11Windows x86-64

qoro_maestro-0.3.0-cp311-cp311-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl (5.6 MB view details)

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

qoro_maestro-0.3.0-cp311-cp311-macosx_14_0_arm64.whl (5.4 MB view details)

Uploaded CPython 3.11macOS 14.0+ ARM64

qoro_maestro-0.3.0-cp310-cp310-win_amd64.whl (7.0 MB view details)

Uploaded CPython 3.10Windows x86-64

qoro_maestro-0.3.0-cp310-cp310-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl (5.6 MB view details)

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

qoro_maestro-0.3.0-cp310-cp310-macosx_14_0_arm64.whl (5.4 MB view details)

Uploaded CPython 3.10macOS 14.0+ ARM64

File details

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

File metadata

  • Download URL: qoro_maestro-0.3.0.tar.gz
  • Upload date:
  • Size: 556.1 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.3.0.tar.gz
Algorithm Hash digest
SHA256 f6fa5dadb772a6def855df572094847a90f4d1ea0ece4e6bc501bec9604f0a61
MD5 e7b56d7579d8aec5081334f3682074b9
BLAKE2b-256 9d32291521edbf1000bd02e8689e0f8d4abfcc48c1bb5b9e5157507e15de5a72

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for qoro_maestro-0.3.0-cp314-cp314-win_amd64.whl
Algorithm Hash digest
SHA256 42fb76046cc7315e800cfdd4b047b1a4fe467cda0b1fb345bcddfb02b749ffb1
MD5 f1304bb08eff90316f83276172af02c6
BLAKE2b-256 b2c7979040bcefa72f73a18dbc410db8b643e4afec6faa9600a58a87ed01c045

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for qoro_maestro-0.3.0-cp314-cp314-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 d735c4de5149767b4d7f0d66e1ce5105e77b1faedfa2add0d2571a0fba7e93cf
MD5 856dc4f3ae1f7df0f0504b81e980abda
BLAKE2b-256 a4909aa741f12d0562257771db3baba34db4d1ff86c519755c16c374ce37a6d9

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for qoro_maestro-0.3.0-cp314-cp314-macosx_14_0_arm64.whl
Algorithm Hash digest
SHA256 99126916742b386cb6da12e9a1ad618e85206b09ec0e100acb990ff499785770
MD5 b538eef6d0a1a1563a9bb18397a9b722
BLAKE2b-256 6754475f51957fee8f9efba5908afd9a7455e9215dfdae8d2a1619a2e9582f78

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for qoro_maestro-0.3.0-cp313-cp313-win_amd64.whl
Algorithm Hash digest
SHA256 d4e5dfae258526b58bf1687d5c0bb1864882589c4404b4fd9ca60f2ecc2fc9c1
MD5 a8234045c7028a65d1f24159a63596ed
BLAKE2b-256 77feee459d6f7c9f0c38d49609e89d3dcbb946c57db3e27af6f080d2dcc61143

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for qoro_maestro-0.3.0-cp313-cp313-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 a34792b6d3497146b8cf7e05c8a392b2d7a4de4ee12350b5792f13b3bd475122
MD5 abb28b8a80b4680f74276c4fb14477f4
BLAKE2b-256 033c04ab6d78e44cf73ba5e66d8a0f0cdf3adc2fa833be08921f31c96d2fae6e

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for qoro_maestro-0.3.0-cp313-cp313-macosx_14_0_arm64.whl
Algorithm Hash digest
SHA256 c97462f8448f29d44794909abd6684270ab51e6186d4c985853589a848d0170a
MD5 a41115434b5b453c2948a38368c61d59
BLAKE2b-256 730f7c50cbbcdad20f408ca613630122562526cc21d81a5447d7d740f7ac7067

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for qoro_maestro-0.3.0-cp312-cp312-win_amd64.whl
Algorithm Hash digest
SHA256 1804c7e8bc9d30f2a10012bd78aadbf0b6c09e334189087bed8006a65e851af9
MD5 78948af4345d041d5edde5771b2c4c03
BLAKE2b-256 8c45e104d8556e6a538c7b19be0dceac5e291bda499792b575fcf824b191f08a

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for qoro_maestro-0.3.0-cp312-cp312-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 58b95267c9de0698a96558bdffd884795982de19a454ea53415effb69b8f2d9a
MD5 449a83570d97b869d4f327bd8691f7f1
BLAKE2b-256 4d64da2a528d9ea228286f3dbd6a8467700bbf7e152cf1e3e5a480e49dcbdf69

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for qoro_maestro-0.3.0-cp312-cp312-macosx_14_0_arm64.whl
Algorithm Hash digest
SHA256 797978b059c13242efcad4b26b1ef1f6468bfc586729fa871e5ff8331d14174b
MD5 b1ef152e815e1ad5edeb050302b8da9b
BLAKE2b-256 0938334e2850145ccd3b12e4e9060881557e60b801e8b8c5d3de66bafcbf381c

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for qoro_maestro-0.3.0-cp311-cp311-win_amd64.whl
Algorithm Hash digest
SHA256 9803ae3dea324a14dd882f7da5b0271c5c0e1b07153fbeba09994831ff5d2833
MD5 e0bae4e5dcdd99ae31dbcadba552098b
BLAKE2b-256 70ebf4a4b6d0978a35e5972e9dd41fe19dde0d4b4fc5fe67625f14e4b09beaa6

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for qoro_maestro-0.3.0-cp311-cp311-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 1513d7a4af7d3e14f7e98e6a25771c6361087efececdb181481d4b361bfa3c3f
MD5 cdc6855e3902c50685b5e5dc6db1df79
BLAKE2b-256 f2d4ab275aaa7556ee1656e28d155af981e9436dc9a024c60df8163b34528229

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for qoro_maestro-0.3.0-cp311-cp311-macosx_14_0_arm64.whl
Algorithm Hash digest
SHA256 4c80e1f0e07f5e2d899e6904c5c9fb5fdfe88a940b35ef08b5bf4d52be2a79f5
MD5 f362c089cf40659847baad91db12dfe3
BLAKE2b-256 c6e3dc2abf696dd7a84c0fa6d872e0344337006b972e2ca626cc86639166cd3a

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for qoro_maestro-0.3.0-cp310-cp310-win_amd64.whl
Algorithm Hash digest
SHA256 e5da53bfcdca92ae55a055f0d31bc65d40e2b4ce6ff33212f4048003281c8505
MD5 51f406f0659202c2229b4d0779fd5e0a
BLAKE2b-256 feb0585d45d5dd70573bbfd47625305b80cb95ae622ee7fa701bfa3cd2537e3f

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for qoro_maestro-0.3.0-cp310-cp310-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 c793bdd3342757f1911703b5bd945e3857a8bec2d79e86c6e9903b2a6cdb7366
MD5 051452971a60cdc7035bc8faefa2f9c6
BLAKE2b-256 2379569a94b62156ca126bddda3667265c5f4865910f72ebfa9a3fdda4e31ed4

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for qoro_maestro-0.3.0-cp310-cp310-macosx_14_0_arm64.whl
Algorithm Hash digest
SHA256 bd7dc45cec1416831ced32ce68465ce3a89a14a5718b4d9e8e16ff33898a7fb5
MD5 94df83f4883f6148ced42dc27ed412ea
BLAKE2b-256 4fd2d94c6bd01f90139f9cd3e8bc4e2036ac89de7bfb1a8d4586c2fd4654e83b

See more details on using hashes here.

Provenance

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

This release

0.3.0 This release

16 files

0.2.19

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