iqm-client 34.0.3

Client library for accessing an IQM quantum computer

Client-side Python library for connecting to an IQM quantum computer.

Includes as an optional feature Qiskit and Cirq adapters for IQM’s quantum computers, which allow you to:

• Transpile arbitrary quantum circuits for IQM quantum architectures

• Simulate execution on IQM quantum architectures with IQM-specific noise models (currently only the Qiskit adapter contains IQM noise models)

• Run quantum circuits on an IQM quantum computer

Installation

For executing code on an IQM quantum computer, you can use for example the Qiskit on IQM or Cirq on IQM user guides found in the documentation. Qiskit on IQM and Cirq on IQM are optional features that can be installed alongside the base IQM Client library. An example showing how to install from the public Python Package Index (PyPI):

$ uv pip install "iqm-client[qiskit,cirq]"

Note

If you have previously installed the (now obsolete) qiskit-iqm or cirq-iqm packages in your Python environment, you should first uninstall them with $ pip uninstall qiskit-iqm cirq-iqm. In this case, you should also include the --force-reinstall option in the iqm-client installation command.

The base IQM Client library by itself has limited functionality for human users. If you want just the base, you can install it with

$ uv pip install iqm-client

Note

uv is highly recommended for practical Python environment and package management. The supported python versions are >=3.10, <3.14.

Documentation

Documentation for the latest version is available online. You can build documentation for any older version locally by downloading the corresponding package from PyPI, and running the docs builder. For versions greater than equal to 20.12 but less than 33.0.0 this is done by running ./docbuild in the iqm-client root directory, and for earlier versions by running tox run -e docs.

./docbuild or tox run -e docs will build the documentation at ./build/sphinx/html.

Versions greater than or equal to 33.0.0 use the command: sphinx-build -q -d build/.doctrees/iqm-client iqm-client/docs build/docs/iqm-client (build/docs/ directory has to be created first).

These commands require installing the sphinx and sphinx-book-theme Python packages and graphviz.

Copyright

IQM Client is free software, released under the Apache License, version 2.0.

Copyright 2021-2026 IQM