QCGE

QUANTUM CIRCUIT GAME ENGINE

Drop real quantum circuits into any pygame game. Runs on Qiskit on the desktop, and a dependency-free simulator in the browser. Build quantum games - not quantum boilerplate.

$ pip install qcge

THE CIRCUIT GRID

One QuantumCircuitGrid - players move the cursor and drop gates on the wires. This is what qcge renders.

H
Z
X
X
X
S
T

WHY QCGE

Pluggable backends

Real Qiskit on desktop, a pure-Python statevector sim in the browser, or numpy. backend="auto" picks the best one.

H

Browser-safe, zero-dep

The pure-Python backend imports nothing beyond the stdlib - the same game runs in a pygbag/WebAssembly build where Qiskit can't.

X

Drop-in grid

One QuantumCircuitGrid object: players place gates, you read the statevector or counts. No Qiskit boilerplate.

SHOW THE CODE

Two lines of Python - the grid simulates itself, no Qiskit boilerplate.

from qcge import QuantumCircuitGrid

grid = QuantumCircuitGrid(
    position=(0, 0), num_qubits=2, num_columns=8,
)

# ...player places gates on the grid...

state  = grid.get_statevector()
counts = grid.get_counts(shots=1024)
print(grid.run().most_likely())   # "11"

LEARN BY PLAYING

Players collect gates and build circuits - touching superposition, measurement, phase, and entanglement, one level at a time.

HSuperposition
XBit flip
ZPhase
Entangle

BUILT WITH QCGE

ARCADE · BREAKOUT

Quantum Breakout

Your paddle is a quantum state - build a circuit to spread it, then the ball measures it and it collapses to one position.

ACTION · PLATFORMER

QuantaVania

Build real quantum circuits to fight through neon dungeons - collect gates, measure your circuit to match and counter enemies.

Ashmit JaiSarita Gupta
MADE BY

Ashmit JaiSarita Gupta

Full-stack Software Development Engineer building AI/LLM products, event-driven backend systems, and quantum software tooling. AsyncAPI TSC member, Qiskit Advocate, and open-source contributor (qBraid, Clifft, QuEST, AsyncAPI). Open to Full-Stack, Systems, Quantum & AI Engineering roles, and freelance.

QCGE

Open source · MIT · build quantum games for everyone

Built by Ashmit JaiSarita Gupta