QuantumGameHub

QuantumGameHub is a collection of four simulator-backed quantum mini-games and visualizations built with Qiskit. The project turns core quantum-computing ideas into small, runnable demonstrations without requiring an IBM Quantum account or API credentials.

Demos

Demo	Quantum concept	What happens
Fortune Teller	Superposition and measurement	Three qubits produce one of eight measurement-backed responses.
Beat the Flip	Interference and entanglement	No operation, a phase flip, and a genuinely entangling move produce distinct simulated outcomes.
Number Guess	Bernstein-Vazirani	A hidden integer is encoded as a bit string and recovered from one simulated measurement.
Quantum Art	Random circuits and measurement	Seeded circuit measurements become reproducible black-and-white image pixels.

This is an educational simulator project. It does not claim quantum advantage.

Repository structure

src/quantum_game_hub/       reusable circuits and simulation helpers
notebooks/                  guided demonstrations and widget controls
tests/                      circuit, behavior, image, and notebook tests
docs/assets/                generated example output

Run it

git clone https://github.com/loki1001/QuantumGameHub.git
cd QuantumGameHub
python -m venv .venv
source .venv/bin/activate
pip install -e ".[dev,notebook]"
jupyter lab notebooks/quantum_game_hub.ipynb

The implementation uses Qiskit's current AerSimulator execution path. All simulations run locally.

Test it

pytest

The suite validates circuit construction, state-level entanglement, measurement results, Bernstein-Vazirani recovery, bounded art generation, deterministic seeded output, and headless notebook execution on Python 3.11 and 3.13.