ruqu puts a real quantum simulator behind one npx command

What ruqu is

Quantum computing demos usually start with a Python environment and end before anything runs. ruqu compiles a real simulator to WASM so the first command works immediately.

What changed

Version 0.2.0 replaced the placeholder with a real quantum WASM kernel and added three commands — simulate, grover and qaoa — then documented them in the README. It builds on the MetaHarness agent harness CLI added in the same week.

Get started

Node.js. Verify the kernel loaded, then run a simulation:

npx @ruvector/ruqu doctor
npx @ruvector/ruqu simulate --qubits 4

Expected result: a GHZ state vector simulation over four qubits.

npx @ruvector/ruqu grover --qubits 3 --target 5
npx @ruvector/ruqu qaoa --nodes 4

Check what the kernel actually supports before assuming a gate exists:

npx @ruvector/ruqu capabilities

Use it today

Practical case: teaching. Input is a qubit count; the workflow is run Grover with a known target; the output is a result a room can watch appear in a few seconds.

Acceptance test: run Grover with target 5 on three qubits and confirm the amplified outcome is 5.

Push it further

Experimental commentary. QAOA on small graphs is where quantum inspired optimisation meets agent planning. The limitation is scale: state vector simulation cost doubles per qubit, so this is for intuition, not production optimisation.

Falsifiable test: increase qubits one at a time and record runtime. The curve tells you exactly where your machine stops being useful.