Install & Compatibility
Where this runs
tested against v0.22.0 · 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
py 3.10
✕ build_error
✓ 28.4s
py 3.11
✕ build_error
✓ 26.2s
py 3.12
✕ build_error
✓ 27.5s
py 3.13
✕ build_error
✕ build_error
py 3.9
✕ build_error
✓ 41.2s
596MB installed
● package 596MB
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
qmm
✓ from qm import QuantumMachinesManager as qmm
qmm is from qm package, not qualang-tools; often confused.
simulate
✓ from qm.qua import simulate
✗ from qualang_tools import simulate
simulate function is part of qm-qua library.
Program
✓ from qm.qua import Program
✗ from qualang_tools.qua import Program
Program class is in qm-qua, not qualang-tools.
Import and basic usage with QuantumMachinesManager and QUA simulation.
from qualang_tools.wirer import ConnectivityQuantumDotQubits
from qm import QuantumMachinesManager
from qm.qua import Program, simulate
import os
qop_ip = os.environ.get('QOP_IP', 'localhost')
qmm = QuantumMachinesManager(host=qop_ip)
# Example: create a simple QUA program
with Program() as prog:
pass
# Simulate
simulate(qmm, prog)
Errors
Common errors & fixes
ModuleNotFoundError: No module named 'qualang_tools'
Package not installed or typo in package name (underscore vs hyphen).
fixInstall using 'pip install qualang-tools' and import with 'import qualang_tools'.
AttributeError: module 'qualang_tools' has no attribute 'Program'
Importing Program from qualang_tools instead of from qm.qua.
fixUse 'from qm.qua import Program'.
qm_qua version mismatch: qualang-tools requires qm-qua >= 1.2.3
Installed qm-qua version is too old.
fixUpgrade qm-qua: pip install --upgrade qm-qua.
Upgrade
Version history
0.22.0latest on PyPI · released Apr 1, 2026
Audit
Dependencies
No dependency data recorded yet.