Skip to content

About

ZHUDDLE Python Functions Quest: Astro and React learning app with real Python checks, scores, certificates, and notebook exports

Resources

Stars

3 stars

Watchers

0 watching

Forks

Repository files navigation

ZHUDDLE — Big ideas. Small steps.

Your next little win starts with Python.

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

7 chapters 56 coding missions 70 knowledge checks Python runs in your browser


A little curiosity. A little code.

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.

Illustrated ZHUDDLE dashboard preview with a chapter path, Python workspace, learning goals, and badges

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.

From “I think I get it” to “I made it work.”

  1. Pick a chapter. Start with Variables or jump to the topic you want to practice.
  2. Try a mission. Read the prompt, explore a hint, and write your solution in the Python editor.
  3. Run & check. See the results, improve your answer, and check it again. Retries have no scoring penalty.
  4. Take your progress with you. Finish the knowledge checks and download your chapter work.

Promotional close-up of a Python variables mission, hint helper, and Run & check button

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.

Seven chapters. Room to grow.

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.

See ZHUDDLE in action

A 10-second introduction to the world of ZHUDDLE.

View the ZHUDDLE intro video — Find your next little win

▶ View the 10-second intro · MP4
Opens the video file on GitHub. Download it if playback is unavailable.

Good to know before you begin

  • 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.

Run it locally

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 dev

Open 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

Common commands

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

Built with

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.

Find your way around

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

Help the next learner find their spark

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.

Credits

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 →

About

ZHUDDLE Python Functions Quest: Astro and React learning app with real Python checks, scores, certificates, and notebook exports

Resources

Stars

3 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages