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 10, 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:
Latest release

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 10, 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

sinter

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.1.tar.gz (591.6 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.1-cp314-cp314-win_amd64.whl (7.1 MB view details)

Uploaded CPython 3.14Windows x86-64

qoro_maestro-0.3.1-cp314-cp314-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl (5.4 MB view details)

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

qoro_maestro-0.3.1-cp314-cp314-macosx_14_0_arm64.whl (5.2 MB view details)

Uploaded CPython 3.14macOS 14.0+ ARM64

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

Uploaded CPython 3.13Windows x86-64

qoro_maestro-0.3.1-cp313-cp313-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl (5.4 MB view details)

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

qoro_maestro-0.3.1-cp313-cp313-macosx_14_0_arm64.whl (5.2 MB view details)

Uploaded CPython 3.13macOS 14.0+ ARM64

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

Uploaded CPython 3.12Windows x86-64

qoro_maestro-0.3.1-cp312-cp312-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl (5.4 MB view details)

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

qoro_maestro-0.3.1-cp312-cp312-macosx_14_0_arm64.whl (5.2 MB view details)

Uploaded CPython 3.12macOS 14.0+ ARM64

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

Uploaded CPython 3.11Windows x86-64

qoro_maestro-0.3.1-cp311-cp311-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl (5.4 MB view details)

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

qoro_maestro-0.3.1-cp311-cp311-macosx_14_0_arm64.whl (5.2 MB view details)

Uploaded CPython 3.11macOS 14.0+ ARM64

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

Uploaded CPython 3.10Windows x86-64

qoro_maestro-0.3.1-cp310-cp310-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl (5.4 MB view details)

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

qoro_maestro-0.3.1-cp310-cp310-macosx_14_0_arm64.whl (5.2 MB view details)

Uploaded CPython 3.10macOS 14.0+ ARM64

File details

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

File metadata

  • Download URL: qoro_maestro-0.3.1.tar.gz
  • Upload date:
  • Size: 591.6 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.1.tar.gz
Algorithm Hash digest
SHA256 121ced487f1dd3b3ccdaadd1273b6ef9fedc6d3e18baed60f436f9fc0412933c
MD5 774e5722fa18012f99884f26bc718eb5
BLAKE2b-256 e69b1b35e8718bc832cfff19afa99b395a625935050f40b6accf8dfffa0682ab

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for qoro_maestro-0.3.1-cp314-cp314-win_amd64.whl
Algorithm Hash digest
SHA256 fc929137feb4314235d9f3a1b6b8a86eccc7c58a82cdb7eb1612a5ee2a0ca3aa
MD5 5e210febe2c360080bc07bf2322317ca
BLAKE2b-256 c36677fbd43b2b1c88a228cb34b83df56f423b6cf9a0e97dbf7f766ce04a403d

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for qoro_maestro-0.3.1-cp314-cp314-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 18ad3620f9bdfa31a8acb39b9dd9cdf4e5f8cdadb1f62fdddbd8ebbe913ad34c
MD5 90d8fa660698d61105832eecc010f409
BLAKE2b-256 372f4b3ce5a3a0b7680bdd32fda5aa70f8ec8b623600fa2c25b39b4b6717a579

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for qoro_maestro-0.3.1-cp314-cp314-macosx_14_0_arm64.whl
Algorithm Hash digest
SHA256 23826e449497206152855cacaee2c3735f3230162a62a6c66c18a6df3d1e053c
MD5 a793ed0248ae521cf669f4194744dff9
BLAKE2b-256 850d94c314cecb2da08d3152d9ce770d3929e557e781b98946fed5fa7acd4cd6

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for qoro_maestro-0.3.1-cp313-cp313-win_amd64.whl
Algorithm Hash digest
SHA256 65fcf5a493993e14d6085a26d00ac3ee82e5b5af0a79d8e90ab686666210adbc
MD5 c2d9180bfb3e08d1a0bc1948eeff1984
BLAKE2b-256 e142139754f20e8c256ab6521764f6fa13aa419ced02c38cc5b14ac9f2d35815

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for qoro_maestro-0.3.1-cp313-cp313-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 8e1134553ce56a782c5d4d7a49ac8b285a6e73fcc0345a77f45c2be2ecbc4953
MD5 e310169ac5cb2ee814f035de595b9e22
BLAKE2b-256 d979df953cde560a31bb8b568cc87a9f53c35d4fff2016ef87686f68f2333c68

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for qoro_maestro-0.3.1-cp313-cp313-macosx_14_0_arm64.whl
Algorithm Hash digest
SHA256 67ff7583bc636cb1907a7fea28a1368fb1fa626649a445c3ac828a8a53a8673a
MD5 4c17b8a032091fdc903d800bafa61476
BLAKE2b-256 6de691a8892a529d700068cf88f29e56a7efccd7b241487c675b8c73e158b5e2

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for qoro_maestro-0.3.1-cp312-cp312-win_amd64.whl
Algorithm Hash digest
SHA256 16da95c3c9d95027edfeb06c5896ea325ae265797e3d742ce889c7e547aea730
MD5 1d533b6e4d939d7f7917f8e4f0c82101
BLAKE2b-256 b8e96d1438125e3f5e88b8d444914bbe5a3055be6af0312805a33580b16e415f

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for qoro_maestro-0.3.1-cp312-cp312-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 88d3b0bdbb5bfc4cba3f42ca17de467dcdf06ec7a815112747c937a82761e9af
MD5 3301a0df64e4f17f6b33aeda98fc3437
BLAKE2b-256 7d92f861639b4768341754b01d42f6f2f0494482d29f9a8ab76ab73891c8ff0c

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for qoro_maestro-0.3.1-cp312-cp312-macosx_14_0_arm64.whl
Algorithm Hash digest
SHA256 dd58a8d25e0c3dae98a394acd4cfa40b9e5c0e3a4e905d894be19626f9e462c1
MD5 dc113e0296296b3f417a16e86f0b6d18
BLAKE2b-256 7c8ca1b15851be5fd84de7a84f188e2bb6376bb32be36fbe04650e8d0ff02894

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for qoro_maestro-0.3.1-cp311-cp311-win_amd64.whl
Algorithm Hash digest
SHA256 ba7657d1339c85446db835d69c17019e30ec0962bbc1b5219de108322b386b9f
MD5 0747d911a4aab92b179d78f31a2de8d1
BLAKE2b-256 61f81d7eec7e51f89930fe77799ac12a18f6ce7f9ffb736261a33bb1582ca399

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for qoro_maestro-0.3.1-cp311-cp311-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 1ce009bab8603239ad12922abb9589b61975160fd9762673dce0b71070f826ed
MD5 0dd9813e25e9e159d034b4af5094403b
BLAKE2b-256 402336cf83717d02d6a7cd15421f6a68a027e3c03e6fb180888bd33c9cb0e811

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for qoro_maestro-0.3.1-cp311-cp311-macosx_14_0_arm64.whl
Algorithm Hash digest
SHA256 87cca5ae4e81c886b4dc9ccfd2204328722a0d1479e4eda245e9e4a466b9455c
MD5 2d637fba46a84a7ecfc9ade2842e05fc
BLAKE2b-256 9d169fc5da187a56fe0d38a5ca4343685bd750edc3a6f33fd0c372f2857d9895

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for qoro_maestro-0.3.1-cp310-cp310-win_amd64.whl
Algorithm Hash digest
SHA256 890769c34b82b48d537f99050410afb9e23da6c9ba8a591e89db7312355e6d3d
MD5 6882efa31fa18a2bb7041b1315641e56
BLAKE2b-256 5563e6d71369bd5b4a09a778620ac3a3c48bd4463242490285b7dd653afc4c4d

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for qoro_maestro-0.3.1-cp310-cp310-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 62cf5c95553ee7ca0a981353c1fd9892c132fbc43f724218255b5eca9bbc792e
MD5 b0d6f7b5f7c316418d5945ab123323a2
BLAKE2b-256 b9ba05e389f26fee1672da9713dffa84b988552b06bf4f8a02ea16a2ef0b4796

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for qoro_maestro-0.3.1-cp310-cp310-macosx_14_0_arm64.whl
Algorithm Hash digest
SHA256 72dff06ffbe4277cddc399882d6a803b9c40029fdd9df0548aa24dcacc134c45
MD5 e86d21a81b7d93f8f5c0398595071bbb
BLAKE2b-256 7fb9394bb4d5d6d7cf5c45344ac46dc41aba0d70e8bc034b034463289e9c7a83

See more details on using hashes here.

Provenance

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

This release

0.3.1 This release

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

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