grovers-visualizer/README.md

Grover’s Search Visualizer

A tiny Python package that steps through Grover’s Search algorithm and shows you, after each iteration:

• A bar‐chart of amplitudes (or probabilities)
• A sine‐curve of success‐probability vs. iteration
• A geometric "rotation" on the unit circle

---

---

Installation

Using uv/uvx

uvx grovers-visualizer 1111

Using pip/pipx

pip grovers-visualizer
# or
pipx grovers-visualizer # (recommended)

# and then run
grovers-visualizer

---

Usage

Flags

• TARGET
   Target bit‐string (e.g. 010). Length also determines number of qubits.
• -i, --iterations ITERATIONS
   Max iterations; 0 means use the optimal \lfloor\frac\pi4\sqrt{2^n}\rfloor.
• -s, --speed SPEED
   Delay between iterations (seconds). Default 0.5.
• -p, --phase PHASE
  The phase \psi (in radians) used for both the oracle and diffusion steps. Defaults to \pi (i.e. a sign-flip, e^{i\pi}=-1).

---

License

This project is licensed under the MIT License - see the LICENSE file for details.