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 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.0

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.0
File Size Uploaded Provenance Actions
mqt_core-4.2.0.tar.gz 2.2 MB With provenance Details for mqt_core-4.2.0.tar.gz

Built distributions (wheels)

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

Total release size: 363.1 MB

Release files / mqt_core-4.2.0.tar.gz

Download URL mqt_core-4.2.0.tar.gz
Size 2.2 MB
Tags Source
SHA-256 checksum
How to use checksums
a4c45f7cbba47312bd608c8d7d27e2f9897dde8c5c1e843a5696afaddeeeb050
BLAKE2b-256 checksum
How to use checksums
a36654ffae45b2055e9787bcfbf1ed905514774b0ccc5ea7b4924ddaed6c30b9
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 10, 2026.

Transparency log

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

Download URL mqt_core-4.2.0-cp315-abi3t-win_arm64.whl
Size 31.2 MB
Tags CPython 3.15 Windows ARM64 abi3t
SHA-256 checksum
How to use checksums
f149f01af7a412207e8f410a96aac89e07fd979218e2d4d044182f8b5355620c
BLAKE2b-256 checksum
How to use checksums
b8fe7fd7f0a8f0ff0a55fe100d8b4583fe09b2cbe347e67039ae71c349ab85e0
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 10, 2026.

Transparency log

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

Download URL mqt_core-4.2.0-cp315-abi3t-win_amd64.whl
Size 32.5 MB
Tags CPython 3.15 Windows x86-64 abi3t
SHA-256 checksum
How to use checksums
dba0d0c7ed474904753fa9ef5dfe65e496d096fb1a167223e7ce62978b7d5897
BLAKE2b-256 checksum
How to use checksums
12c450c4a3e53d309c6374aa47714e413bff470bbfff8dcbbc0ed4f7dc0d001e
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 10, 2026.

Transparency log

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

Download URL mqt_core-4.2.0-cp315-abi3t-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
Size 41.0 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
82e017cc9a212777686f1314ff7a151281b367e05675a1597e249425ee1e8f5f
BLAKE2b-256 checksum
How to use checksums
35c183d9d849d7219fc30bd28ac0c70970429b7a62aa3121b30301f31ca07f01
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 10, 2026.

Transparency log

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

Download URL mqt_core-4.2.0-cp315-abi3t-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl
Size 38.8 MB
Tags CPython 3.15 Linux glibc 2.27+ ARM64 Linux glibc 2.28+ ARM64 abi3t
SHA-256 checksum
How to use checksums
cfa73d1a0e8ebaa721f3a664a7603b9ae3a07b3a0f013148941bac784feb9a92
BLAKE2b-256 checksum
How to use checksums
e8226a0201b80d3ef862d15a31972671253a95a16c0e1d9984c14578b98ddc61
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 10, 2026.

Transparency log

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

Download URL mqt_core-4.2.0-cp315-abi3t-macosx_13_0_arm64.whl
Size 37.7 MB
Tags CPython 3.15 abi3t macOS 13.0+ ARM64
SHA-256 checksum
How to use checksums
ea0b79eb2eb510cb1976282b2bb28acff6763a6ecddf6d18a1326ae1a2657fac
BLAKE2b-256 checksum
How to use checksums
f624ce436ebb79292e4f535ad3dfe9dd479182197168ea4ff4f99c57464d2981
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 10, 2026.

Transparency log

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

Download URL mqt_core-4.2.0-cp311-abi3-win_arm64.whl
Size 30.2 MB
Tags CPython 3.11 Windows ARM64 abi3
SHA-256 checksum
How to use checksums
5689ae5431f8922232ef58edaf09984b4e6fe847c547b1c2463630eb4112ab45
BLAKE2b-256 checksum
How to use checksums
4f4e7cb589445478ba8c0fa73196811fb6d6164b5ee485a12a4dd2a887c8efd2
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 10, 2026.

Transparency log

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

Download URL mqt_core-4.2.0-cp311-abi3-win_amd64.whl
Size 31.8 MB
Tags CPython 3.11 Windows x86-64 abi3
SHA-256 checksum
How to use checksums
c3955f4a33dafa008419306bd33b0c2d7c6238d0ffa64e6499acc002f4715b91
BLAKE2b-256 checksum
How to use checksums
f793ff4bf5fb14b9c4b0e892266659ba45cae8df29f9cdc3ac7fbd5aa4ba3404
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 10, 2026.

Transparency log

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

Download URL mqt_core-4.2.0-cp311-abi3-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
Size 41.0 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
e9613e5844fd6390075b28829eb305157bdad83b135fed21df237d4fb901653a
BLAKE2b-256 checksum
How to use checksums
4a49fd97d2d0bf226cee1e2837de56f818031cc4b4add87278c4a692a00273af
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 10, 2026.

Transparency log

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

Download URL mqt_core-4.2.0-cp311-abi3-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl
Size 38.8 MB
Tags CPython 3.11 Linux glibc 2.27+ ARM64 Linux glibc 2.28+ ARM64 abi3
SHA-256 checksum
How to use checksums
95177f0dcbdb204d25713938e4b0e69b3ef40705c058a12488b964e0b2785ac0
BLAKE2b-256 checksum
How to use checksums
cc27f65f21a11cc5cbd44a08649476cbc74b6f37b2d3343e497718abc9226431
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 10, 2026.

Transparency log

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

Download URL mqt_core-4.2.0-cp311-abi3-macosx_13_0_arm64.whl
Size 37.7 MB
Tags CPython 3.11 abi3 macOS 13.0+ ARM64
SHA-256 checksum
How to use checksums
7215771c49d6bdd21cf17b2a1e534cd300847af2c01356a45a25f2a6e646854c
BLAKE2b-256 checksum
How to use checksums
c0ae5bae83bdbe140019026e1c19811b338856c02558892ec0a3f95d896d5a09
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 10, 2026.

Transparency log

Security for mqt-core 4.2.0

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