A system for assigning and grading Jupyter notebooks.
Documentation can be found on Read the Docs.
The nbgrader toolbar extension for Jupyter notebooks guides the instructor through assignment and grading tasks using the familiar Jupyter notebook interface.
Using the assignment list extension, students may conveniently view, fetch, submit, and validate their assignments.
Command line tools offer an efficient way for the instructor to generate, assign, release, collect, and grade notebooks.
nbgrader assign
: create a student version of a notebooknbgrader release
: release a notebook to studentsnbgrader collect
: collect students' submissionsnbgrader autograde
: autograde students' submissionsnbgrader formgrade
: launch the formgrader
You may install the current version of nbgrader which includes the grading system and command line tools:
pip install nbgrader
You may then install the nbgrader extensions for Jupyter notebook. This will install both the create assignment toolbar extension and assignment list notebook server extension:
nbgrader extension install
To use the toolbar extension as either an instructor or a student, activate the extension with:
nbgrader extension activate
If you want to install the extension for only your user environment and not
systemwide, use nbgrader extension install --user
.
If you don't want to have to reinstall the extension when nbgrader is updated,
use nbgrader extension install --symlink
.
To get help and see all the options you can pass while installing or activating the nbgrader notebook extension, use:
nbgrader extension install --help-all
nbgrader extension activate --help-all
Please see the contributing guidelines and documentation.
If you want to develop features for nbgrader, please follow the development installation instructions.