Skip to content
<awesome-gh-repos>
vic

Strilanc/Quirk

A drag-and-drop quantum circuit simulator that runs in your browser. A toy for exploring and understanding small quantum circuits.
Source code at GitHub http://algassert.com/quirk
Strilanc/Quirk.json
{
  "createdAt": "2014-03-05T23:31:28Z",
  "defaultBranch": "master",
  "description": "A drag-and-drop quantum circuit simulator that runs in your browser. A toy for exploring and understanding small quantum circuits.",
  "fullName": "Strilanc/Quirk",
  "homepage": "http://algassert.com/quirk",
  "language": "JavaScript",
  "name": "Quirk",
  "pushedAt": "2024-07-16T13:15:51Z",
  "stargazersCount": 1037,
  "topics": [
    "quantum-circuit",
    "quantum-computing",
    "simulation"
  ],
  "updatedAt": "2025-11-17T17:35:41Z",
  "url": "https://github.com/Strilanc/Quirk"
}

Quirk Icon

Section titled “Quirk ”

Build Status

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, 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. 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:

Try it out:

algassert.com/quirk

Examples

Section titled “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

Section titled “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 and Node.js 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

Section titled “Disclaimer”

Quirk is not an official Google product.