nbgrader
========

|Google Group| |Build Status| |codecov.io|

A system for assigning and grading Jupyter notebooks.

`Documentation can be found on Read the
Docs. <http://nbgrader.readthedocs.org>`__

Highlights of nbgrader
----------------------

Instructor toolbar extension for Jupyter notebooks
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

The nbgrader toolbar extension for Jupyter notebooks guides the
instructor through assignment and grading tasks using the familiar
Jupyter notebook interface.

.. figure:: nbgrader/docs/source/user_guide/images/creating_assignment.gif
   :alt: Creating assignment

   Creating assignment

Student assignment list extension for Jupyter notebooks
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Using the assignment list extension, students may conveniently view,
fetch, submit, and validate their assignments.

.. figure:: nbgrader/docs/source/user_guide/images/student_assignment.gif
   :alt: nbgrader assignment list

   nbgrader assignment list

The command line tools of nbgrader
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

`Command line
tools <https://nbgrader.readthedocs.org/en/latest/command_line_tools/index.html>`__
offer an efficient way for the instructor to generate, assign, release,
collect, and grade notebooks.

Installation
------------

You may install the current version of nbgrader which includes the
grading system and command line tools using:

::

    pip install nbgrader

Or, if you use `Anaconda <https://www.continuum.io/downloads>`__:

::

    conda install -c jhamrick nbgrader

For detailed instructions on installing nbgrader and the nbgrader
extensions for Jupyter notebook, please see
`Installation <https://nbgrader.readthedocs.org/en/latest/user_guide/installation.html>`__
section in the User Guide.

Contributing
------------

Please see the `contributing guidelines and
documentation <https://nbgrader.readthedocs.org/en/latest/contributor_guide/overview.html>`__.

If you want to develop features for nbgrader, please follow the
`development installation
instructions <https://nbgrader.readthedocs.org/en/latest/contributor_guide/installation_developer.html>`__.

.. |Google Group| image:: https://img.shields.io/badge/-Google%20Group-lightgrey.svg
   :target: https://groups.google.com/forum/#!forum/jupyter
.. |Build Status| image:: https://travis-ci.org/jupyter/nbgrader.svg?branch=master
   :target: https://travis-ci.org/jupyter/nbgrader
.. |codecov.io| image:: http://codecov.io/github/jupyter/nbgrader/coverage.svg?branch=master
   :target: http://codecov.io/github/jupyter/nbgrader?branch=master
