whatisgithub

What is entangled-cat?

szaniewski/entangled-cat — explained in plain English

Analysis updated 2026-05-18

1PythonAudience · generalComplexity · 1/5LicenseSetup · easy

In one sentence

Entangled Cat is a print-and-play card game where players race to assemble quantum circuits from gate cards, turning quantum computing ideas into a strategy game.

Mindmap

mindmap
  root((Entangled Cat))
    What it does
      Print and play cards
      Builds quantum circuits
      Scores algorithms
    Tech stack
      YAML
      Python simulator
    Use cases
      Learn quantum basics
      Play with friends
      Test card balance
    Audience
      Board game fans
      Curious learners
    Setup
      Print your own cards
      Free forever

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Print and play a quantum-themed card game with friends at home.

USE CASE 2

Learn basic quantum gate names and algorithms through gameplay rather than textbooks.

USE CASE 3

Run the included simulator to test whether the game's scoring is balanced.

What is it built with?

PythonYAML

How does it compare?

szaniewski/entangled-cata-bissell/unleash-liteabhiinnovates/whatsapp-hr-assistant
Stars111
LanguagePythonPythonPython
Setup difficultyeasyhardhard
Complexity1/54/53/5
Audiencegeneralresearcherdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 30min

Requires printing and assembling physical cards from the provided files.

Code is MIT or Apache-2.0, meaning free reuse with attribution, rules and art are CC BY-SA 4.0, meaning free reuse and sharing as long as you credit the source and share alike.

So what is it?

Entangled Cat is a print-and-play tabletop card game that uses quantum computing concepts as its theme. Quantum computing is a type of computing that uses principles from quantum physics, this game turns those principles into card-based strategy without requiring any technical background to play. Players compete to be the first to assemble complete quantum circuits, sequences of gate cards arranged in the correct order to match a target algorithm card. There are three decks: the Gate Deck contains cards for quantum operations (H, X, Z, CNOT, MZ, MX, and others), the Algorithm Deck contains famous quantum algorithms (such as Deutsch-Jozsa, Grover's search, and Teleportation) that specify which gates and in what order, and the Special Deck contains attack and defense cards. A Decoherence card, for example, lets you remove one gate from an opponent's sequence. On your turn you draw cards and, when you hold a complete matching sequence, you declare a "measurement", the equivalent of running your algorithm. Other players get a chance to play disruption cards from the Special Deck before the attempt resolves. Defense cards can block those attacks. If the algorithm executes successfully you keep the points, if it fails all those cards are discarded. Simpler algorithms (two to three gates) are worth 10 points, medium ones 20, and complex six-or-more-gate algorithms are worth 30 to 40 points. Disrupting an opponent's successful attempt earns bonus points. The game is free forever. Card definitions are stored as YAML files and the repository includes a simulator for balance analysis. Code is MIT or Apache-2.0 licensed, rules and graphics are CC BY-SA 4.0.

Copy-paste prompts

Prompt 1
Explain what the H, X, Z, and CNOT gate cards represent in real quantum computing terms.
Prompt 2
Help me print and assemble a playable deck of Entangled Cat from the YAML card files.
Prompt 3
Walk me through how a measurement attempt and disruption cards resolve in a turn.
Prompt 4
Show me how to use the included simulator to check if the point values are balanced.

Frequently asked questions

What is entangled-cat?

Entangled Cat is a print-and-play card game where players race to assemble quantum circuits from gate cards, turning quantum computing ideas into a strategy game.

What language is entangled-cat written in?

Mainly Python. The stack also includes Python, YAML.

What license does entangled-cat use?

Code is MIT or Apache-2.0, meaning free reuse with attribution, rules and art are CC BY-SA 4.0, meaning free reuse and sharing as long as you credit the source and share alike.

How hard is entangled-cat to set up?

Setup difficulty is rated easy, with roughly 30min to a first successful run.

Who is entangled-cat for?

Mainly general.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.