Q-Code v1.0

A participatory quantum coding language. The observer is part of the program.

Free and open source (MIT). No quantum hardware. No account. No cost. Released November 5, 2026.

What it is

Q-Code is a programming language that breaks the spectator assumption — the idea that the observer stands outside the system. In Q-Code, asking a question collapses a possibility. Paying attention reshapes the odds. Two observers can hold different views of the same field until they ask. Information lives in relationships, not in things. Storage is a wave, not a place.

The same program runs on three backends: a participatory field model, exact statevectors, and real Qiskit circuits. It has a real interpreter, control flow, functions, a REPL, and a standard library of quantum systems.

Run it in 60 seconds

python3 qinterp.py examples/hello.qc
python3 qinterp.py examples/friend.qc
python3 qinterp.py examples/grover_demo.qc
python3 qinterp.py examples/ghostdb_store.qc

Python 3.10+ only. Field and state backends need nothing else. The quantum backend needs pip install -r requirements.txt (Qiskit + Aer). Full instructions are in QUICKSTART.md inside the zip.

What is inside

The language — fields, entangle, attend, ask, declare, become, observers, control flow, functions, recursion.
Wave memory — text and images stored as waves, readable from a random half of the points; entangled and teleported memory where bits live only in relationships.
Quantum error correction — bit-flip and phase-flip codes, every error position corrected exactly.
Q-RAM + Grover search — a quantum RAM you query in superposition; Grover finds a value in 12 oracle calls where classical search needs 128.5.
GhostDB — a database in signals and waves: tables, Grover search, superposed aggregation, and data hidden in Wi-Fi beacons, Bluetooth names, SSIDs, and sound.
BB84 quantum key distribution — a home quantum network over an audio carrier; Eve caught at 24.2% error (theory 25%).
Quantum compression — Schumacher compression, amplitude encoding, a quantum autoencoder, a quantum JPEG, and quantum sound compression.
Superdense coding, photons, many worlds, shared QRAM, and a server — your phone sends a program, your laptop runs it and sends the answer back.

276 tests, 34 suites, all green. Every number in the README is backed by a test you can run yourself.

How it breaks classical assumptions

Information must live inside things — broken. Entangled waves, GHZ memory, and teleportation store bits in relationships; no part holds the bit alone.
The observer stands outside the system — broken. Asking collapses. Attention reweights. Observers hold different views until they ask.
Storage means addressed places — broken. A wave memory returns text exactly from a random half of its points.

What it is not — the honest limits

Q-Code is a simulator. The states are computed on a classical CPU. There is no quantum hardware, no wall-clock speedup, and it cannot break encryption. It does not send signals faster than light, it does not let you choose which branch of the multiverse you land in, and it cannot compress random data — nothing can. Holevo's bound is a theorem: n qubits give back n bits. What compresses is structure. The README states every limit plainly, with the numbers.

Source and license

Q-Code v1.0 — built November 4–5, 2026. The language's name is Q-Code. The work continues: Shor 9-qubit error correction, a driven-bath pilot wave, and falsifiable predictions with kill conditions written first.