@@ -1,131 +1,153 @@
-# 🐍 Python Bootcamp — Interactive Browser Learner
+# 🐍 Python Bootcamp
 
-A fully self-contained Python learning platform that runs entirely in your browser. No installs, no terminal, no server. Just download the HTML file and open it.
+**An interactive, browser-based Python learning platform — no installs, no terminal, no setup.**
 
-![Python](https://img.shields.io/badge/Python-3.x-blue) ![Pyodide](https://img.shields.io/badge/Pyodide-0.24.1-green) ![React](https://img.shields.io/badge/React-18-61DAFB) ![License](https://img.shields.io/badge/license-MIT-lightgrey)
+Download one HTML file. Double-click. Start learning.
 
 ---
 
-## ✨ Features
+## ✨ What Is This?
 
-- **Run Python in the browser** — powered by [Pyodide](https://pyodide.org/) (Python compiled to WebAssembly)
-- **19 hands-on lessons** across 10 phases — from Hello World to AI Agents
-- **Line-by-line explanations** — toggle to reveal what every line does
-- **Built-in code editor** — CodeMirror with Python syntax highlighting, Dracula/Eclipse themes
-- **AI Tutor chatbot** — powered by Gemini (free), OpenAI, or Anthropic
-- **Progress tracking** — lessons marked complete, persisted to localStorage
-- **Cheat sheet** — quick Python reference always one click away
-- **Quiz** — 8-question quiz with best-score tracking
-- **Dark / light mode** — toggle anytime
-- **FastAPI Simulator** — interactive mock REST API (Phase 5) with live mode support
+Python Bootcamp is a self-contained, offline-capable learning app packed into a single `.html` file. It runs entirely in your browser using [Pyodide](https://pyodide.org/) — a full Python runtime compiled to WebAssembly — so you can write and execute real Python code without installing anything.
+
+Built for complete beginners who want to learn Python through hands-on projects, with line-by-line explanations for every single line of code.
 
 ---
 
 ## 🚀 Quick Start
 
-1. Download `python_bootcamp_standalone.html`
-2. Open it in Chrome or Firefox
-3. Click any lesson and hit **▶ Run**
+```bash
+# Clone the repo
+git clone https://github.com/mysnoopy/Python-Bootcamp.git
+cd Python-Bootcamp
+
+# Option 1 — just open it
+open python_bootcamp_standalone.html
+
+# Option 2 — serve locally (recommended for AI chat features)
+python3 -m http.server 7777
+# then visit http://localhost:7777/python_bootcamp_standalone.html
+```
 
-> Internet connection required for CDN assets (React, CodeMirror, Pyodide) and the AI Tutor.
+No npm. No pip. No virtual environments. Nothing to install.
 
 ---
 
-## 📚 Curriculum
+## 📚 Curriculum — 23 Lessons Across 10 Phases
 
 | Phase | Topic | Lessons |
 |-------|-------|---------|
-| 🐍 Phase 1 | Python Basics | 1a: Hello World & Variables · 1b: Conditions & Loops |
-| 📦 Phase 2 | Data Types | 2a: Lists & Dictionaries · 2b: Functions |
-| 🏗️ Phase 3 | OOP | 3a: Classes & Objects |
-| 🔌 Phase 4 | APIs | 4a: REST APIs & HTTP |
-| ⚙️ Phase 5 | Frameworks | 5a: FastAPI Backend *(interactive simulator)* |
-| 🤖 Phase 6 | AI / LLMs | 6a: AI API — Movie Recommender |
-| 🧠 Phase 7 | AI Topics | 7a: Prompt Engineering · 7b: RAG · 7c: AI Agents & Tools |
-| 🗄️ Phase 8 | Data & Files | 8a: CSV & JSON · 8b: Mini Database · 8c: Data Analysis |
-| 🧪 Phase 9 | Testing & Debugging | 9a: Reading Errors · 9b: Writing Tests · 9c: Debugging Tips |
-| 🔄 Phase 10 | Real Projects | 10a: CLI Todo App · 10b: Number Guessing Game · 10c: Budget Tracker |
-
-**Total:** ~9 hours of guided, project-based learning
+| 🐍 Phase 1 | **Python Basics** | Hello World & Variables, Conditions & Loops, Don't Panic: Reading Errors |
+| 📦 Phase 2 | **Data Types** | Lists & Dictionaries, Functions, String Methods |
+| 🏗️ Phase 3 | **OOP** | Library Book System |
+| 🔌 Phase 4 | **APIs** | Live Weather Fetcher |
+| ⚙️ Phase 5 | **Frameworks** | FastAPI Backend *(interactive simulator)* |
+| 🤖 Phase 6 | **AI / LLMs** | AI API Movie Recommender |
+| 🧠 Phase 7 | **AI Topics** | Prompt Engineering, RAG Knowledge Base, AI Agents & Tools |
+| 🗄️ Phase 8 | **Data & Files** | File I/O, CSV & JSON, Mini Database, Data Analysis |
+| 🧪 Phase 9 | **Testing & Debugging** | Reading Errors, Writing Tests, Debugging Tips |
+| 🔄 Phase 10 | **Real Projects** | CLI Todo App, Number Guessing Game, Budget Tracker |
 
 ---
 
-## 🤖 AI Tutor Setup
+## 🎯 Features
 
-Click the 💬 button (bottom right) to open the AI Tutor. Paste in one API key — stored locally and never sent anywhere except the provider's API.
-
-| Provider | Model | Cost | Get Key |
-|----------|-------|------|---------|
-| 🟢 Google Gemini | gemini-2.5-flash | **Free** | [aistudio.google.com](https://aistudio.google.com) |
-| 🟦 OpenAI | gpt-4o-mini | ~$0.60/1M tokens | [platform.openai.com](https://platform.openai.com) |
-| 🟠 Anthropic | claude-haiku-4-5 | ~$0.80/1M tokens | [console.anthropic.com](https://console.anthropic.com) |
+- **Line-by-line explanations** — every code line has a plain-English description, toggleable with 💡 ON/OFF
+- **Built-in code editor** — powered by [CodeMirror](https://codemirror.net/) with syntax highlighting
+- **Run in browser** — real Python execution via [Pyodide](https://pyodide.org/) (WebAssembly)
+- **Memory trick box** — each lesson opens with a key concept to anchor the learning
+- **Progress tracking** — mark lessons done, track completion %, stored in localStorage
+- **AI Chat Tutor** — ask questions about any lesson using your own API key (see below)
+- **Cheat Sheet** — quick-reference syntax guide with one-click copy
+- **Quiz mode** — test yourself across all concepts
+- **Dark / Light theme** — toggle with ☀️ / 🌙
+- **FastAPI simulator** — interactive REST API sandbox, no server needed
+- **Fully offline** — works without internet after initial load *(Google Fonts and Pyodide CDN require one-time network fetch)*
 
 ---
 
-## ⚙️ FastAPI Simulator (Phase 5)
+## 🤖 AI Chat Tutor
 
-Phase 5 includes a full interactive REST API simulator — no server needed.
+The app includes a built-in AI tutor that can answer questions about any lesson. It supports three providers — you bring your own API key:
 
-- **4 endpoints:** `GET /books`, `POST /books`, `PUT /books/{id}`, `DELETE /books/{id}`
-- **Live DB panel** — see your in-memory database update in real time
-- **Live Mode** — toggle to send real requests to a local FastAPI server at `localhost:8000`
+| Provider | Model | Status |
+|----------|-------|--------|
+| 🟢 Google Gemini | `gemini-2.5-flash` | ✅ Tested & working |
+| 🟦 OpenAI | `gpt-4o-mini` | ⚠️ Untested — bugs possible |
+| 🟠 Anthropic Claude | `claude-haiku-4-5-20251001` | ⚠️ Untested — bugs possible |
 
-To run Phase 5 with a real server:
-```bash
-pip install fastapi uvicorn
-python main.py
-```
+> **Note:** Only the **Gemini API key** has been tested end-to-end. The OpenAI and Anthropic integrations are implemented but **have not been tested with real API keys**. If you run into issues with ChatGPT or Claude keys, please [open an issue](https://github.com/mysnoopy/Python-Bootcamp/issues) with the error details — contributions welcome!
+
+**Getting a free Gemini key (recommended):**
+1. Visit [aistudio.google.com](https://aistudio.google.com)
+2. Click **Get API key** → **Create API key**
+3. Paste into **⚙️ Setup AI** in the top-right corner — takes 30 seconds
 
 ---
 
-## 🛠️ Tech Stack
+## 🏗️ Tech Stack
 
 | Layer | Technology |
 |-------|-----------|
-| Python runtime | [Pyodide](https://pyodide.org/) 0.24.1 (WASM) |
-| UI framework | React 18 |
-| Code editor | CodeMirror 5.65.16 |
-| JS compiler | Babel Standalone 7.23.10 |
-| AI Tutor | Gemini / OpenAI / Anthropic APIs |
+| Python Runtime | [Pyodide](https://pyodide.org/) (Python 3.11 via WebAssembly) |
+| UI Framework | React 18 (Babel standalone — no build step) |
+| Code Editor | CodeMirror 5 |
+| Fonts | Plus Jakarta Sans + Space Mono (Google Fonts) |
+| Storage | `localStorage` (progress + settings) |
+| Deployment | Single `.html` file — zero dependencies |
 
 ---
 
-## 📁 Files
+## 📁 Project Structure
 
 ```
-python_bootcamp_standalone.html   # The entire app — single file, ~2300 lines
-main.py                           # FastAPI backend for Phase 5 live mode
-README.md
+Python-Bootcamp/
+├── python_bootcamp_standalone.html   # ← The entire app (one file)
+└── README.md
 ```
 
+The whole platform — curriculum data, UI, Python runtime loader, AI chat, quiz engine — lives in a single file.
+
+---
+
+## 🐛 Known Limitations
+
+- **Pyodide cold start** — takes 3–8s on first load (downloading Python WASM runtime ~10MB)
+- **No `sqlite3`** — not included in Pyodide; lessons use dicts/lists instead
+- **No `pandas`** — not available by default; data lessons use `csv` + `statistics`
+- **No `requests`** — use `pyodide.http.open_url` for HTTP (handled inside lessons)
+- **AI lessons require an API key** — they won't execute without one configured
+- **OpenAI / Claude API keys untested** — Gemini is the recommended provider for now
+
 ---
 
-## 🔧 Development
+## 🛠️ Local Development
 
-The entire app is a single HTML file with an embedded React + Babel application. To modify:
+The app is plain HTML + React + Babel — no build tooling required.
 
 1. Open `python_bootcamp_standalone.html` in VS Code
-2. Edit the `<script type="text/babel">` section
-3. Refresh the browser — Babel recompiles on every load
+2. Find the `<script type="text/babel">` tag — all app logic lives here
+3. Edit and save
+4. Hard-reload in browser: `Cmd+Shift+R` (Mac) / `Ctrl+Shift+R` (Windows/Linux)
 
-**Curriculum data** lives in the `curriculum` array near the top of the script. Each lesson has:
-- `id`, `title`, `duration`, `project` — metadata
-- `memTrick` — mnemonic shown above the editor
-- `concepts` — badge chips shown in the phase overview
-- `lines` — array of `{code, exp}` objects (the step-by-step code)
+**Version tracking:** Each build includes a version stamp + MD5 checksum on the loading screen (e.g. `v2026-03-09c · #44483a6b`) so you always know exactly which version is running.
 
 ---
 
-## 🤝 Contributing
+## 🗺️ Roadmap
 
-PRs welcome! Good first contributions:
-- Add new lessons to existing phases
-- Fix typos in `exp:` explanation fields
-- Add quiz questions
-- Improve mobile layout
+- [ ] Add missing lessons: While Loops (1c), Modules & Imports (2c), Python Shortcuts (2d)
+- [ ] Test and fix OpenAI + Anthropic AI chat integrations
+- [ ] Mobile layout improvements
+- [ ] Shareable lesson links
+- [ ] More real-world projects in Phase 10
 
 ---
 
 ## 📄 License
 
-MIT — use freely, modify freely, share freely.
+MIT — free to use, fork, and build on.
+
+---
+
+*Built with ❤️ by [Clarence](https://github.com/mysnoopy) · Octoix AI*