MKL-Q Python Runtime
mklq is the macOS ARM64 Python runtime for MKL-Q, a CUDA-Q-compatible Apple
Silicon simulator fork. Its public Python import remains cudaq.
Supported scope
- macOS ARM64 only.
- Python 3.11–3.14.
- Stable local target:
mklq-cpu. - Experimental mixed-path target:
mklq-metal.
The wheel provides the Python runtime and target assets only. It does not
include nvq++, an installer, CUDA GPU support, or a claim that all execution
remains on Metal.
Installation
Install into an isolated virtual environment. mklq cannot safely coexist with
NVIDIA cudaq or cuda-quantum* distributions because they all own the
cudaq import namespace.
python3 -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade pip
python -m pip install mklq
Smoke test
import cudaq
@cudaq.kernel
def bell():
qubits = cudaq.qvector(2)
h(qubits[0])
x.ctrl(qubits[0], qubits[1])
mz(qubits)
cudaq.set_target("mklq-cpu")
print(cudaq.sample(bell, shots_count=100))
For source builds, C++ compilation, and current limitations, see https://github.com/wuls968/MKL-Q.
1 maintainer
Metadata
1 maintainer
Release files for mklq 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Built distributions (wheels)
| File | Reset | |||
|---|---|---|---|---|
| mklq-0.1.0-cp314-cp314-macosx_26_0_arm64.whl | CPython 3.14 | CPython 3.14 | macOS 26.0+ ARM64 | Details |
| mklq-0.1.0-cp313-cp313-macosx_26_0_arm64.whl | CPython 3.13 | CPython 3.13 | macOS 26.0+ ARM64 | Details |
| mklq-0.1.0-cp312-cp312-macosx_26_0_arm64.whl | CPython 3.12 | CPython 3.12 | macOS 26.0+ ARM64 | Details |
| mklq-0.1.0-cp311-cp311-macosx_26_0_arm64.whl | CPython 3.11 | CPython 3.11 | macOS 26.0+ ARM64 | Details |
Total release size: 304.5 MB
Release files / mklq-0.1.0-cp314-cp314-macosx_26_0_arm64.whl
| Download URL | mklq-0.1.0-cp314-cp314-macosx_26_0_arm64.whl |
|---|---|
| Size | 76.1 MB |
| Tags | CPython 3.14 macOS 26.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
27dc10d497e28da620852fb62ab8988ac963ad4f3323f0d9e20446be312b3d6b
|
|
BLAKE2b-256 checksum How to use checksums |
28fe2b2a102bf525ee7467697490d304f2ca9d308f7b7b758fad5d980d937c4c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 18, 2026.
Transparency logRelease files / mklq-0.1.0-cp313-cp313-macosx_26_0_arm64.whl
| Download URL | mklq-0.1.0-cp313-cp313-macosx_26_0_arm64.whl |
|---|---|
| Size | 76.1 MB |
| Tags | CPython 3.13 macOS 26.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
a284cfe4117b24f427ed7788baafc2e163a17ca4fcbb1a6318f5433fa26ce2a7
|
|
BLAKE2b-256 checksum How to use checksums |
7c1736fd6bd1f9a360c94c0340d90a7606f5d8cfa55dcd2679854f0e56348071
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 18, 2026.
Transparency logRelease files / mklq-0.1.0-cp312-cp312-macosx_26_0_arm64.whl
| Download URL | mklq-0.1.0-cp312-cp312-macosx_26_0_arm64.whl |
|---|---|
| Size | 76.1 MB |
| Tags | CPython 3.12 macOS 26.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
615a3ac38b60fdf2e731c430acf134d2117d88e185391c707968d65fdd923efd
|
|
BLAKE2b-256 checksum How to use checksums |
9c02eca2c3b5cb15cf3e6e177c250289d63a00330c86592fb0e0c7f46d16d4d6
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 18, 2026.
Transparency logRelease files / mklq-0.1.0-cp311-cp311-macosx_26_0_arm64.whl
| Download URL | mklq-0.1.0-cp311-cp311-macosx_26_0_arm64.whl |
|---|---|
| Size | 76.1 MB |
| Tags | CPython 3.11 macOS 26.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
5ec902b84aba73a64fe70056c9086e778ff7a99305702d5b3fe673986e0cdde2
|
|
BLAKE2b-256 checksum How to use checksums |
31efeca2f5fc2b26ce1a30f7841294ad7a586211a551b150e1dddef6103289cb
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 18, 2026.
Transparency log
