nbgrader

Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).

nbgrader hilft dabei, Aufgaben in Jupyter-Notebooks zu erstellen, Abgaben zu prüfen und Bewertungen zu verwalten.

Voraussetzungen und Aufbau

Diese Anleitung richtet nbgrader auf Ubuntu 26.04 LTS (amd64) für die lokale Arbeit im eigenen Benutzerkonto ein. JupyterLab liefert die Oberfläche im Browser. Ein eigener Datenbankserver und Container sind nicht erforderlich.

Die Systemwerkzeuge kommen aus apt. nbgrader wird nach dem offiziellen Installationsweg mit pip in eine eigene virtuelle Python-Umgebung installiert. So bleiben Ubuntu-Pakete und die Pakete dieser Anwendung getrennt. Eine virtuelle Python-Umgebung ist kein Container.

Stand November 2026 ist nbgrader 0.9.6 verfügbar und verlangt Python ab 3.11. Diese Anleitung verwendet diese Version mit JupyterLab 4 und dem Python von Ubuntu. Die vollständige Installation auf Ubuntu 26.04 wurde hier nicht praktisch getestet.

Bei der Bewertung beachten: Notebook-Code läuft mit den Rechten des Benutzerkontos, das den Kernel startet. Die virtuelle Python-Umgebung schützt weder deine Dateien noch dein Netzwerk vor fremdem Code. Führe fremde Abgaben deshalb ausschließlich in einer dafür vorgesehenen, getrennten Ausführungsumgebung aus. Die folgenden Schritte dienen zunächst der Arbeit mit eigenen Beispielen.

Installation

1. Paketlisten aktualisieren

Damit Ubuntu die verfügbaren Paketversionen kennt.

sudo apt update

2. Python-Werkzeuge installieren

python3-venv stellt die getrennte Python-Umgebung bereit. python3-pip liefert den Paketmanager; der Browser wird später nur zur Bedienung verwendet.

sudo apt install python3 python3-venv python3-pip

Prüfen: Auf Ubuntu 26.04 sollte Python 3.14 angezeigt werden.

python3 --version

3. Arbeitsordner anlegen

Hier werden die Python-Umgebung und später deine Kursordner gespeichert.

mkdir -p ~/nbgrader-arbeitsplatz

4. In den Arbeitsordner wechseln

Alle folgenden relativen Pfade beziehen sich zunächst auf diesen Ordner.

cd ~/nbgrader-arbeitsplatz

5. Python-Umgebung erstellen

Erzeugt .venv mit eigenen Paketverzeichnissen. Verwende einen neuen Arbeitsordner, falls dort bereits eine Umgebung für einen anderen Zweck liegt.

python3 -m venv .venv

6. Python-Umgebung aktivieren

Die Befehle python, pip, jupyter und später nbgrader werden in diesem Terminal aus der Umgebung verwendet.

source .venv/bin/activate

Prüfen: Der Pfad muss auf .venv/bin/python im Arbeitsordner zeigen.

command -v python

7. pip innerhalb der Umgebung aktualisieren

Eine aktuelle Version verbessert die Erkennung passender Paketdateien für das Python von Ubuntu.

python -m pip install --upgrade pip

8. nbgrader und Notebook-Werkzeuge installieren

Installiert die festgelegte nbgrader-Version, JupyterLab 4 und einen Python-Kernel. Alle Pakete landen in .venv; sudo ist hier nicht erforderlich. Die nbgrader-Erweiterungen werden automatisch mit eingerichtet. Ein separates Node.js oder ein manueller JavaScript-Build ist für diesen Installationsweg nicht nötig.

python -m pip install 'nbgrader==0.9.6' 'jupyterlab>=4.2,<5' ipykernel

9. Paketabhängigkeiten prüfen

Die Ausgabe soll No broken requirements found lauten. Bei Konflikten behebe zuerst die gemeldeten Abhängigkeiten, bevor du einen Kurs anlegst.

python -m pip check

10. nbgrader-Version prüfen

Damit lässt sich feststellen, ob der Programmaufruf aus der neuen Umgebung funktioniert. Erwartet wird Version 0.9.6.

nbgrader --version

11. JupyterLab-Erweiterung prüfen

Die Ausgabe soll die Erweiterung @jupyter/nbgrader als aktiviert und ohne Kompatibilitätsfehler aufführen.

jupyter labextension list

12. Server-Erweiterungen prüfen

Kontrolliert die nbgrader-Komponenten auf der Serverseite. Die Einträge unter nbgrader.server_extensions sollen aktiviert sein und die Validierung bestehen.

jupyter server extension list

Einen Beispielkurs öffnen

13. Beispielkurs erzeugen

quickstart legt einen Kursordner mit Beispieldateien und einer Kurskonfiguration an. Der Name uebungskurs darf im Arbeitsordner noch nicht als Kursverzeichnis existieren.

nbgrader quickstart uebungskurs

14. In den Kursordner wechseln

nbgrader findet seine Kurskonfiguration über das aktuelle Arbeitsverzeichnis. Starte JupyterLab deshalb für diesen Versuch von hier aus.

cd ~/nbgrader-arbeitsplatz/uebungskurs

Prüfen: Im Verzeichnis sollten unter anderem nbgrader_config.py und der Ordner source liegen. source enthält die Lehrendenfassung der Aufgaben; gib diesen Ordner nicht als Studierendenfassung weiter.

ls

15. JupyterLab starten

Der Server lauscht nur auf dem eigenen Rechner. Die Anmeldung über den automatisch erzeugten Token bleibt eingeschaltet. Das Terminal bleibt während des Betriebs belegt.

jupyter lab --ip=127.0.0.1 --port=8888 --no-browser

16. Oberfläche im Browser öffnen

Kopiere die im Terminal ausgegebene vollständige lokale URL einschließlich token=… in den Browser. Der Token gewährt Zugang zu dieser Sitzung; teile ihn nicht mit anderen Personen.

17. Aufgabenverwaltung prüfen

Öffne in JupyterLab über View → Activate Command Palette die Befehlssuche, suche nach formgrader und öffne den entsprechenden nbgrader-Befehl. Die Aufgabenverwaltung soll als zusätzlicher Tab erscheinen. Diesen Einstieg beschreibt auch die offizielle Anleitung zur Aufgabenbearbeitung.

18. Ein Beispielnotebook öffnen

Öffne im Dateibrowser unter source einen Aufgabenordner und darin ein Notebook. Verwende bei Bedarf den Kernel Python 3 (ipykernel). Die nbgrader-Seitenleiste Create Assignment dient zum Kennzeichnen von Antwort- und Testzellen. Für einen ersten Funktionstest genügen die eigenen Beispieldateien.

19. JupyterLab beenden

Drücke im Serverterminal Strg+C und bestätige die Beendigung, falls Jupyter nachfragt. Das Schließen des Browserfensters allein beendet den Server nicht.

Später erneut starten

1. Umgebung aktivieren

In einem neuen Terminal muss die Umgebung erneut ausgewählt werden.

source ~/nbgrader-arbeitsplatz/.venv/bin/activate

2. Kursordner öffnen

Damit die richtige Kurskonfiguration verwendet wird.

cd ~/nbgrader-arbeitsplatz/uebungskurs

3. JupyterLab starten

Verwende anschließend wieder die im Terminal ausgegebene URL mit Token.

jupyter lab --ip=127.0.0.1 --port=8888 --no-browser

Typische Probleme

  • externally-managed-environment: Aktiviere die Umgebung aus Schritt 6. Verwende kein sudo pip und kein --break-system-packages.
  • Erweiterung fehlt: Beende JupyterLab und starte es aus derselben aktivierten Umgebung, in der nbgrader installiert ist. Wiederhole die beiden Erweiterungsprüfungen und lade die Browserseite neu. Alte Befehle mit jupyter nbextension betreffen die klassische Notebook-Oberfläche und passen nicht zu diesem Aufbau.
  • Kernel fehlt oder startet nicht: Prüfe mit dem folgenden Befehl die verfügbaren Kernel. Der Kernel muss auf ein noch vorhandenes Python zeigen.
jupyter kernelspec list
  • Port 8888 ist belegt: Jupyter kann einen anderen freien Port verwenden. Maßgeblich ist die tatsächlich im Terminal ausgegebene URL.
  • Paketinstallation scheitert: Lies die erste konkrete Fehlermeldung. Eine Mindestanforderung wie Python ab 3.11 garantiert nicht, dass jede Abhängigkeit mit jeder neueren Python-Version funktioniert.

Für mehrere Lehrende und Studierende ist eine zusätzliche Benutzer- und Austauschkonfiguration erforderlich. Die lokale Einzelplatzinstallation richtet weder JupyterHub noch einen gemeinsamen Abgabedienst ein. Hinweise dazu stehen in der Dokumentation zu JupyterHub.

Deinstallieren

1. JupyterLab beenden

Drücke im Serverterminal Strg+C und bestätige gegebenenfalls die Rückfrage, damit keine Kursdateien mehr geschrieben werden.

2. Python-Umgebung verlassen

Führe dies in einem Terminal mit aktivierter Umgebung aus. Dadurch verwendet das Terminal wieder die normalen Systembefehle.

deactivate

3. Python-Umgebung entfernen

Löscht nbgrader, JupyterLab und alle zusätzlich in dieser Umgebung installierten Pakete. Die Kursordner bleiben erhalten. Es wurde kein Kernel mit --user registriert, der zusätzlich entfernt werden müsste.

rm -rf -- ~/nbgrader-arbeitsplatz/.venv

4. Optional: Arbeitsordner samt Kursdaten löschen

Achtung: Dabei gehen auch Aufgaben, Lösungen, Abgaben und die Bewertungsdatenbank in diesem Ordner verloren. Sichere benötigte Kursdaten vorher.

rm -rf -- ~/nbgrader-arbeitsplatz

5. Entfernung der Umgebung prüfen

Die Ausgabe soll nbgrader-Umgebung entfernt lauten. Das System-Python und seine Ubuntu-Werkzeuge bleiben installiert.

test ! -e ~/nbgrader-arbeitsplatz/.venv && echo 'nbgrader-Umgebung entfernt'

Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).

Open Knowledge (Freies Wissen): Alle Texte stehen unter der freien Lizenz Creative Commons Namensnennung – Weitergabe unter gleichen Bedingungen 4.0 International (CC BY-SA 4.0) und können frei gelesen, geteilt und weiterverarbeitet werden.

Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).

Open Knowledge (Freies Wissen): Alle Texte stehen unter der freien Lizenz Creative Commons Namensnennung – Weitergabe unter gleichen Bedingungen 4.0 International (CC BY-SA 4.0) und können frei gelesen, geteilt und weiterverarbeitet werden.

Autor: Thorsten · Installationsanleitungen für Ubuntu

Alle Anleitungen ohne Gewähr. Befehle mit sudo verändern das System – vorher lesen, dann ausführen.