So starten Sie Jupyter Notebook über die Befehlszeile unter Windows, Mac und Linux

Jupyter Notebook ist so ziemlich die einfachste Möglichkeit, Python-Code direkt zu schreiben und auszuführen. Anstatt einen Code-Editor zu öffnen und Skripte manuell auszuführen, bietet es eine übersichtliche Oberfläche, auf der man kleine Codeabschnitte – sogenannte Zellen – ausführen, Ergebnisse sofort sehen, Diagramme erstellen, Notizen machen und alles in einer einzigen Datei speichern kann. Es eignet sich hervorragend, um Daten zu analysieren, Code-Schnipsel zu testen oder unkompliziert schnelle Experimente durchzuführen.

Aber gerade für Anfänger (und auch für Fortgeschrittene) kann die Ausführung von Jupyter über die Kommandozeile verwirrend sein. Wie startet man es nach der Installation? Warum öffnet es sich nicht im Browser? Oder warum erscheint die Meldung „Jupyter wird nicht erkannt“? Damit die Anwendung reibungslos startet, sind einige Einstellungen nötig, insbesondere die korrekte Installation von Python und Jupyter sowie deren Verfügbarkeit im Systempfad. Sind diese Grundlagen geklärt, lässt sich Jupyter mit einem kurzen Befehl starten. Es empfiehlt sich, eine eigene virtuelle Umgebung einzurichten, um Konflikte mit anderen Projekten zu vermeiden. Die Kenntnis des richtigen Ports und des richtigen Verzeichnisses kann später viel Ärger ersparen.

So starten Sie Jupyter Notebook und JupyterLab über die Kommandozeile

Prüfen Sie, ob Python installiert und zugänglich ist.

Wenn Python nicht erkannt wird, funktioniert natürlich auch nichts anderes.Öffnen Sie unter Windows die Eingabeaufforderung oder PowerShell und führen Sie folgenden Befehl aus:

py --version

oder

python --version

Wenn eine Versionsnummer angezeigt wird (z. B.Python 3.12), ist alles in Ordnung. Andernfalls müssen Sie Python von der offiziellen Website installieren und sicherstellen, dass es zu Ihrem Systempfad (PATH) hinzugefügt wird. Unter macOS/Linux führen Sie folgenden Befehl aus:

python3 --version

Wenn dort eine Version angezeigt wird, wunderbar. Dann können Sie loslegen. Andernfalls installieren Sie Python 3 und stellen Sie sicher, dass python3 in Ihrem PATH enthalten ist, oder verwenden Sie einfach die unten stehenden Befehle, um Jupyter in einer kontrollierten Umgebung zu installieren.

So installieren Sie JupyterLab (oder Notebook) in einer virtuellen Umgebung

Dieser Teil ist etwas langweilig, aber ziemlich wichtig. Durch das Einrichten einer virtuellen Umgebung bleiben Ihre Python-Projekte getrennt, sodass Abhängigkeiten nicht unübersichtlich werden. Unter Windows erstellen Sie eine solche Umgebung folgendermaßen:

py -m venv jupyter-env

und aktivieren Sie es:

• Für die Eingabeaufforderung: jupyter-env\Scripts\activate
• Für PowerShell: .\jupyter-env\Scripts\Activate.ps1

Nach der Aktivierung sollte Pip zur Sicherheit aktualisiert werden:

py -m pip install --upgrade pip

Installieren Sie nun Jupyter oder JupyterLab:

py -m pip install jupyterlab

Wenn Sie stattdessen die klassische Notebook-Benutzeroberfläche bevorzugen, ersetzen Sie jupyterlab durch notebook :

py -m pip install notebook

Dasselbe gilt für macOS/Linux; ersetzen Sie einfach die Befehle durch python3 -m pip und verwenden Sie wahrscheinlich source, anstatt Skripte direkt zu aktivieren.

Jupyter aus dem richtigen Ordner starten

Starten Sie Jupyter nicht einfach von Ihrem Download-Ordner oder Laufwerk C:\ aus. Es empfiehlt sich, einen separaten Ordner zu erstellen, beispielsweise im Ordner „Dokumente“, und dann in diesen zu wechseln.

cd "%USERPROFILE%\Documents\Jupyter Notebooks"

oder unter macOS/Linux:

cd ~/Documents/jupyter-notebooks

Dann führen Sie Folgendes aus:

jupyter lab

Wenn Sie direkt in einem bestimmten Verzeichnis starten möchten, ohne umständlich navigieren zu müssen, verwenden Sie die Option `–notebook-dir` wie folgt:

jupyter lab --notebook-dir="C:\Users\YourName\Documents\Jupyter Notebooks"

oder

jupyter lab --notebook-dir="$HOME/Documents/jupyter-notebooks"

Jupyter ausführen, ohne automatisch einen Browser zu öffnen

Manchmal möchten Sie Jupyter auf einem entfernten Server oder via SSH ausführen. Fügen Sie dazu einfach die Option `–no-browser` zum Startbefehl hinzu:

jupyter lab --no-browser

So startet das Programm einfach und zeigt eine URL mit einem Token an. Kopieren Sie diese URL und fügen Sie sie in Ihren lokalen oder Remote-Browser ein, um die Verbindung herzustellen.

Portwechsel (falls Port 8888 belegt ist)

Falls es zu einem klassischen Portkonflikt mit Port 8888 kommt (beispielsweise, weil bereits ein anderer Jupyter-Server läuft), geben Sie manuell einen anderen Port an:

jupyter lab --port 8890

Dies ist praktisch, wenn man mehrere Projekte gleichzeitig betreut oder Server mit begrenzter Portverfügbarkeit verwendet.

Überprüfung, ob Jupyter-Server bereits laufen

Falls es zu Problemen kommt oder Browser keine Verbindung herstellen können, überprüfen Sie die Serveraktivität mit folgendem Befehl:

jupyter server list

Hier werden alle aktiven Sitzungen, ihre URLs und Ordner angezeigt. Um eine Sitzung zu beenden, geben Sie einfach Folgendes ein:

jupyter server stop 8888

Oder Sie beenden den Vorgang im selben Terminal, in dem Sie ihn begonnen haben, indem Sie einfach Strg + C drücken und die Abfrage gegebenenfalls bestätigen. Manchmal verirren sich mehrere Server in den Prozess; dieser Befehl behebt das Problem.

Erstellen Ihres ersten Notebooks nach dem Start von Jupyter

Sobald Jupyter läuft (oder JupyterLab in Ihrem Browser geöffnet ist), suchen Sie die Startseite. Klicken Sie auf das Python-Symbol, geben Sie Ihrem Notebook einen Namen – zum Beispiel mein_erstes.ipynb – und beginnen Sie mit der Eingabe:

print("Hello, Jupyter!")

Führen Sie die Zelle aus (Umschalt + Eingabe).Sie sollte sofort ausgeführt werden. Speichern Sie sie unter einem aussagekräftigen Namen – sonst vergessen Sie später worum es geht.

Behebung häufiger Probleme

Fehlermeldung „Jupyter wird nicht erkannt“?

Das bedeutet in der Regel, dass sich der Python-Skriptordner nicht in Ihrem PATH befindet oder Sie Ihre Umgebung nicht zuvor aktiviert haben. Führen Sie Folgendes durch:

where jupyter

oder unter macOS/Linux:

which jupyter

Falls es nicht auf einen Ort innerhalb Ihrer virtuellen Umgebung verweist, versuchen Sie, Jupyter erneut zu aktivieren oder neu zu installieren:

py -m pip install --upgrade jupyterlab

Der Browser öffnet sich nicht oder Jupyter startet im falschen Ordner?

Überprüfen Sie Ihr Verzeichnis. Stellen Sie sicher, dass Sie sich im richtigen Projektordner befinden. Verwenden Sie gegebenenfalls die Option `–notebook-dir`. Kopieren Sie außerdem die URL aus dem Terminal, falls sich die Seite nicht automatisch öffnet. Manchmal weigert sich Windows oder Ihr Browser einfach, automatisch zu starten.

Portkonflikte oder „ModuleNotFoundError“ in Notebooks?

Bei Portkonflikten wählen Sie mit `–port` einen neuen Port. Falls Python-Module fehlen, aktivieren Sie dieselbe Umgebung, die Sie für Jupyter verwendet haben, und installieren Sie die fehlenden Module (z. B.pandas) mit `pip install`.Bei mehreren Umgebungen müssen Sie den Kernel möglicherweise explizit installieren.

python -m ipykernel install --user --name=your-env --display-name "Python (your-env)"

Einfach nur seltsame Dinge, die in verschiedenen Konfigurationen ähnlich sind. Normalerweise besteht der Trick darin, sicherzustellen, dass sowohl die Kommandozeile als auch der Jupyter-Kernel auf dieselbe Umgebung verweisen.

Zusammenfassung

Jupyter einzurichten ist gar nicht so schwer, sobald die anfänglichen Hürden überwunden sind. Denken Sie daran, für jedes Projekt einen eigenen Ordner anzulegen, virtuelle Umgebungen zu verwenden und im richtigen Verzeichnis zu beginnen, um Verwirrung zu vermeiden. Danach benötigen Sie nur noch wenige Befehle und etwas Geduld. Hoffentlich hilft das allen, die es satt haben, sich wie Anfänger damit herumzuquälen.

Zusammenfassung

• Überprüfen Sie die installierte Python-Version mit `py –version` oder `python3 –version`.
• Erstellen und Aktivieren einer virtuellen Umgebung
• Installieren Sie JupyterLab oder Notebook in dieser Umgebung
• Starten Sie das Programm aus dem richtigen Verzeichnis oder geben Sie einen Arbeitsordner an.
• Verwenden Sie den richtigen Port, falls Port 8888 belegt ist.
• Überprüfen Sie die laufenden Server mit `jupyter server list`
• Schalten Sie gegebenenfalls verbliebene Server aus.
• Erstellen und starten Sie Ihr erstes Notebook – einfache Dinge funktionieren