Exercise - Install the QDK for Visual Studio Code

In this part, you prepare your development environment so you can begin writing quantum programs.

To set up your development environment, you:

  • Install the QDK for Visual Studio Code.
  • Verify the installation by creating a basic Q# application.

But first, let's take a quick look at what you get with the Quantum Development Kit (QDK).


Before you proceed, make sure you have the latest version of .NET Core and Visual Studio Code installed on your computer.

What's the Quantum Development Kit (QDK)?

The QDK gives you everything you need to start writing quantum programs. Included in the QDK is the Q# programming language.

Q# is a domain-specific programming language (DSL). A DSL is a computer language that's built for a specific kind of application, just like how HTML is built for web pages. Q# enables you to focus on your quantum algorithms without having to worry about many of the underlying details, such as the physical layout of a quantum computer.

The QDK also includes:

  • Q# libraries that help you build real-world quantum applications right away.

  • Targets, which allow you to run your program locally or on a variety of hardware through Azure Quantum.

    Targets include resource estimators and simulators for larger quantum programs, as well as a quantum simulator, which behaves much like a quantum computer would.

    The simulator is useful for trying out new ideas, debugging programs, and learning about quantum computing, but it's only suitable for programs that require relatively few qubits. (Don't worry, we'll explain what a qubit is later in the module.)

    The simulator enables you to run quantum programs locally, on computers you use to write software. You can also target your programs to run on quantum hardware by using Azure Quantum. (We'll discuss Azure Quantum later in this module.)

  • Tools that help you integrate quantum programs with classical programs, including support for C#, F#, and Python. (Classical code enables you to work with the results from quantum computations.)

Install the QDK for Visual Studio Code

This step installs the QDK and adds extensions to Visual Studio Code that provide support for developing quantum algorithms in Q#.

  1. Open Visual Studio Code.
  2. Go to Microsoft Quantum Development Kit for Visual Studio Code, select Install, then follow the installation steps.


If you already have an older version of the QDK, we recommend that you update to the latest version.

Verify the installation

To verify the installation, here you create a basic Q# application.

Install the Quantum project templates

Project templates enable you to quickly create Q# applications, libraries, and unit tests.

  1. In Visual Studio Code, on the View menu, select Command Palette.
  2. Enter Q#: Install project templates.

Create a project

  1. On the View menu, select Command Palette.

  2. Enter Q#: Create New Project.

  3. Select Standalone console application.

  4. Select a directory to hold your project, such as your home directory. Enter QuantumHello as the project name, then select Create Project.

  5. From the window that appears at the bottom, select Open new project.

  6. From the View menu, select Explorer.

    You see two files: QuantumHello.csproj and Program.qs.

    The .csproj file defines project settings. Program.qs contains a basic Q# program that prints a message to the console.

    namespace QuantumHello {
        open Microsoft.Quantum.Canon;
        open Microsoft.Quantum.Intrinsic;
        operation HelloQ() : Unit {
            Message("Hello quantum world!");

Run the program

Now let's run the program to verify that everything is set up correctly. You use the dotnet utility to run Q# programs.

  1. From the View menu, select Terminal or Integrated Terminal.

  2. Run dotnet run.

    dotnet run
  3. The program prints this message:

    Hello quantum world!

Great work. You just ran your first Q# program!

You likely noticed that this basic program doesn't involve any quantum computations. Shortly, you'll use quantum computation to create a random number generator.