munich-quantum-toolkit / munich-quantum-toolkit/bench

✨ Manage IQM and Amazon Braket device snapshots in MQT Bench

Open
#993 0 comments 0 reactions 1 assignee View on GitHub

@flowerthrower is already working on this.

Since Aug 21, 2026.

feature refactor
Dominant language
Python
Stars
131
Forks
44
Avg merge
2h 3m
Merged PRs (30d)
36

Description

Problem Statement

MQT Bench currently maintains device data manually. MQT Core now provides a generic QDMI driver and Python API that can query device properties directly.

Bench users should receive reproducible, offline device models without requiring provider credentials or QDMI dependencies. This also provides a credential-free solution for #663.

Concrete calibration snapshots, such as the IQM data added in Core #1992, could be hosted in Bench rather than Core.

Proposed Solution

Add a versioned, Bench-owned JSON catalog for hardware-device snapshots.

A release-only Python tool should:

  • Load the QDMI-on-IQM and Amazon Braket QDMI devices through Core's raw QDMI API.
  • Query sites, topology, operations, fidelities, durations, units, and provenance directly.
  • Avoid using a Qiskit Target as an intermediate snapshot format, since that conversion can discard device metadata.
  • Store missing properties explicitly instead of inventing values.
  • Fail visibly when operations or properties cannot be represented.
  • Generate a reviewable snapshot PR before each Bench release.

Bench should reconstruct its Qiskit Target objects from these snapshots at runtime while preserving the existing get_device(...) API. Normal users should not need Core, QDMI libraries, provider SDKs, or credentials.

The refresh workflow should use a protected IQM token and preferably GitHub OIDC with a read-only AWS role. Secrets must only be available to trusted pre-release workflows and must never be written to snapshots or logs.

Direct IQM should be the authoritative source for IQM snapshots. Braket can initially provide its gate-model AQT, IonQ, and Rigetti devices. It does not replace Bench's IBM or Quantinuum devices, and analog devices such as QuEra Aquila remain out of scope.

After migration, Core should retain the generic QDMI infrastructure while its concrete IQM snapshots can be removed or reduced to test fixtures. Provider redistribution terms must be checked before calibration data is committed.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.