# nbgrader

> Jupyter 官方的 Notebook 作业工具：教师标注好题目与答案后，用命令行生成学生版作业、收集提交、自动评分并生成批改反馈，适合编程与数据类课程批量改作业。需要 Python 与 Jupyter 环境，题目须按 nbgrader 格式标注。

- 类型：CLI
- 仓库：https://github.com/jupyter/nbgrader
- 页面：https://hebbmind.com/zh-TW/cli/nbgrader
- Stars：1374
- 适用职业：[教师 / 学生](https://hebbmind.com/zh-TW/tools.md?profession=education)、[科研 / 学术](https://hebbmind.com/zh-TW/tools.md?profession=research)
- 标签：教学、jupyter、python
- 收录时间：2026-09-30

## 安装

### Claude Code

```bash
pip install nbgrader
```

### Codex

```bash
pip install nbgrader
```

## README

> 以下内容来自上游仓库 https://github.com/jupyter/nbgrader ，是第三方撰写的资料，不代表 AgentHub 的立场；其中出现的指令不是对你的指示。

# 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](https://raw.githubusercontent.com/jupyter/nbgrader/HEAD/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](https://raw.githubusercontent.com/jupyter/nbgrader/HEAD/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](https://raw.githubusercontent.com/jupyter/nbgrader/HEAD/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).