Welcome to the Microsoft Quantum Development Kit!

This repository contains the runtime components for the Quantum Development Kit. It consists of the libraries and packages needed to create and simulate quantum applications using Q#.

• ProjectTemplates/: Source for the project templates that can be used to create new Q# applications using .NET Core's CLI.
• Simulation/: Source for Q# simulation. Includes code generation, full-state and other simulators.
• xUnit/: Source for the xUnit's Q# test-case discoverer.

See the introduction to quantum computing provided with the Quantum Development Kit.

If you're looking to use Q# to write quantum applications, please see the instructions on how to get started with using the Quantum Development Kit including the Q# compiler, language server, and development environment extensions.

Please see the installation guide for further information on how to get started using the Quantum Development Kit to develop quantum applications. You may also visit our Quantum repository, which offers a wide variety of samples on how to write quantum based programs.

Note that when building from source, this repository is configured so that .NET Core will automatically look at the Quantum Development Kit prerelease feed in addition to any other feeds you may have configured.

To build on Windows:

1. Install the pre-reqs:
   • Install CMake
   • Install Visual Studio 2019 (vesrion 16.3 or later). Make sure you install the following workloads:
     • Desktop development with C++
     • .NET Core 3 cross-platform development
2. Run bootstrap.cmd from the Developer Command Prompt for VS 2019.
   • This script prepares and builds the native (C++) full-state simulator.
   • You only need to run it once.
3. Open and build the Simulation.sln solution in Visual Studio.

The Simulation.sln solution does not include the full-state quantum simulator. To change it, you can open the quantum-simulator.sln solution created during bootstrap in the src\Simulation\Native\build. To integrate your changes with the rest of the simulation components, you must first manually build it using the Release configuration.

To build on other platforms:

1. Install the pre-reqs:
   • Install CMake
   • Install .NET Core 3 SDK
2. Run bootstrap.sh
   • This script prepares and builds the native (C++) full-state simulator.
   • You only need to run it once.
3. From the command line, run these two commands:
   • dotnet publish src/Simulation/CsharpGeneration.App
   • dotnet build Simulation.sln

The Simulation.sln solution does not include the full-state simulator. To integrate any changes with the rest of the simulation components, you need to manually build it using make in the src\Simulation\Native\build folder.

All unit tests are part of the Simulation.sln solution. To run the tests:

• From Visual Studio:
  • Open Test Explorer by choosing Test > Windows > Test Explorer from the top menu bar.
  • Run your unit tests by clicking Run All.
• From the command line run:
  • dotnet test Simulation.sln

If you have feedback about the Q# simulators or any other runtime component, please let us know by filing a new issue! If you have feedback about some other part of the Microsoft Quantum Development Kit, please see the contribution guide for more information.

Security issues and bugs should be reported privately, via email, to the Microsoft Security Response Center (MSRC) at secure@microsoft.com. You should receive a response within 24 hours. If for some reason you do not, please follow up via email to ensure we received your original message. Further information, including the MSRC PGP key, can be found in the Security TechCenter.

This project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit https://cla.microsoft.com.

When you submit a pull request, a CLA-bot will automatically determine whether you need to provide a CLA and decorate the PR appropriately (e.g., label, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all repos using our CLA.

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.

For more details, please see CONTRIBUTING.md, or the contribution guide.