What are the Q# programming language and Quantum Development Kit (QDK)?

Q# is Microsoft’s open-source programming language for developing and running quantum algorithms. It’s part of the Quantum Development Kit (QDK), which includes Q# libraries, quantum simulators, extensions for other programming environments, and API documentation. In addition to the Standard Q# library, the QDK includes Chemistry, Machine Learning, and Numeric libraries.

As a programming language, Q# draws familiar elements from Python, C#, and F# and supports a basic procedural model for writing programs with loops, if/then statements, and common data types. It also introduces new quantum-specific data structures and operations.

What can I do with the QDK?

The QDK is a full-featured development kit for Q# that you can use with common tools and languages to develop quantum applications that you can run in various environments. Q# programs can run as a console application, through Jupyter Notebooks, or use a Python or .NET host program.

Develop in common tools and environments

Integrate your quantum development with Visual Studio, Visual Studio Code, and Jupyter Notebooks. Use the built-in APIs for pairing your programs with Python and .NET host languages.

Try quantum operations and domain-specific libraries

Write and test quantum algorithms to explore superposition, entanglement, and other quantum operations. The Q# libraries enable you to run complex quantum operations without having to design low-level operation sequences.

Run programs in simulators

Run your quantum programs on a full-state quantum simulator, a limited-scope Toffoli simulator, or test your Q# code in different resource estimators.

Where can I learn more?

I'm new to quantum computing Review some basics of quantum physics and quantum computing in Key Concepts.
I want to dive deeper into the Q# language Explore types, expressions, variables, and quantum program structure in the Q# User Guide.
I just want to start writing quantum programs Set up your Q# environment and start writing quantum programs in QuickStarts.

How does Q# work?

A Q# program can compile into a standalone application or be called by a host program that is written either in Python or a .NET language.

When you compile and run the program, it creates an instance of the quantum simulator and passes the Q# code to it. The simulator uses the Q# code to create qubits (simulations of quantum particles) and apply transformations to modify their state. The results of the quantum operations in the simulator are then returned to the program.

Isolating the Q# code in the simulator ensures that the algorithms follow the laws of quantum physics and can run correctly on quantum computers.

Qsharp code flow

How do I use the QDK?

Everything you need to write and run Q# programs, including the Q# compiler, the Q# libraries, and the quantum simulators, can be installed and run from your local computer. Eventually you will be able to run your Q# programs remotely on an actual quantum computer, but until then the quantum simulators provided with the QDK provide accurate and reliable results.

  • Developing Q# applications is the quickest way to get started.

  • Run standalone Jupyter Notebooks with IQ#, a Jupyter extension for compiling, simulating, and visualizing Q# programs.

  • If you are familiar with Python, you can use it as a host programming platform to get started. Python enjoys widespread use not only among developers, but also scientists, researchers and teachers.

  • If you already have experience with C#, F#, or VB.NET and are familiar with the Visual Studio development environment, there are just a few extensions you need to add to Visual Studio to prepare it for Q#.


Q# is an open-source programming language for developing quantum programs. It has libraries that let you create complex quantum operations, and quantum simulators to accurately run and test your programs. Q# programs can run as standalone apps or be called from a Python or .NET host program, and can be written, run, and tested from your local computer.

Next Steps

Linear algebra for quantum computing