Getting Started with Jupyter Notebooks and the Quantum Development Kit

The Quantum Development Kit provides a Jupyter kernel for the Q# language, making it easy to write and simulate quantum algorithms using Q# interactively from a web browser.


To get started you need:

  • IQ#.
  • Jupyter

Make sure you have followed the installation steps in the getting started guide for IQ#.

To install Jupyter, follow the instructions provided at


Install the qsharp Jupyter kernel from the command line using:

dotnet iqsharp install


Once installed, start jupyter notebook from the command line using:

jupyter notebook

Once started, on the web browser click "New" and select Q# to create a new Notebook using the Q# kernel.

For details on how to write an interactive Q# notebook, take a look at Q# Notebooks from our GitHub Quantum repository.