The Wyrdwright’s Primer

A Propædeutic Enchiridion for the Reckoning of Amplitudes, Built Upward from a Single Qubit

This book ends with you able to reckon with any quantum algorithm: derive it from a single qubit, build it in numpy, and verify it against a real cloud QPU. Where The Artificer’s Primer builds the mind and The Hearthwright’s Primer houses it, this one owns the atoms — not as a lower floor of the same stack, but as a different physics entirely. The Artificer and the Hearthwright build the machine you run on; the Wyrdwright builds the machine that runs on physics.

The book runs on one codebase. tqp (Python, numpy only) is a from-scratch quantum computer: the four postulates of quantum mechanics, amplitudes, the Bloch sphere, single- and multi-qubit gates, interference, the tensor product, entanglement, density matrices, the circuit model, Deutsch–Jozsa, Bernstein–Vazirani, Grover, the QFT, Shor, quantum simulation, QAOA/VQE, error correction, measurement-based computing, teleportation, and quantum key distribution. It is the quantum analogue of tinygpt: literacy and a test fixture, not a production QPU. The cloud QPU (Rigetti QCS, IBM Quantum, Quantinuum) is the contrast to llama-server on the fleet: you build the algorithm in tqp, then submit the same circuit to a real QPU and verify your interference actually happens. You do not own the floor — you verify against the real machine.

Nothing here is disconnected from the destination: the interference you build in Part I is the same mechanism the algorithm in Part III exploits; the error correction in Part IV protects the fragile qubit that Part II describes; the models in Part V show that gates are not the only way to compute.

The sibling courses are The Artificer’s Primer and The Hearthwright’s Primer.