Learn a concept. Write real code. See what clicks.
ZHUDDLE turns Python foundations into small, guided missions you can complete in your browser.
Start learning ↗ · Watch the intro · Run it locally · Share feedback
Getting started is easier when the next step is clear. ZHUDDLE brings the lesson, code editor, feedback, and progress into one welcoming workspace, so you can focus on making something work.
Promotional artwork from the ZHUDDLE intro. Explore the live app →
| Make something work | Build a little momentum | Keep what you learn |
|---|---|---|
| Write and run real Python in the browser, with a focused mission and helpful hints. | Get feedback from five checks per coding mission, retry freely, and earn chapter XP. | Return to saved progress on the same browser and export notebooks, reports, and completion certificates. |
- Pick a chapter. Start with Variables or jump to the topic you want to practice.
- Try a mission. Read the prompt, explore a hint, and write your solution in the Python editor.
- Run & check. See the results, improve your answer, and check it again. Retries have no scoring penalty.
- Take your progress with you. Finish the knowledge checks and download your chapter work.
Each chapter has 8 coding missions + 10 knowledge checks = 100 possible XP. Check all 18 answers to unlock its completion certificate; a perfect score is not required.
Follow the path or revisit a single topic. Every chapter has its own saved answers, score, and downloads.
| Chapter | Practice | Start here |
|---|---|---|
| 02 · Variables | Values, types, expressions, and assignments | Explore variables → |
| 03 · Conditionals | Comparisons, branches, and decisions | Explore conditionals → |
| 04 · Functions | Parameters, return values, and reusable code | Explore functions → |
| 05 · Loops | Repetition, counters, and running totals | Explore loops → |
| 06 · Strings | Indexing, slicing, searching, and text methods | Explore strings → |
| 07 · Files | Reading and processing sample text files | Explore files → |
| 08 · Lists | Collections, traversal, and list operations | Explore lists → |
Chapter numbers follow the Python for Everybody textbook. These are the seven chapters currently available.
A 10-second introduction to the world of ZHUDDLE.
▶ View the 10-second intro · MP4
Opens the video file on GitHub. Download it if playback is unavailable.
- No Python installation needed. Python loads on your first code run, which needs an internet connection.
- Your progress stays in this browser. Answers and learner details are stored in localStorage, with no student database or cross-device sync. Clearing site data removes saved progress, so export work you want to keep.
- A local learner profile. The current course asks for a name and UNT ID for personalized downloads; these remain on your device.
- Practice at your pace. Keyboard navigation, a responsive layout, reduced-motion support, and a persistent motion toggle are built in.
- Certificates celebrate practice. Scores are local practice results pending instructor review. Certificates are not official UNT credentials.
Traffic reporting: Free Cloudflare Web Analytics integration is available for visits, page views, and traffic sources. Set the public site token in your hosting environment and redeploy. See traffic analytics setup, including the separate setup needed for attack reports.
Requirements: Node.js 22.12+ and pnpm.
git clone https://github.com/PCTEJA/zhuddle-python.git
cd zhuddle-python
pnpm install
pnpm devOpen http://localhost:4321. Lessons and Python checks work without API keys. To enable the Groq-powered Code Coach and Zhuddle Guide, copy .env.example to .env, set the server-only GROQ_API_KEY, and restart the dev server. See AI assistant setup for hosting and free-tier details.
Build, test, and explore the code
| Command | What it does |
|---|---|
pnpm build |
Build the static site into dist/ |
pnpm preview |
Preview the production build locally |
pnpm exec playwright install chromium |
Install the browser used by the test suite |
pnpm test |
Run browser tests; Pyodide checks need internet access |
pnpm test:grader |
Run local grading checks; requires Python |
pnpm curriculum:build |
Regenerate chapter banks and notebooks; requires Python |
Astro · React · Pyodide · CodeMirror · jsPDF · Playwright
Astro delivers the static page, React powers the learning workspace, and Pyodide runs Python in a dedicated web worker. The editor, interpreter, and PDF tools load when needed.
| Location | Purpose |
|---|---|
src/components/ |
Learning interface and interactions |
src/data/curriculum.js |
Chapter registry |
src/data/chapter-guides.js |
Public chapter guide content |
public/python-worker.js |
Browser Python execution and grading |
scripts/ |
Curriculum and media generation |
tests/ |
Browser checks, grader tests, and reference solutions |
Netlify and Vercel configurations include /api/assistant. Deploy the project with its functions and set GROQ_API_KEY in the host's server environment. Uploading only dist/ provides the lessons and built-in guidance, but cannot connect Groq.
Go deeper: Developer guide · Performance & SEO notes · Video publishing guide
Found a confusing prompt or an unexpected result? Open an issue with the chapter, mission, and what happened. Ideas for clearer explanations, accessibility improvements, and small fixes are welcome.
If ZHUDDLE helps you, star the repository, share zhuddle.com, or support the project.
Learning material is based on Charles R. Severance’s Python for Everybody, licensed under CC BY 4.0. ZHUDDLE adds its own question wording, practice scaffolding, scoring, and interface. See the chapter sources and adaptation notes. This attribution describes the source learning material, not a license for the entire repository.
Big ideas. Small steps.
Your next little win is one mission away.
Start your Python journey →