Skip to content

/ qsharp-runtime

Runtime components for Q#
qsharp qdk quantum quantum-development-kit
C# F# C++ Mathematica PowerShell CMake Other
  1. C# 53.1%
  2. F# 22.3%
  3. C++ 19.3%
  4. Mathematica 4.0%
  5. PowerShell 0.8%
  6. CMake 0.3%
  7. Other 0.2%
Branch: master
Find file
Clone or download

Clone with HTTPS

Use Git or checkout with SVN using the web URL.

Open in Desktop Download ZIP

Latest commit

@rmshaffer
rmshaffer Add manifest with qsharp-runtime assemblies requiring signing (#200) 
* Add manifest with assemblies requiring signing

* Add manifest.ps1 to build steps

* Run manifest after build completes

* Fix manifest.ps1 script error

* Fix to manifest.ps1

* Revert unnecessary commit 466dc8c
Latest commit 296adcb May 13, 2020

Files

Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github/ISSUE_TEMPLATE Initial commit. (#15) Jul 11, 2019
build Add manifest with qsharp-runtime assemblies requiring signing (#200) May 13, 2020
src Remove unneeded M.Q.Canon open. May 11, 2020
.gitignore Generate command-line program for Q# projects with an entry point (#169) Apr 23, 2020
CONTRIBUTING.md Initial commit. (#15) Jul 11, 2019
LICENSE Initial commit Jun 6, 2019
NOTICE.txt Initial commit. (#15) Jul 11, 2019
NuGet.Config Increment version number and add prerelease feed to README. (#39) Sep 13, 2019
README.md Remove link to project templates and fix typo in README (#153) Feb 27, 2020
Simulation.sln Generate command-line program for Q# projects with an entry point (#169) Apr 23, 2020
bootstrap.cmd Switching to using the new Sdk (#113) Jan 4, 2020
bootstrap.sh Switching to using the new Sdk (#113) Jan 4, 2020

README.md

Microsoft Quantum Development Kit: Q# runtime

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#.

  • Simulation/: Source for Q# simulation. Includes code generation, full-state and other simulators.
  • xUnit/: Source for the xUnit's Q# test-case discoverer.

New to Quantum?

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

Installing 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.

Building from Source

Build Status

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.

Windows

To build on Windows:

  1. Install the pre-reqs:
  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.

macOS/Linux

To build on other platforms:

  1. Install the pre-reqs:
  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 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.

Testing

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

Feedback

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.

Reporting Security Issues

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.

Legal and Licensing

Contributing

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.

You can’t perform that action at this time.