african-qc/african_qubit

# African Qubit - Quantum Measurement System A hands-on quantum computing demonstration using ESP32 microcontrollers, LEDs, LCD displays, and Python quantum simulation. ## 🌟 Overview This project demonstrates quantum superposition and measurement through physical hardware: - **LEDs represent quantum states** (superposition and collapsed states) - **Button press triggers measurement** to collapse quantum superposition - **Python runs quantum simulations** using Qiskit for authentic randomness - **LCD displays real-time feedback** and measurement statistics ## 📁 Project Structure ``` african_qubit/ ├── README.md # This file ├── on_arduino_ide/ # Arduino C++ implementation │ ├── README.md # Detailed Arduino setup guide │ ├── run_on_esp32/ # ESP32 Arduino code │ └── run_on_local_python/ # Python quantum simulation └── on_thonny/ # MicroPython implementation ├── README.md # Detailed MicroPython setup guide ├── run_on_thonny/ # ESP32 MicroPython code └── run_on_local_python/ # Python quantum simulation ``` ## 🚀 Quick Start ### Choose Your Implementation #### Option 1: Arduino (Recommended for Beginners) ```bash # 1. Upload Arduino code to ESP32 # 2. Install Python dependencies pip install pyserial qiskit qiskit-aer # 3. Run quantum simulation cd on_arduino_ide/run_on_local_python python quantum_arduino.py ``` #### Option 2: MicroPython (Python on ESP32) ```bash # 1. Install MicroPython on ESP32 using Thonny # 2. Upload MicroPython code # 3. Install Python dependencies pip install pyserial qiskit qiskit-aer # 4. Run quantum simulation cd on_thonny/run_on_local_python python quantum_led.py ``` ## 🔧 Hardware Requirements - **ESP32 Development Board** - **2 LEDs** with 220Ω resistors - **1 Push Button** (momentary switch) - **16x2 LCD Display** (HD44780 compatible) - **Breadboard and jumper wires** ## 🎯 Key Features - ✅ **Quantum Superposition Visualization**: …