A personal lab for learning quantum computing and running experiments on real quantum computers — IBM (Qiskit), Google (Cirq), D-Wave (Ocean), AWS Braket, and PennyLane — with an adaptive UI that grows with you.
New to quantum? Perfect. Everything runs on a free local simulator until you decide to connect real hardware. Start with
make uiand the Learn page.
# 1. Set up the main environment (Python 3.13, Qiskit + PennyLane + Streamlit)
make setup
# 2. Confirm it works — runs a Bell state on the simulator (no account needed)
make check
# 3. Launch the adaptive dashboard
make uiThen open the browser tab Streamlit prints, and:
- Learn → What is a qubit? — start here.
- Circuit Builder — add
Hon q0, thenCXq0→q1, and run it. You just made entanglement (a Bell state). - Algorithm Gallery — run Grover's search and quantum teleportation.
Prefer notebooks? make lab opens the guided track in notebooks/.
- Adaptive UI (
app/) — a dashboard that tracks your XP/level and unlocks tools and lessons as you progress. Tools: Circuit Builder, Simulator, Algorithm Gallery, Backends (real IBM hardware), Experiments log, and Learn. quantumlab/package — the shared engine (circuits, run+logging, visualization, backends, profile, curriculum) used by the UI, notebooks, and scripts.- Notebooks (
notebooks/) — hello-qubit → entanglement → Grover. - Docs (
docs/) — a plain-language glossary, a learning roadmap, and provider setup.
Free with IBM:
cp .env.example .env # then add your IBM token (see docs/providers.md)
make ui # → Backends page → run a Bell state on a real QPUOther providers each get an isolated environment: make venv-cirq, make venv-dwave,
make venv-braket. docs/providers.md.
Run make help for the full list (setup, check, ui, lab, test, venv-*).
Prototype / learning tool — built to explore the field and grow into a real use case.
See CLAUDE.md for the developer guide.