{"id":15102223,"url":"https://github.com/microsoft/quantum","last_synced_at":"2026-01-14T04:31:31.341Z","repository":{"id":37256294,"uuid":"110042100","full_name":"microsoft/Quantum","owner":"microsoft","description":"Microsoft Quantum Development Kit Samples","archived":true,"fork":false,"pushed_at":"2024-01-12T17:50:28.000Z","size":33395,"stargazers_count":3870,"open_issues_count":53,"forks_count":918,"subscribers_count":260,"default_branch":"main","last_synced_at":"2024-09-25T18:49:08.189Z","etag":null,"topics":["python","qdk","qsharp","quantum","quantum-computing","quantum-development-kit"],"latest_commit_sha":null,"homepage":"https://docs.microsoft.com/quantum","language":"Jupyter Notebook","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/microsoft.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-11-08T23:24:33.000Z","updated_at":"2024-09-21T03:11:22.000Z","dependencies_parsed_at":"2022-07-12T16:15:03.589Z","dependency_job_id":"cc166844-3f17-48be-b516-9d6d6e085515","html_url":"https://github.com/microsoft/Quantum","commit_stats":{"total_commits":533,"total_committers":87,"mean_commits":6.126436781609195,"dds":0.876172607879925,"last_synced_commit":"7f3cc7531b5f313874ccab4b3a65e0006bbabb38"},"previous_names":[],"tags_count":362,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/microsoft%2FQuantum","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/microsoft%2FQuantum/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/microsoft%2FQuantum/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/microsoft%2FQuantum/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/microsoft","download_url":"https://codeload.github.com/microsoft/Quantum/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":219871828,"owners_count":16554457,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["python","qdk","qsharp","quantum","quantum-computing","quantum-development-kit"],"created_at":"2024-09-25T18:49:46.779Z","updated_at":"2025-09-27T00:31:14.219Z","avatar_url":"https://github.com/microsoft.png","language":"Jupyter Notebook","readme":"## DEPRECATION NOTICE\n\n**This repository is deprecated.** \n\nFor the Modern QDK repository, please visit [Microsoft/qsharp](http://github.com/microsoft/qsharp).\n\nFor samples that use the Azure Quantum Python package, please visit the [Azure Quantum Python repository](https://github.com/microsoft/azure-quantum-python).\n\nYou can also try out the Modern QDK in VS Code for Web at [vscode.dev/quantum](https://vscode.dev/quantum).\n\nFor more information about the Modern QDK and Azure Quantum, visit [https://aka.ms/AQ/Documentation](https://aka.ms/AQ/Documentation).\n\n## Classic QDK ##\n\n [![Binder](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/Microsoft/Quantum/⭐binder?urlpath=tree)\n\nThese samples demonstrate the use of the Quantum Development Kit for a variety of different quantum computing tasks.\n\nEach sample is self-contained in a folder, and demonstrates how to use Q# to develop quantum applications.\n\nA small number of the samples have additional installation requirements beyond those for the rest of the Quantum Development Kit.\nThese are noted in the README.md files for each sample, along with complete installation instructions.\n\n## Getting started\n\nYou can find instructions on how to install the Quantum Development Kit in [our online documentation](https://docs.microsoft.com/azure/quantum/install-overview-qdk/), which also includes\nan introduction to [quantum programming concepts](https://docs.microsoft.com/azure/quantum/concepts-overview/).\n\nFor a quick guide on how to set up a development environment from scratch using [Visual Studio Code](https://code.visualstudio.com) or [GitHub Codespaces](https://github.com/features/codespaces), see [here](#setting-up-your-development-environment).\n\nA [Docker](https://docs.docker.com/install/) image definition is also provided for your convenience, see [here](#running-a-jupyter-notebook-with-docker) for instructions on how to build and use it.\n\n### First samples\n\nIf you're new to quantum or to the Quantum Development Kit, we recommend starting with the [Getting Started samples](./samples/getting-started/).\n\nAfter 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:\n\n```text\nRound 1: Sent False, got False.\nTeleportation successful!\nRound 2: Sent True, got True.\nTeleportation successful!\nRound 3: Sent False, got False.\nTeleportation successful!\nRound 4: Sent False, got False.\nTeleportation successful!\nRound 5: Sent False, got False.\nTeleportation successful!\nRound 6: Sent False, got False.\nTeleportation successful!\nRound 7: Sent True, got True.\nTeleportation successful!\nRound 8: Sent False, got False.\nTeleportation successful!\n```\n\nCongratulations, you can now start quantum programming!\n\n## Going further\n\nAs you go further with quantum development, we provide several different categories of samples for you to explore:\n\n- **[Algorithms](./samples/algorithms)**:\n  These samples demonstrate various quantum algorithms, such as database search and integer factorization.\n- **[Arithmetic](./samples/arithmetic)**:\n  These samples show how to coherently transform arithmetic data.\n- **[Characterization](./samples/characterization)**:\n  These samples demonstrate how to learn properties of quantum systems from classical data.\n- **[Chemistry](./samples/chemistry)**:\n  These samples demonstrate the use of the Quantum Chemistry library.\n- **[Diagnostics](./samples/diagnostics)**:\n  These samples show how to diagnose and test Q# applications.\n- **[Error Correction](./samples/error-correction)**:\n  These samples show how to work with quantum error correcting codes in Q# programs.\n- **[Interoperability](./samples/interoperability)**:\n  These samples show how to use Q# with different host languages.\n- **[Machine Learning](./samples/machine-learning)**:\n  These samples demonstrate how to train simple sequential models on half-moons and wine datasets.\n- **[Numerics](./samples/numerics)**:\n  The samples in this folder show how to use the numerics library.\n- **[Runtime](./samples/runtime)**:\n  These samples show how to work with the Q# simulation runtime.\n- **[Simulation](./samples/simulation)**:\n  These samples show how to simulate evolution under different Hamiltonians.\n\nWe also encourage taking a look at the [unit tests](./samples/tests) used to check the correctness of the Quantum Development Kit samples.\n\n## Setting up your development environment\n\nThis 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](#visual-studio-code) or with [Jupyter notebooks](#running-a-jupyter-notebook-with-docker).\n\n### Visual Studio Code\n\nIf you prefer to develop code locally, we recommend to install an editor such as [Visual Studio Code](https://code.visualstudio.com/download). Make sure to install the [.NET Core SDK 3.1 or later](https://dotnet.microsoft.com/download) 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](https://docs.microsoft.com/azure/quantum/install-command-line-qdk).\n\nOnce 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](https://marketplace.visualstudio.com/items?itemName=quantum.quantum-devkit-vscode) extension, which is the fastest way to get started with the QDK.\n\nOpen a terminal to start running your first samples (see [here](#first-samples)).\n\n### Running a Jupyter Notebook with Docker\n\nAnother 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](./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.\n\nOnce you have installed [Docker](https://docs.docker.com/install/), you can\nuse the following commands to get you started:\n\nTo build the docker image and tag it `iqsharp`:\n\n```sh\ndocker build -t iqsharp .\n```\n\nTo 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):\n\n```sh\ndocker run -it --name iqsharp-container -p 8888:8888 iqsharp /bin/bash\n```\n\nFrom the corresponding container command line, you can run the C# version of the Teleportation sample using:\n\n```sh\ncd ~/samples/getting-started/teleportation \u0026\u0026 dotnet run\n```\n\nSimilarly, you can run the Python version of the Teleportation sample using:\n\n```sh\ncd ~/samples/getting-started/teleportation \u0026\u0026 python host.py\n```\n\nFinally, to start Jupyter Notebook within the image for the Teleportation sample, use:\n\n```sh\ncd ~/samples/getting-started/teleportation \u0026\u0026 jupyter notebook --ip=0.0.0.0 --no-browser \n```\n\nOnce Jupyter has started, you can open in your browser the Teleportation notebook (you\nwill need a token generated by jupyter when it started on the previous step):\n\n\u003e http://localhost:8888/notebooks/Notebook.ipynb\n\nOnce you're done, to remove container named `iqsharp-container`:\n\n```sh\ndocker rm --force iqsharp-container\n```\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmicrosoft%2Fquantum","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmicrosoft%2Fquantum","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmicrosoft%2Fquantum/lists"}