https://github.com/jupyter/nbgrader

A system for assigning and grading notebooks
https://github.com/jupyter/nbgrader

grading jupyter jupyter-notebook jupyterhub nbgrader teaching

Last synced: about 5 hours ago
JSON representation

A system for assigning and grading notebooks

• Host: GitHub
• URL: https://github.com/jupyter/nbgrader
• Owner: jupyter
• License: bsd-3-clause
• Created: 2014-09-13T03:27:36.000Z (over 10 years ago)
• Default Branch: main
• Last Pushed: 2024-12-20T19:28:52.000Z (2 months ago)
• Last Synced: 2024-12-28T19:03:47.004Z (about 2 months ago)
• Topics: grading, jupyter, jupyter-notebook, jupyterhub, nbgrader, teaching
• Language: Python
• Homepage: https://nbgrader.readthedocs.io/
• Size: 27.7 MB
• Stars: 1,302
• Watchers: 41
• Forks: 317
• Open Issues: 278
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE
  • Codemeta: codemeta.json

Awesome Lists containing this project

• awesome-python-applications - Repo - based application which enables educators to create, assign, and grade assignments in notebook form. `(server)` (<a id="tag-education" href="#tag-education">Education</a>)
• awesome-jupyter-resources - GitHub - 24% open · ⏱️ 22.08.2022): (Jupyter拓展)
• best-of-jupyter - GitHub - 29% open · ⏱️ 29.01.2025): (Jupyter Extensions)
• awesome-jupyter - nbgrader - Assigning and grading of Jupyter notebooks. (Collaboration/Education)
• -awesome-jupyter - nbgrader - Assigning and grading of Jupyter notebooks. (Collaboration/Education)
• awesome-python-applications - Repo - based application which enables educators to create, assign, and grade assignments in notebook form. `(server)` (<a id="tag-education" href="#tag-education">Education</a>)
• awesome-chemical-engineering-education - nbgrader - A system for assigning and grading Jupyter notebooks. (General Jupyter Education)

README

        
# nbgrader

Build: [![Build](https://img.shields.io/github/workflow/status/jupyter/nbgrader/Test?logo=github&label=tests)](https://github.com/jupyter/nbgrader/actions)

Forum: [![Google Group](https://img.shields.io/badge/-Google%20Group-lightgrey.svg)](https://groups.google.com/forum/#!forum/jupyter)

Cite: [![DOI](https://jose.theoj.org/papers/10.21105/jose.00032/status.svg)](https://doi.org/10.21105/jose.00032)

A system for assigning and grading Jupyter notebooks.

[Documentation can be found on Read the Docs.](https://nbgrader.readthedocs.io/en/stable/)

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

![Creating assignment](nbgrader/docs/source/user_guide/images/creating_assignment.gif "Creating assignment")

### Instructor "formgrader" extension for Jupyter notebooks

The formgrader extension for the Jupyter notebook allows instructors to use

the core functionality of nbgrader---generating the student version of an

assignment, releasing assignments to students, collecting assignments,

autograding submissions, and manually grading submissions.

![Formgrader extension](nbgrader/docs/source/user_guide/images/formgrader.gif "Formgrader extension")

### Student assignment list extension for Jupyter notebooks

Using the assignment list extension, students may conveniently view, fetch,

submit, and validate their assignments.

![nbgrader assignment list](nbgrader/docs/source/user_guide/images/student_assignment.gif "nbgrader assignment list")

### The command line tools of nbgrader

[Command line tools](https://nbgrader.readthedocs.io/en/latest/command_line_tools/index.html)

offer an efficient way for the instructor to generate, assign, release, collect,

and grade notebooks.

### SciPy 2017 overview talk (click to view on YouTube)

[![nbgrader: A Tool for Creating and Grading Assignments in the Jupyter Notebook | SciPy 2017 ](http://img.youtube.com/vi/5WUm0QuJdFw/0.jpg)](http://www.youtube.com/watch?v=5WUm0QuJdFw "nbgrader: A Tool for Creating and Grading Assignments in the Jupyter Notebook | SciPy 2017 ")

## Installation

For detailed instructions on installing nbgrader and the nbgrader extensions

for Jupyter notebook, please see [Installation](https://nbgrader.readthedocs.io/en/latest/user_guide/installation.html)

section in the User Guide.

## Contributing

Please see the [contributing guidelines and documentation](https://nbgrader.readthedocs.io/en/latest/contributor_guide/overview.html).

If you want to develop features for nbgrader, please follow the

[development installation instructions](https://nbgrader.readthedocs.io/en/latest/contributor_guide/installation_developer.html).