qdk 1.28.4.dev0

Quantum Development Kit Python Package

qdk

The Quantum Development Kit (QDK) provides a single, cohesive Python entry point for compiling, simulating, and estimating resources for quantum programs (Q# and OpenQASM), with optional extras for visualization, cloud workflows, and interoperability with Qiskit and Cirq.

Install

To install the core functionality, which include Q# & OpenQASM simulation, compilation, and resource estimation support:

pip install qdk

To include the Jupyter extra, which adds visualizations using Jupyter Widgets in the qdk.widgets submodule and syntax highlighting for Jupyter notebooks in the browser:

pip install "qdk[jupyter]"

To add the Azure Quantum extra, which includes functionality for working with the Azure Quantum service in the qdk.azure submodule:

pip install "qdk[azure]"

For Qiskit integration, which exposes Qiskit interop utilities in the qdk.qiskit submodule:

pip install "qdk[qiskit]"

For Cirq integration, which exposes Cirq interop utilities in the qdk.cirq submodule:

pip install "qdk[cirq]"

To easily install all the above extras:

pip install "qdk[all]"

Quick Start

from qdk import qsharp

result = qsharp.run("{ use q = Qubit(); H(q); return MResetZ(q); }", shots=100)
print(result)

To use widgets (installed via qdk[jupyter] extra):

from qdk.qsharp import eval, run
from qdk.widgets import Histogram

eval("""
operation BellPair() : Result[] {
    use qs = Qubit[2];
    H(qs[0]);CX(qs[0], qs[1]);
    MResetEachZ(qs)
}
""")
results = run("BellPair()", shots=1000, noise=(0.005, 0.0, 0.0))
Histogram(results)

Public API Surface

Submodules:

• qdk.qsharp – Q# interpreter functions: init, eval, run, compile, circuit, estimate, and related types.
• qdk.openqasm – OpenQASM compilation and execution.
• qdk.estimator – resource estimation utilities.
• qdk.simulation – noise-aware simulation utilities: NeutralAtomDevice, NoiseConfig, run_qir, DensityMatrixSimulator, StateVectorSimulator, and related types.
• qdk.code – dynamic namespace populated at runtime with user-defined Q# and OpenQASM callables.
• qdk.qre – quantum resource estimation v3: estimate, Application, Architecture, ISA, ISATransform, and related types.
• qdk.applications – domain-specific quantum applications (e.g. qdk.applications.magnets).
• qdk.widgets – Jupyter widgets for visualization (requires the qdk[jupyter] extra).
• qdk.azure – Azure Quantum service integration (requires the qdk[azure] extra).
• qdk.qiskit – Qiskit interop: QSharpBackend, NeutralAtomBackend, and related types (requires the qdk[qiskit] extra).
• qdk.cirq – Cirq interop: NeutralAtomSampler (requires the qdk[cirq] extra).

Top level exports

For convenience, the following helpers and types are also importable directly from the qdk root (e.g. from qdk import code, Result). Algorithm execution APIs (like run / estimate) remain under qdk.qsharp or qdk.openqasm.

Symbol	Type	Origin	Description
code	module	qsharp.code	Exposes operations defined in Q# or OpenQASM
init	function	qsharp.init	Initialize/configure the QDK interpreter (target profile, options).
set_quantum_seed	function	qsharp.set_quantum_seed	Deterministic seed for quantum randomness (simulators).
set_classical_seed	function	qsharp.set_classical_seed	Deterministic seed for classical host RNG.
dump_machine	function	qsharp.dump_machine	Emit a structured dump of full quantum state (simulator dependent).
Result	class	qsharp.Result	Measurement result token.
TargetProfile	class	qsharp.TargetProfile	Target capability / profile descriptor.
StateDump	class	qsharp.StateDump	Structured state dump object.
ShotResult	class	qsharp.ShotResult	Multi-shot execution results container.
PauliNoise	class	qsharp.PauliNoise	Pauli channel noise model spec.
DepolarizingNoise	class	qsharp.DepolarizingNoise	Depolarizing noise model spec.
BitFlipNoise	class	qsharp.BitFlipNoise	Bit-flip noise model spec.
PhaseFlipNoise	class	qsharp.PhaseFlipNoise	Phase-flip noise model spec.

Telemetry

This library sends telemetry. Minimal anonymous data is collected to help measure feature usage and performance. All telemetry events can be seen in the source file telemetry_events.py.

To disable sending telemetry from this package, set the environment variable QDK_PYTHON_TELEMETRY=none

Support

For more information about the Microsoft Quantum Development Kit, visit https://aka.ms/qdk.

Contributing

Q# welcomes your contributions! Visit the Q# GitHub repository at [https://github.com/microsoft/qdk] to find out more about the project.