A system for assigning and grading notebooks.

Warning: nbgrader is not yet stable and is under active development. The following instructions are currently incomplete and may change!

Documentation can be found on Read the Docs.

To install nbgrader, you will need version 3.x of IPython. However, note that version 3.0 will NOT work -- you will need at least version 3.1. If you do not have version 3.1 of IPython installed (you can check with ipython --version), you can install it by:

git clone --recursive -b 3.x https://github.com/ipython/ipython.git && pip install -e "ipython[all]"

To install the most recent (development, and possibly unstable!) version of nbgrader, run:

pip install git+git://github.com/jupyter/nbgrader.git@master

You can then install and activate the nbgrader assignment toolbar extension with:

nbgrader extension install
nbgrader extension activate

To get help and see all the options you can pass while installing/activating the nbgrader notebook extension, use:

nbgrader extension install --help-all
nbgrader extension activate --help-all