https://github.com/Strilanc/Quirk

A drag-and-drop quantum circuit simulator that runs in your browser. A toy for exploring and understanding small quantum circuits.
https://github.com/Strilanc/Quirk

quantum-circuit quantum-computing simulation

Last synced: 9 days ago
JSON representation

A drag-and-drop quantum circuit simulator that runs in your browser. A toy for exploring and understanding small quantum circuits.

• Host: GitHub
• URL: https://github.com/Strilanc/Quirk
• Owner: Strilanc
• License: apache-2.0
• Created: 2014-03-05T23:31:28.000Z (over 10 years ago)
• Default Branch: master
• Last Pushed: 2023-01-26T22:54:49.000Z (almost 2 years ago)
• Last Synced: 2024-04-14T12:37:15.932Z (7 months ago)
• Topics: quantum-circuit, quantum-computing, simulation
• Language: JavaScript
• Homepage: http://algassert.com/quirk
• Size: 21.4 MB
• Stars: 880
• Watchers: 47
• Forks: 153
• Open Issues: 45
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE

Awesome Lists containing this project

• quantum-awesome - https://github.com/Strilanc/Quirk
• awesome-quantum-software - Quirk - Drag-and-drop quantum circuit simulator in your browser. (Quantum simulators)

README

        
# Quirk 

[![Build Status](https://travis-ci.org/Strilanc/Quirk.svg?branch=master)](https://travis-ci.org/Strilanc/Quirk)

Quirk is a toy quantum circuit simulator, intended to help people in learning about quantum computing.

If you want to quickly explore the behavior of a small quantum circuit, Quirk is the tool for you.

There's no installing or configuring or scripting: just go to **[algassert.com/quirk](http://algassert.com/quirk)**, drag gates onto the circuit, and the output displays will update in real time.

(If you're still trying to understand what a quantum circuit *even is*, then I recommend the video series [Quantum Computing for the Determined](https://www.youtube.com/playlist?list=PL1826E60FD05B44E4).

Quirk assumes you already know background facts like "each wire represents a qubit".)

**Defining features**:

- Runs in web browsers.

- Drag-and-drop circuit editing.

- Reacts, simulates, and animates in real time.

- Inline state displays.

- Bookmarkable / linkable circuits.

- Up to 16 qubits.

**Notable limitations**:

- Can't recohere measured qubits (because measurement is implemented as a hack based on the [deferred measurement principle](https://en.wikipedia.org/wiki/Deferred_Measurement_Principle)).

**Try it out**:

**[algassert.com/quirk](http://algassert.com/quirk)**

# Examples

**Basic usage demo**:

![Demo](/doc/README_Demo.gif)

**Grover search circuit** with chance and sample displays (showing that the chance of success increases):

![Grover search](/doc/README_Grover.gif)

**Quantum teleportation circuit** with Bloch sphere displays (showing that the qubit at the top has ended up at the bottom):

![Quantum teleportation](/doc/README_Teleportation.gif)

# Building

If you want to modify Quirk, this is how you get the code and turn your changes into working html/javascript.

1. Have [git](https://git-scm.com/) and [Node.js](https://nodejs.org/en/download/) installed.

    `sudo add-apt-repository universe`

    

    `sudo apt-get update`

    

    `sudo apt-get install --yes git npm nodejs-legacy`

2. Clone the repository.

    `git clone https://github.com/Strilanc/Quirk.git`

3. Install the dev dependencies.

    `cd Quirk`

    

    `npm install`

4. (*Optional*) Make your changes. Run the tests.

    `npm run test-firefox`

5. Build the output.

    `npm run build`

6. Confirm the output works by opening `out/quirk.html` with a web browser.

    `firefox out/quirk.html`

7. Copy `out/quirk.html` to wherever you want.

# Disclaimer

Quirk is not an official Google product.