Superposition and Entanglement
Classical computers push bits around with and, or, not. Quantum computers add two more moves: superposition and entanglement.
A quantum bit (qubit) can sit between 0 and 1. The Hadamard gate H parks it exactly in the middle, so a measurement comes out 0 half the time and 1 the other half. Try it on the Bloch sphere below. What happens if you press the H button?
That is superposition, and you already know it. It is a coin flip. Measuring collapses the qubit to a plain 0 or 1, so a single run tells you almost nothing. You run the same circuit hundreds of times and read the statistics instead. Those runs are called shots.
Entanglement is the part coin flips do not prepare you for. Two qubits can be wired so their results always agree. Both heads, or both tails. Neither outcome is decided in advance. They simply match. Each result is random. Which results can happen is not.
Neither idea is exotic: both computing traditions grew out of the same nineteenth-century algebra.

Every quantum milestone lands roughly fifty years after its classical twin. Qubits are tiny and unstable, and that costs time. Closing the gap takes specialists from every profession, not only physicists. You, right now, working through the tutorial. From the Kipu team, a big ♥-thank you.
About our approach
The hands-on tutorial this primer belongs to runs seven steps. Six have you write a small Python file and run it from a terminal, so you finish with a project folder you can come back to. The seventh maps the Kipu Quantum Hub around your circuit.
A note about hints in this course
Tasks come with collapsed hints. Before opening one, guess. If a colleague or a chatbot you trust is nearby, argue it out first.
Hints come in three tiers:
- Hint 1, where to look. Points at the docs page or the command that surfaces the answer. No answers here.
- Hint 2, the shape of the answer. Describes what you are reaching for without naming it. Enough to unstick you, not enough to skip the thinking.
- Solution. Full working code, verified against the live Hub, with a copy button.
Opening the Solution first is the one reliable way to get nothing out of this page. Finding the answer in the reference yourself is the skill that makes you independent of tutorials like this one.
Ready for the hands-on part? Start the hands-on tutorial.