Skip to content

Games and learning

quantum-catsweeper

Maintained by desireevl

This is a super simple game loosely based on Minesweeper Flags and runs on the IBM Quantum computer or simulator.

PythonMIT
quantum-catsweeper illustration

Resource snapshot

Category

Games and learning

Stars

22

Last pushed

Jul 16, 2022Updated 4y ago

Open issues

1

What it is

quantum-catsweeper is maintained by desireevl and sits in the Games and learning lane of the open-source quantum map.

This is a super simple game loosely based on Minesweeper Flags and runs on the IBM Quantum computer or simulator. It commonly appears alongside qiskit-qiskit in example workflows.

Last verified by Qtangl generator on May 27, 2026

Who it's for

Beginners, educators, and curious developers who want a more approachable path into quantum concepts.

What you can build or learn

  • Get a gentler introduction before diving into full SDKs.
  • See how different projects teach circuits, superposition, and measurement.
  • Identify resources that work well for onboarding or self-study.

Plays well with

License

MIT

SPDX identifier detected from the repository metadata or license files.

Repository README

Preview from the project README.

Rendered as Markdown inside a scrollable preview. Long READMEs stay contained; expand or open on GitHub for the full document.

~381 words · about 2 min readOpen on GitHub

Quantum Cat-sweeper

This is a super simple game loosely based on Minesweeper Flags and runs on the IBM Quantum computer or simulator.

Rules of the game:

  • Don't explode the cat (bombs)
  • The tile numbers indicate the number of times you need to click on the same colour to reveal the whole group
  • If a tile has an ! at the end that means quantum probability was not in your favour and that tile click does not count
  • To win the game, find the golden kitty (who moves based on whether you reveal a ! or normal tile)

Front Screen

Game Page

Game Screen

Game Over

Game Over

Explanation

The placement of the bombs are determined using the ANU Quantum Random Number Generator. A Hadamard gate is used on the qubit that represents the bomb and when the tile is clicked, the qubit is measured. It has a 50/50 chance of evaluating to a 1 (bomb explodes) or a 0 (bomb defuses).

A half NOT gate is applied to each qubit representing a number tile. For example: if you reveal a purple 3 tile, you need to click two more purple 3 tiles before the whole purple section reveals. For each click there is a 50/50 chance of the qubit evaluating to a 1 or 0. If out of the 1024 shots, more of them are 1, then your click counts and you only need to find one more purple tile before the whole group reveals. If there are more 0's, then your click does not count and you still need two more clicks of a purple tile to reveal the group.

The golden cat moves around based on your click. If you find it you win 100% of the time. If you reveal a tile with a positive (not !) or neutral evaluation (defused bombs, blank tiles) then the cat moves one space in the direction of the tile you just clicked. If a negatively evaluated tile is clicked the golden cat moves one space away. This knowledge can be used as strategy to win the game.

Installation Guide

apt-get install python3 python3-pip libglfw3 libportaudio2 libasound-dev

pip install -r requirements.txt

python main.py
python main.py debug # For debugging mode

Activity

Latest release

—

Watchers

2

Python support

—

Learn digest

Get monthly updates when library entries change.

Monthly digest: new library entries, updated flagships, and one editorial pick.

Related resources

Keep exploring nearby tools.

quantumlib

Cirq

Python framework for creating, editing, and running Noisy Intermediate-Scale Quantum (NISQ) circuits.

PythonApache-2.0Flagship

4,971 stars · Updated 3mo ago

XanaduAI

pennylane

PennyLane is an open-source quantum software platform for quantum computing, quantum machine learning, and quantum chemistry.

PythonApache-2.0FlagshipQtangl relevant

3,229 stars · Updated 3mo ago

QISKit

qiskit

Qiskit is an open-source SDK for working with quantum computers at the level of extended quantum circuits, operators, and primitives.

PythonApache-2.0FlagshipQtangl relevant

7,412 stars · Updated 3mo ago

stared

quantum-game

Quantum Game (old version) - a puzzle game with real quantum mechanics in a browser

JavaScriptMITFlagshipArchive

359 stars · Updated 10mo ago

Microsoft

QuantumKatas

Tutorials and programming exercises for learning Q# and quantum computing

Jupyter NotebookMITFlagshipArchive

4,862 stars · Updated 2y ago

Strilanc

Quirk

A drag-and-drop quantum circuit simulator that runs in your browser.

JavaScriptApache-2.0Flagship

1,080 stars · Updated 2y ago