Skip to main content

MQT Bench - A MQT tool for Benchmarking Quantum Software Tools

Project description

PyPI License: MIT CI Bindings codecov Documentation

MQT Bench: Benchmarking Software and Design Automation Tools for Quantum Computing

MQT Bench is a quantum circuit benchmark suite with cross-level support, i.e., providing the same benchmark algorithms for different abstraction levels throughout the quantum computing software stack.


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

MQT Bench is part of the Munich Quantum Toolkit (MQT) developed by the Chair for Design Automation at the Technical University of Munich and is hosted at

Getting Started

mqt-bench is available via PyPI.

(venv) $ pip install mqt.bench

The following code gives an example on the usage:

from mqt.bench import get_benchmark

# get a benchmark circuit on algorithmic level representing the GHZ state with 5 qubits
qc_algorithmic_level = get_benchmark(benchmark_name="dj", level="alg", circuit_size=5)

# draw the circuit

Detailed documentation and examples are available at ReadTheDocs.

Repository Structure

  • src/mqt/: main source directory
    • bench: Directory for the MQT Bench package
    • bench/benchmarks: Directory for the benchmarks
    • benchviewer: Directory for the webpage (which can be started locally and is also hosted at
  • tests: Directory for the tests for MQT Bench


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.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mqt.bench-1.1.1.tar.gz (4.8 MB view hashes)

Uploaded Source

Built Distribution

mqt.bench-1.1.1-py3-none-any.whl (4.2 MB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page