QDMI on IQM

QDMI on IQM is IQM’s official, production-ready implementation of the Quantum Device Management Interface (QDMI).

By providing this officially supported implementation, IQM empowers HPC centers and middleware developers to embed IQM processors via a stable, vendor-agnostic standard—no fragile, bespoke adapter chains, just clean integration through a shared interface.

The library is written in C++20 and communicates with IQM hardware through the IQM Server API, handling session control, calibration queries, and job lifecycle management transparently. Pre-compiled binaries for all major platforms are provided alongside a Python wrapper for straightforward installation via pip or uv.

Where to Start

I want to…	Start here
Run quantum circuits on IQM hardware from Python / Qiskit	Qiskit Integration
Run end-to-end example workloads (benchmarks, quantum chemistry)	Examples
Integrate the C++ library directly	Usage Guide
Integrate with Slurm on an HPC cluster	SPANK Plugin Guide
Install via Spack on an HPC cluster	Spack Guide
Understand the Python package and its entry points	Python Package
Contribute to the project	Contributing

API Reference

The generated API references cover both the C++ library and the Python package: the C++ API reference documents all public QDMI functions and types exposed by the library, while the C++ API reference covers the iqm-qdmi package including the Qiskit backend and its sampler and estimator primitives.

User Guide

• Running End-to-End Quantum Workloads on IQM Hardware via QDMI-on-IQM
• Using Qiskit to Run Quantum Workloads on IQM Hardware via QDMI-on-IQM
• Directly Using the QDMI Device Library to Run Quantum Workloads on IQM Hardware via QDMI-on-IQM
• Easy Integration with the iqm-qdmi Python Package
• Slurm SPANK Plugin
• Integrating with Spack
• Changelog

Developer Guide

• Dependencies
• Contributing
• Support
• Security Policy

API Reference

• C API Reference
• iqm.qdmi