Update the Azure Quantum Development Kit (Modern QDK) to the latest version

Learn how to update the Modern QDK to the latest version.


  • This article assumes that you already have the Modern QDK installed. If you are installing for the first time, then please refer to the installation guide.

  • If you are working with programs that require the Microsoft Quantum Development Kit (Classic QDK), such as hybrid integrated computing, see Continue working with the Classic QDK.

Update the Visual Studio Code extension

By default, Visual Studio Code updates extensions automatically. After any updates, you will be prompted to reload VS Code. If you prefer to disable auto-updates and update extensions manually, see Extension auto-update in the VS Code documentation.

Update the Azure Quantum Python packages


If you are updating from a previous Qiskit environment, see Update the azure-quantum package with Qiskit support in a virtual Python environment (recommended).

  1. Update to the latest qsharp and azure-quantum Python packages by using the package installer for Python (pip).

    pip install --upgrade qsharp>=1.0
    pip install --upgrade azure-quantum

The azure-quantum Python package includes optional support for creating and submitting Qiskit circuits to Azure Quantum. When you install the azure-quantum package with Qiskit support, it installs the latest version of Qiskit, which may cause issues with an existing Qiskit environment. To ensure a stable development environment, we recommend creating a virtual Python environment and installing azure-quantum there.

To create a virtual Python environment and install azure-quantum with Qiskit support:

  1. Create a local folder, for example ~/qiskit10-env.

  2. Run venv with the path to the folder

    python3 -m venv ~/qiskit10-env
  3. Activate the environment.

  4. Run pip list and you can see that only the core packages are installed in the new environment.

  5. To install the azure-quantum package, run

    pip install azure-quantum[qiskit]
  6. Install any other packages that you used in your previous environment as needed. You can run pip list in each environment to compare packages and versions.


See Qiskit 1.0 packaging changes for more information on package compatibility.


You can also open your virtual environment in VS Code. From the View menu, select Command Palette > Python: Create Environment > venv. In the lower right, select Open Folder... and select the environment folder you created earlier. For more information on using environments in VS Code, see Python environments in VS Code.

Update the azure-quantum package with Qiskit support in the current environment

You can also update the azure-quantum package with Qiskit support without using a virtual environment. However, updates to the qiskit packages in an existing environment may cause dependency conflicts with other packages. See Qiskit 1.0 packaging changes for more information on package compatibility.

To update the azure-quantum package:

  1. Uninstall the existing azure-quantum and qiskit packages:

    pip uninstall -y azure-quantum qiskit qiskit-terra qiskit-qir
  2. Install azure-quantum using the optional [qiskit] parameter:

    pip install azure-quantum[qiskit]

Update the Azure CLI quantum extension

  1. Update or install the latest Azure CLI quantum extension.

    az extension add --upgrade --name quantum