Skip to main content

PyPI OS License: MIT CI CD Documentation codecov

MQT Qudits - A Framework For Mixed-Dimensional Qudit Quantum Computing

MQT Qudits is a framework for research and education for mixed-dimensional qudit quantum computing. It is part of the Munich Quantum Toolkit (MQT).

Documentation

Key features

  • Mixed-dimensional quantum circuit support: Design, simulate, and analyze quantum circuits with arbitrary qudit dimensions, not limited to qubits. Tutorial
  • Python-first API: Intuitive Python interface for circuit construction, simulation, and analysis, with type hints and integration with scientific Python libraries.
  • Cross-platform and open-source: C++20 core with Python bindings, prebuilt wheels for Linux, macOS, and Windows via PyPI.

If you have any questions, feel free to create a discussion or an issue on GitHub.

Contributors and Supporters

The Munich Quantum Toolkit (MQT) is developed by the Chair for Design Automation at the Technical University of Munich and supported by MQSC. 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 Qudits a reality!

Contributors to munich-quantum-toolkit/qudits

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

Getting Started

mqt.qudits is available via PyPI.

uv pip install mqt.qudits

Detailed documentation and examples are available at ReadTheDocs.

System Requirements and Building

Building the project requires a C++ compiler with support for C++20 and CMake 3.28 or newer. For details on how to build the project, please refer to the documentation. Building (and running) is continuously tested under Linux, macOS, and Windows using the latest available system versions for GitHub Actions. MQT Qudits is compatible with all officially supported Python versions.

Cite This

Please cite the work that best fits your use case.

MQT Qudits (the tool)

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

@misc{mato2024mqtquditssoftwareframework,
  title        = {{{MQT Qudits}}: {{A}} Software Framework for Mixed-Dimensional Quantum Computing},
  author       = {Mato, Kevin and Ringbauer, Martin and Burgholzer, Lukas and Wille, Robert},
  year         = {2024},
  url          = {https://arxiv.org/abs/2410.02854},
  eprint       = {2410.02854},
  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}}
}

Peer-Reviewed Research

When citing the underlying methods and research, please reference the most relevant peer-reviewed publications from the list below:

[1] K. Mato, M. Ringbauer, L. Burgholzer, R. Wille. MQT Qudits: A Software Framework for Mixed-Dimensional Quantum Computing

[2] K. Mato, S. Hillmich, and R. Wille. Mixed-Dimensional Qudit State Preparation Using Edge-Weighted Decision Diagrams. Design Automation Conference (DAC), 2024

[3] K. Mato, S. Hillmich, and R. Wille. Mixed-Dimensional Quantum Circuit Simulation with Decision Diagrams. International Conference on Quantum Computing and Engineering (QCE), 2023.

[4] K. Mato, S. Hillmich, and R. Wille. Compression of Qubit Circuits: Mapping to Mixed-Dimensional Quantum Systems. International Conference on Quantum Software (QSW), 2023.

[5] K. Mato, M. Ringbauer, S. Hillmich, and R. Wille. Compilation of Entangling Gates for High-Dimensional Quantum Systems. Asia and South Pacific Design Automation Conference (ASP-DAC), 2023.

[6] K. Mato, M. Ringbauer, S. Hillmich, and R. Wille. Adaptive Compilation of Multi-Level Quantum Operations. International Conference on Quantum Computing and Engineering (QCE), 2022.


Acknowledgements

MQT Qudits is the result of the project NeQST funded by the European Union under the Horizon Europe program (grant agreement No. 101080086). However, views and opinions expressed are those of the author(s) only and do not necessarily reflect those of the European Union or the European Commission. Neither the European Union nor the granting authority can be held responsible for them.

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, the Munich Quantum Valley, which is supported by the Bavarian state government with funds from the Hightech Agenda Bayern Plus, as well as the Unitary Foundation.

MQT Funding Footer

Metadata

Release files for mqt-qudits 0.5.2

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-qudits 0.5.2
File Size Uploaded
mqt_qudits-0.5.2.tar.gz 899.8 kB Details

Built distributions (wheels)

Table of built distributions (wheels) for mqt-qudits 0.5.2
File
mqt_qudits-0.5.2-cp315-abi3t-win_arm64.whl CPython 3.15 abi3t Windows ARM64 Details
mqt_qudits-0.5.2-cp315-abi3t-win_amd64.whl CPython 3.15 abi3t Windows x86-64 Details
mqt_qudits-0.5.2-cp315-abi3t-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl CPython 3.15 abi3t Linux glibc 2.28+ x86-64, Linux glibc 2.24+ x86-64 Details
mqt_qudits-0.5.2-cp315-abi3t-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl CPython 3.15 abi3t Linux glibc 2.24+ ARM64, Linux glibc 2.28+ ARM64 Details
mqt_qudits-0.5.2-cp315-abi3t-macosx_13_0_arm64.whl CPython 3.15 abi3t macOS 13.0+ ARM64 Details
mqt_qudits-0.5.2-cp311-abi3-win_arm64.whl CPython 3.11 abi3 Windows ARM64 Details
mqt_qudits-0.5.2-cp311-abi3-win_amd64.whl CPython 3.11 abi3 Windows x86-64 Details
mqt_qudits-0.5.2-cp311-abi3-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl CPython 3.11 abi3 Linux glibc 2.24+ x86-64, Linux glibc 2.28+ x86-64 Details
mqt_qudits-0.5.2-cp311-abi3-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl CPython 3.11 abi3 Linux glibc 2.28+ ARM64, Linux glibc 2.24+ ARM64 Details
mqt_qudits-0.5.2-cp311-abi3-macosx_13_0_arm64.whl CPython 3.11 abi3 macOS 13.0+ ARM64 Details

Total release size: 4.2 MB

Release files / mqt_qudits-0.5.2.tar.gz

Download URL mqt_qudits-0.5.2.tar.gz
Size 899.8 kB
Tags Source
SHA-256 checksum
How to use checksums
f0ece123d125dce7e8bdda2308adb8e22c7b8110c33a852313969c7e852759b3
BLAKE2b-256 checksum
How to use checksums
4d4cb57a420be24b99ad1bc651dd8533dfb74ae6ec416416dfd1d8dd65d18a45
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

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 Sep 18, 2026.

Transparency log

Release files / mqt_qudits-0.5.2-cp315-abi3t-win_arm64.whl

Download URL mqt_qudits-0.5.2-cp315-abi3t-win_arm64.whl
Size 594.6 kB
Tags CPython 3.15 Windows ARM64 abi3t
SHA-256 checksum
How to use checksums
5ca417af0b738f44808b7eb8d94a437a341b3b969f220ecd4d1badb0357b322b
BLAKE2b-256 checksum
How to use checksums
9f5a25aa79442180c46e27b6a4a20fec08751704e926abafb7712b2c9e911737
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

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 Sep 18, 2026.

Transparency log

Release files / mqt_qudits-0.5.2-cp315-abi3t-win_amd64.whl

Download URL mqt_qudits-0.5.2-cp315-abi3t-win_amd64.whl
Size 423.5 kB
Tags CPython 3.15 Windows x86-64 abi3t
SHA-256 checksum
How to use checksums
e08134276ddcf2791d7dbe76c73d0bd31f7a8331d4b8c8e9c1cdb3b508e95e86
BLAKE2b-256 checksum
How to use checksums
9a5b6e2f4c1de5c656d9855f077793dc0a8cb3a8d0677df1bf6939f25fe5f0f6
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

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 Sep 18, 2026.

Transparency log

Release files / mqt_qudits-0.5.2-cp315-abi3t-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl

Download URL mqt_qudits-0.5.2-cp315-abi3t-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl
Size 218.6 kB
Tags CPython 3.15 Linux glibc 2.24+ x86-64 Linux glibc 2.28+ x86-64 abi3t
SHA-256 checksum
How to use checksums
58218b7830afbff82b63a3313b746aba9842bd98afe0384a46013ad537978e5b
BLAKE2b-256 checksum
How to use checksums
95a644ff51197ebf0ddda4c8a80beffc74c7ba9a6d5b76ec788fd0a78a1fba5f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

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 Sep 18, 2026.

Transparency log

Release files / mqt_qudits-0.5.2-cp315-abi3t-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl

Download URL mqt_qudits-0.5.2-cp315-abi3t-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl
Size 214.3 kB
Tags CPython 3.15 Linux glibc 2.24+ ARM64 Linux glibc 2.28+ ARM64 abi3t
SHA-256 checksum
How to use checksums
8af937182a303d52c1df16c88cce0b71ba638067d14337eb79521f4e1015c0f8
BLAKE2b-256 checksum
How to use checksums
e332c774385f22e3583fdb3e4887b5bfe63c9300002fedb677feead826e8c946
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

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 Sep 18, 2026.

Transparency log

Release files / mqt_qudits-0.5.2-cp315-abi3t-macosx_13_0_arm64.whl

Download URL mqt_qudits-0.5.2-cp315-abi3t-macosx_13_0_arm64.whl
Size 208.2 kB
Tags CPython 3.15 abi3t macOS 13.0+ ARM64
SHA-256 checksum
How to use checksums
6ceb70fffad48776bccb3af50b57410adb86de651e9566cb49527a92eb36d313
BLAKE2b-256 checksum
How to use checksums
e3ddc18a83efdcc20fc9d3b61721e7f5f31233fae2aa749ad865a0c1b69d907f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

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 Sep 18, 2026.

Transparency log

Release files / mqt_qudits-0.5.2-cp311-abi3-win_arm64.whl

Download URL mqt_qudits-0.5.2-cp311-abi3-win_arm64.whl
Size 580.0 kB
Tags CPython 3.11 Windows ARM64 abi3
SHA-256 checksum
How to use checksums
5767022f8845d26539cb9a9c6f9269ab257e22220457272f0cb8f10a149efb52
BLAKE2b-256 checksum
How to use checksums
e604526e9b34df6dc340bfcbccb5f2bece7b5f1939a761fed015ef0e6ef2520c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

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 Sep 18, 2026.

Transparency log

Release files / mqt_qudits-0.5.2-cp311-abi3-win_amd64.whl

Download URL mqt_qudits-0.5.2-cp311-abi3-win_amd64.whl
Size 414.4 kB
Tags CPython 3.11 Windows x86-64 abi3
SHA-256 checksum
How to use checksums
9d9b6e9359e577ca59d0b342ec291ed6c49331a0c6f793d83e5ff5efa29c6ae1
BLAKE2b-256 checksum
How to use checksums
cf409592376cd5716c3777a4c538b9c7db19a086f5e72df363b191eec71368d0
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

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 Sep 18, 2026.

Transparency log

Release files / mqt_qudits-0.5.2-cp311-abi3-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl

Download URL mqt_qudits-0.5.2-cp311-abi3-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl
Size 217.4 kB
Tags CPython 3.11 Linux glibc 2.24+ x86-64 Linux glibc 2.28+ x86-64 abi3
SHA-256 checksum
How to use checksums
fdd5d32fa4c5a45f40d26bf77cf6348b3216ac287d104efea8a156cc63900f8c
BLAKE2b-256 checksum
How to use checksums
b9bb8b31a87ed759cf6f84984ec53e3445113e920d77fc94641568dbe6e406cb
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

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 Sep 18, 2026.

Transparency log

Release files / mqt_qudits-0.5.2-cp311-abi3-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl

Download URL mqt_qudits-0.5.2-cp311-abi3-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl
Size 213.2 kB
Tags CPython 3.11 Linux glibc 2.24+ ARM64 Linux glibc 2.28+ ARM64 abi3
SHA-256 checksum
How to use checksums
c5717ed894b4d6bfd3b9289255ad3daec39172452f1a4037409e3a7a66e9d451
BLAKE2b-256 checksum
How to use checksums
cde18533542ea219165e353605673921f9a74d433e292e5e8c3b654ad2ead461
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

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 Sep 18, 2026.

Transparency log

Release files / mqt_qudits-0.5.2-cp311-abi3-macosx_13_0_arm64.whl

Download URL mqt_qudits-0.5.2-cp311-abi3-macosx_13_0_arm64.whl
Size 207.8 kB
Tags CPython 3.11 abi3 macOS 13.0+ ARM64
SHA-256 checksum
How to use checksums
d79170eb15464ec320d34701b4e5cac9325a1542216e62f080cfc365818528fa
BLAKE2b-256 checksum
How to use checksums
1bb297262ab9345ac73d7e0e1ff09e51807090e9418bcd9d1da8b1193c86bc1a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

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 Sep 18, 2026.

Transparency log

Release history Release notifications | RSS feed

This release

0.5.2 This release

11 release files

0.5.1

11 release files

0.4.0

43 release files

0.3.0

43 release files

0.2.0

43 release files

0.1.0

36 release 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