A comprehensive introduction to quantum computing fundamentals through beautiful visualizations, progressive exercises, and hands-on demonstrations.
This workshop consists of 7 Jupyter notebooks, each designed to run in 12-20 minutes. Through clear explanations, stunning visualizations, checkpoints, and interactive quizzes, you'll build a solid intuition of fundamental quantum concepts.
Target Audience: Anyone with basic Python knowledge - no quantum background required!
Prerequisites: Basic Python knowledge, no prior quantum mechanics or physics required
Total Duration: ~100 minutes (1h40 with breaks)
Pedagogical Approach: 4-part structure (Intuition → Concept → Implementation → Visualization)
| # | Title | Duration | Difficulty | Key Concepts |
|---|---|---|---|---|
| 0 | My First Qubit | 12 min | ⭐ | Circuit, X gate, Measurement, Bloch sphere |
| 1 | Superposition | 12 min | ⭐ | Hadamard, Probabilities, H·H = I |
| 2 | Rotations & Interference | 20 min | ⭐⭐ | Pauli gates, RX/RY/RZ, Phase, H-Z-H |
| 3 | Two Qubits & CNOT | 15 min | ⭐⭐ | CNOT, Bell states, Correlations |
| 4 | Entanglement | 15 min | ⭐⭐⭐ | Quantum correlations, CHSH inequality |
| 5 | Deutsch's Algorithm | 18 min | ⭐⭐ | Oracle, Quantum advantage, First algorithm |
| 6 | Teleportation | 15 min | ⭐⭐⭐ | Complete protocol, No-cloning, Fidelity |
Demystify quantum computing and manipulate your first qubit.
- Create a quantum circuit
- Apply the X gate (quantum NOT)
- Measure and interpret results
- Visualize on the Bloch sphere
Key Concept: Quantum circuits are like programs with qubits, gates, and measurements.
Explore the fundamental difference between classical probability and quantum superposition.
- Classical random bits vs quantum superposition
- The Hadamard gate: creating (|0⟩+|1⟩)/√2
- The "spinning coin" analogy
- Understanding measurement collapse
Key Concept: A qubit can exist in multiple states simultaneously (0 AND 1), not just be unknown.
Master quantum gates as rotations and understand interference.
- Pauli gates (X, Y, Z) as 180° rotations
- Arbitrary rotations (RX, RY, RZ) with any angle
- The concept of phase (negative amplitudes)
- Interference: H-H cancellation, H-Z-H to |1⟩
Key Concept: Gates rotate qubits on the Bloch sphere; amplitudes interfere constructively/destructively.
Work with multiple qubits and create quantum correlations.
- 2-qubit systems: 4 basis states |00⟩, |01⟩, |10⟩, |11⟩
- The CNOT gate (Controlled-NOT)
- Creating the 4 Bell states
- First quantum correlations
Key Concept: CNOT creates correlations between qubits that are the foundation of entanglement.
Understand quantum correlations that Einstein called "spooky action at a distance."
- Classical correlations vs quantum entanglement
- Measuring correlations in different bases
- CHSH inequality violation
- Why entanglement is non-classical
Key Concept: Entangled qubits have correlations stronger than any classical system can achieve.
Implement your first quantum algorithm and see quantum advantage.
- The oracle concept (black box function)
- Deutsch's problem: constant vs balanced
- Quantum solution with 1 query (vs 2 classical)
- How interference gives the answer
Key Concept: Quantum interference can solve certain problems with exponentially fewer queries.
See the complete quantum teleportation protocol in action.
- The no-cloning theorem
- Complete teleportation protocol (Bell state + measurements)
- Step-by-step state evolution
- Fidelity analysis across random states
Key Concept: Quantum information can be transferred using entanglement and classical communication.
- Python 3.12 or higher
- Poetry for dependency management
-
Clone the repository
git clone https://github.com/Ramdam17/QCTutorial cd QCTutorial -
Install dependencies with Poetry
poetry install
-
Launch Jupyter
poetry run jupyter notebook
-
Open the first notebook (
notebooks/00_first_qubit.ipynb) and start learning!
- Quantum Framework: Qiskit - IBM's open-source quantum computing SDK
- Visualization: Matplotlib + Seaborn with custom "sparkly/unicorn" theme 🦄✨
- Numerical Computing: NumPy
- Development: Poetry for dependency management, Black & Ruff for code quality
First Qubit → Superposition → Rotations → Two Qubits → Entanglement → Deutsch → Teleportation
↓ ↓ ↓ ↓ ↓ ↓ ↓
Basics Foundation Interference CNOT Gate Correlations Algorithm Protocol
(⭐) (⭐) (⭐⭐) (⭐⭐) (⭐⭐⭐) (⭐⭐) (⭐⭐⭐)
QCTutorial/
├── README.md # This file
├── pyproject.toml # Poetry dependencies
├── notebooks/
│ ├── 00_first_qubit.ipynb # Notebook 0: My First Qubit
│ ├── 01_superposition.ipynb # Notebook 1: Superposition
│ ├── 02_rotations_interference.ipynb # Notebook 2: Rotations & Interference
│ ├── 03_two_qubits_cnot.ipynb # Notebook 3: Two Qubits & CNOT
│ ├── 04_entanglement.ipynb # Notebook 4: Entanglement
│ ├── 05_deutsch_algorithm.ipynb # Notebook 5: Deutsch's Algorithm
│ └── 06_teleportation.ipynb # Notebook 6: Teleportation
└── utils/
├── __init__.py # Package initialization
└── plotting.py # Beautiful visualization utilities
After completing this workshop, continue your quantum journey with:
- Qiskit Textbook: learn.qiskit.org
- Quantum Algorithms: Grover's search, Shor's factoring
- Quantum Error Correction: Protecting quantum information from noise
- Variational Quantum Algorithms: QAOA, VQE for near-term quantum computers
- Quantum Machine Learning: QML with PennyLane or Qiskit ML
This is an educational project. Feedback, suggestions, and improvements are welcome!
MIT License - Feel free to use this workshop for learning and teaching.