Software · QX Orb manual

Running the QX Orb game

The QX Orb game drives the physical Bloch sphere — a small motorised ball whose arrow points in the direction of a single qubit's state. You rotate the arrow by applying quantum gates, the same gates used in a real quantum circuit.

⚙

Under construction

This QX Orb manual is still being written — some sections may be incomplete or change. For the latest, check the repository.

This is a physical Bloch sphere demonstrator: a small motorised ball with an arrow that points in the direction of a single qubit’s state. You rotate the arrow by applying quantum gates — the same gates you would use in a real quantum circuit. The outreach material is split by session length and audience — see the linked manuals below for a 5-minute festival pitch or a 30-minute classroom session.

Starting QX Orb

You must have Python installed on your laptop/PC. Run the following in a terminal window:

python app.py            # normal use, with hardware connected
python app.py test       # debug mode, no hardware required
python app.py --invert-y-axis   # for left-handed Orbs (e.g. the CWI unit)

Then open the URL Flask prints (usually http://127.0.0.1:5000) in a browser. The game is played in your browser screen.

Each level shows the gates as buttons on screen; the buttons on the controller correspond to the gates shown in the same colour (ABXY). In each level, the goal is to flip the arrow from up to down.

Level Gates Notes
1 H, Z  
2 H, U U is a 180° rotation; from either pole it rotates the sphere halfway to the equator, and from there back to the original pole.
3 X₉₀, Y₉₀, Z₉₀ 90° rotations, each usable only once.
4 H, S An elaboration of (1).