An interactive, beginner-friendly quantum computing educational app built with Streamlit and Qiskit. Explore concepts like superposition, entanglement, interference, and quantum algorithms with hands-on simulations and visualizations.
- Electron cloud 3D visualization: See quantum superposition in action.
- Classical vs Quantum: Compare bits and qubits, and explore logic gates.
- Interactive Bloch spheres: Visualize qubit states dynamically.
- Entanglement demonstrations: Explore correlations between qubits.
- Quantum algorithms: Observe interference and amplitude amplification.
- Real-world quantum computers: Learn about IBM, IonQ, and their applications.
- Clickable explanations: Learn the meaning of key terms (qubit, superposition, decoherence, etc.).
- Beginner-friendly: Designed for hackathons or educational workshops.
- Python 3.10+
- Libraries:
streamlit
qiskit
qiskit-aer
plotly
numpy
pylatexenc
Optional but recommended: create a virtual environment to avoid conflicts.
- Clone this repository:
git clone https://github.com/natedemoss/quantum-hackathon.git
cd quantum-hackathon-lab- (Optional) Create a virtual environment:
python -m venv venv- Activate the environment:
- Windows:
venv\\Scripts\\activate- Linux/Mac:
source venv/bin/activate- Install dependencies:
pip install -r requirements.txtstreamlit run app.py- Open the URL shown in the terminal (e.g., http://localhost:8502) to access the app.
- Use the sidebar to navigate through sections 0–7.
| Section | Topic |
|---|---|
| 0 | The Tiny World – Atoms & electron clouds |
| 1 | The Classical World – Bits and logic gates |
| 2 | Enter the Quantum – Qubits and superposition |
| 3 | Spooky Connections – Entanglement |
| 4 | The Quantum Trick – Interference |
| 5 | Quantum in Action – Quantum algorithms |
| 6 | Quantum in the Real World – Decoherence |
| 7 | Applications & Wrap-up – Real quantum computers & use cases |
- Interactive Graphs: Hover over 3D or 2D plots to see values and understand distributions.
- Expanders for Explanations: Click on terms like qubit, statevector, or decoherence to learn their definitions.
- Electron Cloud (3D):
- Darker areas indicate higher probability of finding an electron.
- Demonstrates quantum superposition in space.
- Bloch Sphere:
- Axes X, Y, Z represent quantum coordinates.
- Arrow shows qubit state vector; direction indicates superposition.
- Shrinking arrow represents decoherence.
- Histograms:
- Peaks show probability of measuring 0 or 1.
- Interference patterns show constructive/destructive combination of amplitudes.
- Quantum Algorithm Histograms:
- Visualize how superposition, entanglement, and interference amplify correct outcomes.
MIT License