mklq 0.1.0

MKL-Q Python runtime for CUDA-Q-compatible Apple Silicon simulation.

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.