These samples demonstrate the use of the Quantum Development Kit for a variety of different quantum computing tasks.
Each sample is self-contained in a folder, and demonstrates how to use Q# to develop quantum applications.
A small number of the samples have additional installation requirements beyond those for the rest of the Quantum Development Kit. These are noted in the README.md files for each sample, along with complete installation instructions.
If you're new to quantum or to the Quantum Development Kit, we recommend starting with the Getting Started samples.
After setting up your development environment using one of the options above, try to browse to
samples/getting-started/teleportation via the terminal and run
dotnet run. You should see something like the following:
Round 1: Sent False, got False. Teleportation successful! Round 2: Sent True, got True. Teleportation successful! Round 3: Sent False, got False. Teleportation successful! Round 4: Sent False, got False. Teleportation successful! Round 5: Sent False, got False. Teleportation successful! Round 6: Sent False, got False. Teleportation successful! Round 7: Sent True, got True. Teleportation successful! Round 8: Sent False, got False. Teleportation successful!
Congratulations, you can now start quantum programming!
As you go further with quantum development, we provide several different categories of samples for you to explore:
We also encourage taking a look at the unit tests used to check the correctness of the Quantum Development Kit samples.
This repo contains several configuration files that will make it easy to get started with coding. Below we lay out some instructions for getting started with VSCode or Visual Studio Codespaces. The latter will use the Docker image that has all dependencies pre-installed for you using the configuration file in the
.devcontainer directory. If you prefer working with Jupyter notebooks, we also provide instructions for how to set that up below.
For minimal set-up time, we recommend using Visual Studio Codespaces in the browser. To get started, perform the following steps:
microsoft/Quantumin the "Git Repository" field, see below screenshot.
When you click "Create", a new Codespace instance is created with a development environment based on the Docker container that is defined in this repo's Dockerfile. Recommended extensions are also automatically installed for you.
If you prefer to develop code locally, we recommend to install an editor such as Visual Studio Code. Make sure to install the .NET Core SDK 3.1 or later on your local machine. For more detailed instructions on how to set up VS Code for development with the QDK, go to our docs here.
Once you have installed VS Code and the .NET Core SDK, download this repository to your computer and open the folder in VS Code. The editor will automatically recognize the files in the
.vscode folder and request you to install the recommended extension. This includes the Microsoft Quantum Development Kit for Visual Studio Code extension, which is the fastest way to get started with the QDK.
Open a terminal to start running your first samples (see here).
Another way to quickly start developing in Q# is to use Docker and launch a Jupyter notebook on your local machine. You can use the included Dockerfile to create a docker image with all the necessary libraries to use the Quantum Development Kit to build quantum applications in C#, Python or Jupyter.
Once you have installed Docker, you can use the following commands to get you started:
To build the docker image and tag it
docker build -t iqsharp .
To run the image in the container named
iqsharp-container with interactive command-line and
redirect container port 8888 to local port 8888 (needed to run jupyter):
docker run -it --name iqsharp-container -p 8888:8888 iqsharp /bin/bash
From the corresponding container command line, you can run the C# version of the Teleportation sample using:
cd ~/samples/getting-started/teleportation && dotnet run
Similarly, you can run the Python version of the Teleportation sample using:
cd ~/samples/getting-started/teleportation && python host.py
Finally, to start jupyter notebook within the image for the Teleportation sample, use:
cd ~/samples/getting-started/teleportation && jupyter notebook --ip=0.0.0.0 --no-browser
Once Jupyter has started, you can open in your browser the Teleportation notebook (you will need a token generated by jupyter when it started on the previous step):
Once you're done, to remove container named
docker rm --force iqsharp-container
如您确认内容无涉及 不当用语 / 纯广告导流 / 暴力 / 低俗色情 / 侵权 / 盗版 / 虚假 / 无价值内容或违法国家有关法律法规的内容，可点击提交进行申诉，我们将尽快为您处理。