qm-qua

library1.3.1pypypi✓ verified 87d ago

SDK for writing and executing QUA programs to control quantum processors on Quantum Machines hardware. Current version 1.2.6, requires Python <3.13. Released monthly.

data

pip install qm-qua

package ↗homepage ↗

INSTALL

IMPORT

SIG · QM-QUA

qm-qua

datapythonv1.3.1

Install

17.6s avg

Import

1405ms

Disk

304MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v1.3.1 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.95 runs

installs and imports cleanly · install 0.0s · import 0.326s · 273.6MB

glibc

py 3.10–3.95 runs

installs and imports cleanly · install 17.6s · import 1.360s · 268MB

304MB installed

● package 304MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

QuantumMachine

✓ from qm import QuantumMachine

✗ from qm.QuantumMachine import QuantumMachine

QuantumMachine is not a module; it's in qm namespace.

Program

✓ from qm.qua import Program

✗ from qm.Program import Program

Program is a QUA class, not a top-level module.

ConfigBuilder

✓ from qm import SimulationConfig

ConfigBuilder was deprecated in 1.0; use SimulationConfig.

Create a QUA program, simulate it with a QuantumMachine.

from qm import QuantumMachine, SimulationConfig from qm.qua import Program, play, amp import numpy as np # Minimal program with Program() as prog: play('pulse', amp(0.5) * np.array([1+j for j in range(1024)])) # Simulate config = SimulationConfig(duration=1000) qm = QuantumMachine(config=config, simulate=True) job = qm.execute(prog) res = job.get_results()

Debug

Known issues

breakingMajor API change between 0.x and 1.0: QuantumMachine now requires a config object; Program uses context manager; controllers removed.

fix

Upgrade scripts: replace old 'qm.QuantumMachine(host, port)' with 'QuantumMachine(config, simulate=True)' and wrap programs in 'with Program():'.

affects: <1.0 vs >=1.0

gotchaDo not use pip install qm alone; that installs an unrelated package. Always use qm-qua.

fix

Run 'pip uninstall qm' and 'pip install qm-qua'.

affects: all

deprecatedConfigBuilder is deprecated since 1.0. Use SimulationConfig directly.

fix

Replace 'ConfigBuilder().build()' with 'SimulationConfig(duration=...)'.

affects: >=1.0

gotchaPython version must be <3.13; does not support 3.13+.

fix

Use Python 3.9–3.12. Check with 'python --version'.

affects: all

Errors

Common errors & fixes

ModuleNotFoundError: No module named 'qm'

Installed wrong package 'qm' instead of 'qm-qua'.

fix

Run: pip uninstall qm && pip install qm-qua

AttributeError: module 'qm' has no attribute 'QuantumMachine'

Import path is wrong; QuantumMachine is not a submodule.

fix

Use: from qm import QuantumMachine

ImportError: cannot import name 'Program' from 'qm'

Program is in the QUA subpackage, not top-level qm.

fix

Use: from qm.qua import Program

Upgrade

Version history

1.3.1latest on PyPI · released Jun 18, 2026

Audit

Dependencies

qmmoptionalRequired for simulation; distinguish from qm-qua

qm-open-apioptionalRequires license file for hardware connection

Agent activity

4 hits · last 30 days

node

Resources

packagehttps://pypi.org/project/qm-qua/ ↗

homepagehttps://www.quantum-machines.co ↗