<p align="center"> <img src="assets/mograder.svg" alt="mograder logo" width="128" height="128"> </p>

mograder

Semi-automated grading for Marimo notebooks.

<p align="center"> <img src="assets/mograder-demo.gif" alt="mograder student demo" width="720"> </p>

How it works: Instructors author source notebooks with solution blocks and automated checks. mograder generate strips solutions to create release versions. Students complete the notebooks and get instant formative feedback from check() calls. mograder autograde executes submissions in sandboxed subprocesses, parses results, and stores grades in an SQLite gradebook. Markers review and add manual marks via the formgrader dashboard. mograder feedback exports annotated HTML for students.

Quick start

pip install mograder          # or: uv add mograder
mograder generate hw1         # strip solutions → release/
mograder autograde hw1        # grade submissions → autograded/
mograder feedback hw1         # export HTML → feedback/

Live demo

Try the student dashboard — a WASM app running entirely in your browser. See also the formgrader with pre-populated demo data and a demo workshop with encrypted solutions.

Documentation

| | | |---|---| | Full Documentation | Overview, installation, and all guides | | Instructor Guide | Step-by-step setup and grading walkthrough | | Student Guide | Setup instructions to share with students | | Usage Reference | All commands: generate, autograde, feedback, moodle, ... | | API Reference | check(), Grader, CLI, and module docs | | Configuration | Full mograder.toml reference | | Security | Threat model and sandboxing options |

For students

Easiest: download the desktop app — no terminal needed.

Or via the command line:

curl -LsSf https://astral.sh/uv/install.sh | sh
uvx mograder student https://mograder-demo.jrkermode.uk/mograder.toml

For real courses, your instructor will provide the config URL. Or open in GitHub Codespaces — one click, no install needed.

License

MIT