MQT QMAP - A Tool for Mapping Quantum Circuits onto various Hardware Technologies

MQT QMAP is an open-source C++20 and Python library for mapping quantum circuits onto various hardware technologies developed as part of the Munich Quantum Toolkit (MQT).

This documentation provides a comprehensive guide to the MQT QMAP library, including installation instructions, demo notebooks, and detailed API documentation. The source code of MQT QMAP is publicly available on GitHub at munich-quantum-toolkit/qmap, while pre-built binaries are available via PyPI for all major operating systems and all modern Python versions. MQT QMAP is fully compatible with Qiskit 1.0 and above.

We recommend you to start with the installation instructions or by reading our overview paper [1]. Then proceed to the mapping page, the synthesis/optimization page, the neutral atom state preparation page, or the zoned neutral atom compiler, and read the reference documentation. If you are interested in the theory behind MQT QMAP, have a look at the publications in the publication list.

We appreciate any feedback and contributions to the project. If you want to contribute, you can find more information in the Contribution guide. If you are having trouble with the installation or the usage of MQT QMAP, please let us know at our Support page or by reaching out to us at quantum.cda@xcit.tum.de.

User Guide

• Installation
  • Building from Source for Performance
  • Integrating MQT QMAP into Your Project
  • Development Setup
• Quantum Circuit Mapping
  • Exact Mapping
  • Heuristic Mapping
• Synthesis of Clifford Circuits
  • Clifford Circuits
  • Using QMAP for Optimal Synthesis
• Neutral Atom Logical State Preparation
• Zoned Neutral Atom Compiler
  • Example: GHZ State on Neutral Atom Architecture
• Hybrid Neutral Atom Routing and Mapping
  • Example: GHZ state on a hybrid NA architecture
  • Tuning the mapper
  • Tips
  • Hybrid Synthesis Mapper
• References
• Changelog
  • Unreleased
  • 3.6.0 - 2026-02-24
  • 3.5.0 - 2025-12-16
  • 3.4.0 - 2025-10-15
  • 3.3.1 - 2025-08-07
  • 3.3.0 - 2025-08-04
  • 3.2.0 - 2025-07-16
  • 3.1.3 - 2025-05-28
  • 3.1.2 - 2025-05-27
  • 3.1.1 - 2025-05-27
  • 3.1.0 - 2025-05-26
  • 3.0.0 - 2025-05-08
  • 2.8.0 - 2024-11-18
• Upgrade Guide
  • Unreleased
  • 3.6.0
  • 3.5.0
  • 3.4.0
  • 3.3.0
  • 3.2.0
  • 3.1.0
  • 3.0.0

Developers

• Contributing
• AI Usage Guidelines
• Tooling
• Support

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 the Munich Quantum Software Company (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.

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

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:

• Starring and sharing our repositories: https://github.com/munich-quantum-toolkit

• Contributing code, documentation, tests, or examples via issues and pull requests

• Citing the MQT in your publications (see References)

• Using the MQT in research and teaching, and sharing feedback and use cases

• Sponsoring us on GitHub: https://github.com/sponsors/munich-quantum-toolkit