Skip to main content

PyPI OS License: MIT DOI CI CD Documentation codecov

MQT Logo

MQT Core - The Backbone of the Munich Quantum Toolkit (MQT)

MQT Core provides reusable C++20 and Python libraries for quantum computing: the MQT Compiler Collection, built on MLIR and LLVM, together with decision diagrams, QIR execution, QDMI device access, SDK and HPC integrations, and structured benchmarks. It forms the backbone of the Munich Quantum Toolkit (MQT).

MQT Core 4 is a major architectural release. Structured compiler representations replace the classic circuit APIs and connect quantum-classical programs to optimization, hardware mapping, and execution. For the release highlights, see the v4 overview. Existing users should start with the v3-to-v4 migration guide.

Documentation

Start with your task

Install mqt.core in a Python 3.11.5 or newer virtual environment:

uv pip install mqt.core

Explore the benchmark catalog without setting up a project environment:

uvx mqt-core bench list

Compile and simulate a circuit with the same tool:

uvx mqt-core compile input.qasm --qdmi-device=mqt.ddsim.default -o circuit.bc
uvx mqt-core simulate circuit.bc --shots 1024

OpenQASM files can also run directly with uvx mqt-core simulate input.qasm. Use mqt-core run input.qasm --qdmi-device=<id> to compile and submit through one QDMI device session. See the command-line guide for installation paths and command options.

For other installation options, follow the source-build instructions. Then choose a starting point:

Task Start here
Compile and execute a program Factor 21 with Shor's algorithm; explore compilation and execution.
Connect or implement a device Discover devices, integrate SDKs, or implement an interface.
Use decision diagrams Represent states and operations in C++ or Python: DD quickstart.
Generate and evaluate benchmarks Configure quantum programs and compare results with references.
Exchange quantum programs Qiskit to QIR, OpenQASM, and jeff.
Embed or extend MQT Core Use the C++ libraries or extend the MLIR compiler.

Getting Started

Factor 21 with Shor's algorithm, using modular arithmetic, a reused query qubit, and measurement feedback. The callback compiles each circuit for the bundled DDSIM device and submits 64 shots through each payload format:

from mqt.core.bench import shor
from mqt.core.mlir import submit_program
from mqt.core.qdmi import ProgramFormat, open_device

device = open_device("mqt.ddsim.default")


def run(benchmark: shor.Shor) -> dict[str, int]:
    job = submit_program(benchmark.generate(), target=device, program_format=program_format, num_shots=64, custom1=17)
    job.wait()
    return job.get_counts()


for program_format in (ProgramFormat.QIR_ADAPTIVE_MODULE, ProgramFormat.QASM3):
    result = shor.factor(21, run)
    assert result.status == shor.FactorStatus.SUCCESS
    assert result.factors == (3, 7)
    print(f"{program_format.name}: {result.factors}")
QIR_ADAPTIVE_MODULE: (3, 7)
QASM3: (3, 7)

The factoring walkthrough explains the measured phase, continued fractions, and verified factor recovery.

Development

Source builds require a C++20 compiler and CMake 3.28 or newer. CMake reuses an installed LLVM/MLIR 23.1 SDK or downloads one into the build directory. Prebuilt Python wheels include the compiler and simulator. Graphviz is optional for exporting DD visualizations.

See the contribution guide for development setup and checks. For questions and suggestions, open a discussion or an issue.

Contributors and Supporters

MQT Core is developed by MQSC and the Chair for Design Automation at the Technical University of Munich. Among others, it is part of the Munich Quantum Software Stack (MQSS) ecosystem, which is being developed as part of the Munich Quantum Valley (MQV) initiative.

MQT Partner Logos

Thank you to all the contributors who have helped make MQT Core a reality!

Contributors to munich-quantum-toolkit/core

The MQT will remain free, open-source, and permissively licensed — now and in the future. We are firmly committed to keeping it open and actively maintained for the quantum computing community.

To support this endeavor, please consider:

Sponsor the MQT

Cite This

Please cite the work that best fits your use case.

MQT Core (the tool)

When citing the software itself or results produced with it, cite the MQT Core paper:

@article{burgholzer2025MQTCore,
  title        = {{{MQT Core}}: {{The}} Backbone of the {{Munich Quantum Toolkit (MQT)}}},
  author       = {Burgholzer, Lukas and Stade, Yannick and Peham, Tom and Wille, Robert},
  year         = 2025,
  journal      = {Journal of Open Source Software},
  publisher    = {The Open Journal},
  volume       = 10,
  number       = 108,
  pages        = 7478,
  doi          = {10.21105/joss.07478},
  url          = {https://doi.org/10.21105/joss.07478}
}

The MQT Compiler Collection

When citing the compilation framework built on MLIR, cite the MQT Compiler Collection paper:

@article{MQTCompilerCollection2026,
  title        = {The {{MQT Compiler Collection}}: {{A}} Blueprint for a Future-Proof Quantum-Classical Compilation Framework},
  author       = {Burgholzer, Lukas and Haag, Daniel and Stade, Yannick and Rovara, Damian and Hopf, Patrick and Wille, Robert},
  year         = {2026},
  booktitle    = {Design, Automation and Test in Europe},
  doi          = {10.23919/DATE69613.2026.11539504},
  eprint       = {2604.08674},
  eprinttype   = {arxiv},
}

The Munich Quantum Toolkit (the project)

When discussing the overall MQT project or its ecosystem, cite the MQT Handbook:

@inproceedings{mqt,
  title        = {The {{MQT}} Handbook: {{A}} Summary of Design Automation Tools and Software for Quantum Computing},
  shorttitle   = {{The MQT Handbook}},
  author       = {Wille, Robert and Berent, Lucas and Forster, Tobias and Kunasaikaran, Jagatheesan and Mato, Kevin and Peham, Tom and Quetschlich, Nils and Rovara, Damian and Sander, Aaron and Schmid, Ludwig and Schoenberger, Daniel and Stade, Yannick and Burgholzer, Lukas},
  year         = 2024,
  booktitle    = {IEEE International Conference on Quantum Software (QSW)},
  doi          = {10.1109/QSW62656.2024.00013},
  eprint       = {2405.17543},
  eprinttype   = {arxiv},
  addendum     = {A live version of this document is available at \url{https://mqt.readthedocs.io}}
}

Acknowledgements

The Munich Quantum Toolkit has been supported by the European Research Council (ERC) under the European Union's Horizon 2020 research and innovation program (grant agreement No. 101001318), the Bavarian State Ministry for Science and Arts through the Distinguished Professorship Program, as well as the Munich Quantum Valley, which is supported by the Bavarian state government with funds from the Hightech Agenda Bayern Plus.

MQT Funding Footer

Metadata

Release files for mqt-core 4.2.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for mqt-core 4.2.1
File Size Uploaded Provenance Actions
mqt_core-4.2.1.tar.gz 2.2 MB With provenance Details for mqt_core-4.2.1.tar.gz

Built distributions (wheels)

Table of built distributions (wheels) for mqt-core 4.2.1
File Actions
mqt_core-4.2.1-cp315-abi3t-win_arm64.whl CPython 3.15 abi3t Windows ARM64 Details for mqt_core-4.2.1-cp315-abi3t-win_arm64.whl
mqt_core-4.2.1-cp315-abi3t-win_amd64.whl CPython 3.15 abi3t Windows x86-64 Details for mqt_core-4.2.1-cp315-abi3t-win_amd64.whl
mqt_core-4.2.1-cp315-abi3t-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl CPython 3.15 abi3t Linux glibc 2.28+ x86-64, Linux glibc 2.27+ x86-64 Details for mqt_core-4.2.1-cp315-abi3t-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
mqt_core-4.2.1-cp315-abi3t-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl CPython 3.15 abi3t Linux glibc 2.27+ ARM64, Linux glibc 2.28+ ARM64 Details for mqt_core-4.2.1-cp315-abi3t-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl
mqt_core-4.2.1-cp315-abi3t-macosx_13_0_arm64.whl CPython 3.15 abi3t macOS 13.0+ ARM64 Details for mqt_core-4.2.1-cp315-abi3t-macosx_13_0_arm64.whl
mqt_core-4.2.1-cp311-abi3-win_arm64.whl CPython 3.11 abi3 Windows ARM64 Details for mqt_core-4.2.1-cp311-abi3-win_arm64.whl
mqt_core-4.2.1-cp311-abi3-win_amd64.whl CPython 3.11 abi3 Windows x86-64 Details for mqt_core-4.2.1-cp311-abi3-win_amd64.whl
mqt_core-4.2.1-cp311-abi3-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl CPython 3.11 abi3 Linux glibc 2.27+ x86-64, Linux glibc 2.28+ x86-64 Details for mqt_core-4.2.1-cp311-abi3-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
mqt_core-4.2.1-cp311-abi3-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl CPython 3.11 abi3 Linux glibc 2.27+ ARM64, Linux glibc 2.28+ ARM64 Details for mqt_core-4.2.1-cp311-abi3-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl
mqt_core-4.2.1-cp311-abi3-macosx_13_0_arm64.whl CPython 3.11 abi3 macOS 13.0+ ARM64 Details for mqt_core-4.2.1-cp311-abi3-macosx_13_0_arm64.whl

Total release size: 363.1 MB

Release files / mqt_core-4.2.1.tar.gz

Download URL mqt_core-4.2.1.tar.gz
Size 2.2 MB
Tags Source
SHA-256 checksum
How to use checksums
6627cc7b9abfa2f9a4e8e11b879e6abc3066fa8e7adb4c9560132bede56a8f5d
BLAKE2b-256 checksum
How to use checksums
b610a35dc7df7392365071e8f19584707128dd9646063728a5abb6a9ab4177f6
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 15, 2026.

Transparency log

Release files / mqt_core-4.2.1-cp315-abi3t-win_arm64.whl

Download URL mqt_core-4.2.1-cp315-abi3t-win_arm64.whl
Size 31.3 MB
Tags CPython 3.15 Windows ARM64 abi3t
SHA-256 checksum
How to use checksums
1af6bd83bd3467d164fefbb9505e5f511d75b020d0786c1b19928cc78b0d5d4a
BLAKE2b-256 checksum
How to use checksums
82ec303a28d8728897420f6f1d6fd2e376137036ef65629c70d794938a2447f6
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 15, 2026.

Transparency log

Release files / mqt_core-4.2.1-cp315-abi3t-win_amd64.whl

Download URL mqt_core-4.2.1-cp315-abi3t-win_amd64.whl
Size 32.7 MB
Tags CPython 3.15 Windows x86-64 abi3t
SHA-256 checksum
How to use checksums
2631c7ba73961d5896ebc950a19d85e9bc922022999f8cbb54a8eca9f6ed30df
BLAKE2b-256 checksum
How to use checksums
23ee7f7e0f6818b5fef4a33d85186e5ee536304a574de32d6c71b3c1b1b022c1
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 15, 2026.

Transparency log

Release files / mqt_core-4.2.1-cp315-abi3t-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl

Download URL mqt_core-4.2.1-cp315-abi3t-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
Size 41.1 MB
Tags CPython 3.15 Linux glibc 2.27+ x86-64 Linux glibc 2.28+ x86-64 abi3t
SHA-256 checksum
How to use checksums
0f88ffd18f2a802995e781c1ad6c35410bbb66e6540207c4bed8e39cbd53e37d
BLAKE2b-256 checksum
How to use checksums
3eed64aa5f93f6fecbebabe751cb8af5cc22ed95dbba98f5794368e4c1b8308d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 15, 2026.

Transparency log

Release files / mqt_core-4.2.1-cp315-abi3t-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl

Download URL mqt_core-4.2.1-cp315-abi3t-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl
Size 38.9 MB
Tags CPython 3.15 Linux glibc 2.27+ ARM64 Linux glibc 2.28+ ARM64 abi3t
SHA-256 checksum
How to use checksums
a74bf8295eafac17420c2ba665ec4fb3a30095aef47af37209e805f4e0de2ead
BLAKE2b-256 checksum
How to use checksums
b15e5a810e5e9fb669160cbc09bcc92be14a8bc95c15b181a02f9680b91c2e12
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 15, 2026.

Transparency log

Release files / mqt_core-4.2.1-cp315-abi3t-macosx_13_0_arm64.whl

Download URL mqt_core-4.2.1-cp315-abi3t-macosx_13_0_arm64.whl
Size 37.2 MB
Tags CPython 3.15 abi3t macOS 13.0+ ARM64
SHA-256 checksum
How to use checksums
e1acfaf8d606b5760a850ad7f6cce27cb0f7b71665b9df9999f0e8f5764649c5
BLAKE2b-256 checksum
How to use checksums
920261323f0047f2b76f8eee6ac438bfc5cae9f648f87ee27df98eb68969a1f4
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 15, 2026.

Transparency log

Release files / mqt_core-4.2.1-cp311-abi3-win_arm64.whl

Download URL mqt_core-4.2.1-cp311-abi3-win_arm64.whl
Size 30.3 MB
Tags CPython 3.11 Windows ARM64 abi3
SHA-256 checksum
How to use checksums
8126df1975d39e1a3252420991cf49ce4cc9a893a46ee19d0196f7c4e0032dd8
BLAKE2b-256 checksum
How to use checksums
ae16879123d2c7c7602ee699a2c42438fbf2c862b7946e2fe2205d96ba147e54
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 15, 2026.

Transparency log

Release files / mqt_core-4.2.1-cp311-abi3-win_amd64.whl

Download URL mqt_core-4.2.1-cp311-abi3-win_amd64.whl
Size 32.0 MB
Tags CPython 3.11 Windows x86-64 abi3
SHA-256 checksum
How to use checksums
c8d00975c167c9ed83b1e493c55f45153c97b3727882f4e85a28113ed65f479d
BLAKE2b-256 checksum
How to use checksums
a31435e3f50a0964bbf0ff6026c3abfb3087e27dcf21f9f007eca206648f70e5
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 15, 2026.

Transparency log

Release files / mqt_core-4.2.1-cp311-abi3-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl

Download URL mqt_core-4.2.1-cp311-abi3-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
Size 41.1 MB
Tags CPython 3.11 Linux glibc 2.27+ x86-64 Linux glibc 2.28+ x86-64 abi3
SHA-256 checksum
How to use checksums
0bcea80b54c3622c1783feb949c0b8009e1ca6b165fbac7098eae477891c31b7
BLAKE2b-256 checksum
How to use checksums
310632c3c360acd934f977e7dad1edf4882956f7ed6bb0e3bad3e4d18d6db13d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 15, 2026.

Transparency log

Release files / mqt_core-4.2.1-cp311-abi3-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl

Download URL mqt_core-4.2.1-cp311-abi3-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl
Size 38.9 MB
Tags CPython 3.11 Linux glibc 2.27+ ARM64 Linux glibc 2.28+ ARM64 abi3
SHA-256 checksum
How to use checksums
a531f35c9c8c4b0365ac7b73de318f32d223aeabd6632cd17d65c10b63478e47
BLAKE2b-256 checksum
How to use checksums
d9dd19d140e4643686342221cc8e173af756c9ab8a37a1222c2e9692d850062b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 15, 2026.

Transparency log

Release files / mqt_core-4.2.1-cp311-abi3-macosx_13_0_arm64.whl

Download URL mqt_core-4.2.1-cp311-abi3-macosx_13_0_arm64.whl
Size 37.2 MB
Tags CPython 3.11 abi3 macOS 13.0+ ARM64
SHA-256 checksum
How to use checksums
d28f2291b412651566ade2ad22d7733629201de43bd9f893652e77d51b2b1b5f
BLAKE2b-256 checksum
How to use checksums
d4a0708df4b0b6cb56c500d9b2c4f25fd3d4bef65c170d2c3feb875958164a03
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 15, 2026.

Transparency log

Security for mqt-core 4.2.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

All 11 files in this release have been uploaded with provenance metadata.

Select from 11 files

Attestation for mqt_core-4.2.1.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 15, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

4.2.1 This release

11 release files Full provenance

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