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 13, 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 13, 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.18.tar.gz (422.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.18-cp314-cp314-win_amd64.whl (6.5 MB view details)

Uploaded CPython 3.14Windows x86-64

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

Uploaded CPython 3.14macOS 14.0+ ARM64

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

Uploaded CPython 3.13Windows x86-64

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

Uploaded CPython 3.13macOS 14.0+ ARM64

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

Uploaded CPython 3.12Windows x86-64

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

Uploaded CPython 3.12macOS 14.0+ ARM64

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

Uploaded CPython 3.11Windows x86-64

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

Uploaded CPython 3.11macOS 14.0+ ARM64

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

Uploaded CPython 3.10Windows x86-64

qoro_maestro-0.2.18-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.18-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.18.tar.gz.

File metadata

  • Download URL: qoro_maestro-0.2.18.tar.gz
  • Upload date:
  • Size: 422.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.18.tar.gz
Algorithm Hash digest
SHA256 2afdd01df576789adb6cb5e9224e256a6a14add7756731114572adf434ee49cc
MD5 30d77a1a6f00bd7a5b61ba888b1957a2
BLAKE2b-256 2c068714ef3da9c22a62887199e88012803e6d528b1e33dc799b8aefb063320d

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for qoro_maestro-0.2.18-cp314-cp314-win_amd64.whl
Algorithm Hash digest
SHA256 5b9fe3a4e36b54354cc973447b89fc0c7d29dc64635831cb22f18e7e369a26e8
MD5 75ece24b58d08323b5223b009451264e
BLAKE2b-256 01fdfc4b9991edb11f6fbeb2b7112cb091dddd3e8aecdc0262c3bec6cf795117

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for qoro_maestro-0.2.18-cp314-cp314-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 8a7ec4f82c088c8cd119aa76f863c527d870b2411d7c3c76cdee94d048214074
MD5 e2c5e2d287e4cf49bbade4f80ceed328
BLAKE2b-256 de2be205065ee33c0aeb8971d739489e876f49f60d361d6e191db4d610e4cb27

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for qoro_maestro-0.2.18-cp314-cp314-macosx_14_0_arm64.whl
Algorithm Hash digest
SHA256 31202f33923316e6471a9d1b1c07427a7c684a12a92122dd39d1b54f4672f161
MD5 cb114c89c9fc93f5fd379190cbbf2ffc
BLAKE2b-256 aea8282f1bce696c19a39cd30da4ae705bba109e11640643b0a7f194c99ccece

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for qoro_maestro-0.2.18-cp313-cp313-win_amd64.whl
Algorithm Hash digest
SHA256 458a0aba6c2c52068cc6923243f824bafc560fac24435fa0daa39298ec6aa9cc
MD5 cb742686ba311dc78605cdb42173e65b
BLAKE2b-256 20ed53dd4908fffd2c17c9057f8c248aa33fc4d0d287d6b5d78f5afc744126b7

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for qoro_maestro-0.2.18-cp313-cp313-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 91a24a38cbf76da215f074dc2f047777b57aca0b268a7e57c1e48602dbf1d62a
MD5 a3b5cc8e48edb5e7066487ab6b4ab0bc
BLAKE2b-256 94a59b4041ecf7461725a8f1ab330fd15418f1a48f0b02d499d2c850695a4718

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for qoro_maestro-0.2.18-cp313-cp313-macosx_14_0_arm64.whl
Algorithm Hash digest
SHA256 f6c2ce8e92c6240e5b79571fb18e32178fb18349cd8e0cd1834f3aa617e87d4e
MD5 e0383670c751837048515eaf5870619f
BLAKE2b-256 d18fd6f25205c07dd8bb3a31acaf8e6e86b150f8403359fa9d378016265bcc44

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for qoro_maestro-0.2.18-cp312-cp312-win_amd64.whl
Algorithm Hash digest
SHA256 16eef48cc3c60e2e9b7b568bd440c06f7987e9e1b462e7727fe8d673e9c0e281
MD5 b4ef798fd8d4a8e51d82a9451a7ef2c1
BLAKE2b-256 c9eeec12b9f890ca8985c84d7be710a6530702da0e2f4da2211d2f9b739e1308

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for qoro_maestro-0.2.18-cp312-cp312-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 627fa082d6fe383a007e8f84337e31a1eae6202dcfd0504e8e6e7dea7cfab316
MD5 1841ad7641ebf1c9a3c7f8c32c458e5b
BLAKE2b-256 9c6b3c63e2d91135e5f557c65eb77e860672f863f7ffc0491070c8e07f235df9

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for qoro_maestro-0.2.18-cp312-cp312-macosx_14_0_arm64.whl
Algorithm Hash digest
SHA256 434252a03a60d126366afe76cba0ec518a2b69704c9156c17f6649f53052cc88
MD5 1818ab067a5c4ef4af3ef4f6bee8aaca
BLAKE2b-256 45d4a6aaedc6796dc0045339d22b104f6405b729dc8e4c45f36a9411a8baecd1

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for qoro_maestro-0.2.18-cp311-cp311-win_amd64.whl
Algorithm Hash digest
SHA256 5f030c1bb26bf5bd457bcb9abe770ea24a799774eb6fb65673fe12bd288ba2f9
MD5 7169638c9d8387c966ebc7a4699816c5
BLAKE2b-256 d1250ba3bad14ee4e8ee20298e4ab96ce2165933a70bd13550acb6e736783a65

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for qoro_maestro-0.2.18-cp311-cp311-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 9128d76c8fae1d6ffa52dd251155cf28845d95db949cfb34a08567bd46cf606c
MD5 fad41d060bdcee98392b5d51e381eb83
BLAKE2b-256 85fd2c928a4ca1c6819d482c5ecc8cb9cf1d4adf423fee5029eb94323ad12fe6

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for qoro_maestro-0.2.18-cp311-cp311-macosx_14_0_arm64.whl
Algorithm Hash digest
SHA256 542157794a9f44ad710371f8ab58b92d022ca9d732a096f4efb01f4f19ef23d0
MD5 4201ba4fb51c39cb4c344543d8fe875b
BLAKE2b-256 888a5b8fe5bf81472d386250c92d0a46a60210cbe58ae5f958cfa3b904b620f6

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for qoro_maestro-0.2.18-cp310-cp310-win_amd64.whl
Algorithm Hash digest
SHA256 22fab0ffbeb6be744aceb0991c1d7f7af8de64589b01a32301a559a8d400d60d
MD5 7ed7f7246f428b6601517e9e0f998d7a
BLAKE2b-256 fb004058aca033678ed93c617898be317a367c37badcc37f655acd2fb9fe66b3

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for qoro_maestro-0.2.18-cp310-cp310-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 f3b2b14b4c8b5b40f96a40bae39cb486b7bac1e8054615b949d688764247f178
MD5 a44e006ecaa593c5de622890ff322c44
BLAKE2b-256 42e01241789550a6f8e6b41c7d82b48f89228542b575fa647863fa1f54586eb9

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for qoro_maestro-0.2.18-cp310-cp310-macosx_14_0_arm64.whl
Algorithm Hash digest
SHA256 14b72d2a51b8ba23213fc514a39604464e63481b27375a9741a26648c58180b3
MD5 62811366eeaa47ec68b3f068ef92dc58
BLAKE2b-256 b3d38428f95c2e2460ce306abbdde1d42430fc661b9d96abf0b27771a086fcb5

See more details on using hashes here.

Provenance

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

This release

0.2.18 This release

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