Welcome to MQT Bench’s documentation!

MQT Bench is a tool for benchmarking quantum software tools developed as part of the Munich Quantum Toolkit (MQT).

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

If you are interested in the theory behind MQT Bench, have a look at the publication [1]. Furthermore, MQT Bench is also available as a PennyLane dataset.

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 Bench, please let us know at our Support page.

---

User Guide

• Installation
  • Integrating MQT Bench into your project
• Quickstart
  • Algorithmic Level
  • Target-independent Level
  • Target-dependent Native Gates Level
  • Target-dependent Mapped Level
  • Mirror Circuits
  • Self-defined Circuits
  • Self-defined Targets
  • Random and Symbolic Parameters
  • Output Formats
• Usage
  • Usage via the Webpage
  • Usage via the mqt-bench Python package
  • Usage via the Command Line Interface (CLI)
• Abstraction Levels
  • 1. Algorithmic Level
  • 2. Target-independent Level
  • 3. Target-dependent Native Gates Level
  • 4. Target-dependent Mapped Level
• Parameter Space
  • Native Gate-Set Support
  • Device Support
• Supported Benchmark Algorithms
• References
• Changelog
  • Unreleased
  • 2.0.1 - 2025-07-28
  • 2.0.0 - 2025-06-24
  • 1.1.9 - 2024-12-01
• Upgrade Guide
  • Unreleased
  • 2.0.1
  • 2.0.0
  • Changes to the get_benchmark function
  • Removed TKET as a Compiler
  • Removed the local MQT Bench server deployment

Developers

• Contributing
• Support
• Development Guide

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 Bench a reality!

Cite This

If you want to cite MQT Bench, please use the following BibTeX entry:

@article{quetschlich2023mqtbench,
  title         = {{{MQT Bench}}: {Benchmarking Software and Design Automation Tools for Quantum Computing}},
  shorttitle    = {{MQT Bench}},
  journal       = {{Quantum}},
  author        = {Quetschlich, Nils and Burgholzer, Lukas and Wille, Robert},
  year          = {2023},
  doi           = {10.22331/q-2023-07-20-1062},
  eprint        = {2204.13719},
  primaryclass  = {quant-ph},
  archiveprefix = {arxiv},
  note          = {{{MQT Bench}} is available at \url{https://www.cda.cit.tum.de/mqtbench/}},
}