{"id":21845,"library":"qualang-tools","title":"qualang-tools","description":"A Python package providing tools and utilities for QUA quantum control programs, developed by the QUA platform team. It includes functionality for wiring, configuration, data handling, and integration with QOP (Quantum Orchestration Platform). Current version 0.22.0, requires Python 3.9-3.13, with regular releases on GitHub.","status":"active","version":"0.22.0","language":"python","source_language":"en","source_url":"https://github.com/qua-platform/py-qua-tools","tags":["quantum","qua","opx","control"],"install":[{"cmd":"pip install qualang-tools","lang":"bash","label":"latest"}],"dependencies":[],"imports":[{"note":"qmm is from qm package, not qualang-tools; often confused.","symbol":"qmm","correct":"from qm import QuantumMachinesManager as qmm"},{"note":"simulate function is part of qm-qua library.","wrong":"from qualang_tools import simulate","symbol":"simulate","correct":"from qm.qua import simulate"},{"note":"Program class is in qm-qua, not qualang-tools.","wrong":"from qualang_tools.qua import Program","symbol":"Program","correct":"from qm.qua import Program"}],"quickstart":{"code":"from qualang_tools.wirer import ConnectivityQuantumDotQubits\nfrom qm import QuantumMachinesManager\nfrom qm.qua import Program, simulate\nimport os\n\nqop_ip = os.environ.get('QOP_IP', 'localhost')\nqmm = QuantumMachinesManager(host=qop_ip)\n\n# Example: create a simple QUA program\nwith Program() as prog:\n    pass\n\n# Simulate\nsimulate(qmm, prog)","lang":"python","description":"Import and basic usage with QuantumMachinesManager and QUA simulation."},"warnings":[{"fix":"Replace fetch_all with fetch_results.","message":"Use of 'fetch_all' has been replaced by 'fetch_results' since qm-qua>=1.2.3.","severity":"deprecated","affected_versions":">=0.21.1"},{"fix":"Upgrade qm-qua to 1.2.3 or later.","message":"Breaking change in v0.21.0: qm-qua requirement bumped to >=1.2.3; callable_from_qua may break with older qm-qua.","severity":"breaking","affected_versions":">=0.21.0"},{"fix":"Upgrade qm-qua to >=1.2.2 or later.","message":"Breaking change in v0.20.0: callable_from_qua not compatible with qm-qua <= 1.2.0.","severity":"breaking","affected_versions":">=0.20.0"},{"fix":"Use correct import path from qm-qua library.","message":"Be careful with the import: 'from qm.qua import Program', not from qualang_tools.","severity":"gotcha","affected_versions":"all"}],"env_vars":null,"last_verified":"2026-04-27T00:00:00.000Z","next_check":"2026-07-26T00:00:00.000Z","problems":[{"fix":"Install using 'pip install qualang-tools' and import with 'import qualang_tools'.","cause":"Package not installed or typo in package name (underscore vs hyphen).","error":"ModuleNotFoundError: No module named 'qualang_tools'"},{"fix":"Use 'from qm.qua import Program'.","cause":"Importing Program from qualang_tools instead of from qm.qua.","error":"AttributeError: module 'qualang_tools' has no attribute 'Program'"},{"fix":"Upgrade qm-qua: pip install --upgrade qm-qua.","cause":"Installed qm-qua version is too old.","error":"qm_qua version mismatch: qualang-tools requires qm-qua >= 1.2.3"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}