Hoe start je Jupyter Notebook via de commandoregel op Windows, Mac en Linux?

Jupyter Notebook is zo ongeveer de makkelijkste manier om Python-code te schrijven en direct uit te voeren. In plaats van een code-editor te openen en scripts handmatig uit te voeren, krijg je een overzichtelijke interface waarmee je kleine stukjes code – cellen – kunt uitvoeren, direct de resultaten kunt zien, grafieken kunt maken, aantekeningen kunt maken en alles in één bestand kunt opslaan. Het is ideaal voor het verkennen van data, het testen van codefragmenten of het uitvoeren van snelle experimenten zonder al te veel gedoe.

Maar als je er nieuw mee bent (of zelfs maar een beetje ervaring hebt), kan het starten van Jupyter via de commandoregel lastig zijn. Hoe start je het bijvoorbeeld na de installatie? Waarom opent het niet in je browser? Of waarom krijg je de melding “Jupyter wordt niet herkend”? Om de app soepel te laten starten, zijn er een paar instellingen nodig, met name ervoor zorgen dat Python en Jupyter correct zijn geïnstalleerd en toegankelijk zijn via je systeem-PATH. Zodra je die basisdingen voor elkaar hebt, is het starten van Jupyter een kwestie van een snel commando. Het is de moeite waard om het in een eigen virtuele omgeving te installeren, zodat het geen conflicten veroorzaakt met andere projecten. Weten hoe je de juiste poort kiest of in de juiste map opent, kan je later veel problemen besparen.

Hoe start je Jupyter Notebook en JupyterLab vanaf de commandoregel?

Controleer of Python is geïnstalleerd en toegankelijk is.

Als Python niet wordt herkend, werkt er natuurlijk ook niets anders. Open op Windows de opdrachtprompt of PowerShell en voer het volgende commando uit:

py --version

of

python --version

Als je een versienummer ziet (zoals Python 3.12), zit je goed. Zo niet, dan moet je Python installeren via de officiële website en ervoor zorgen dat het aan je systeem-PATH is toegevoegd. Op macOS/Linux voer je het volgende commando uit:

python3 --version

Als er een versie wordt weergegeven, prima. Dan kunt u aan de slag; zo niet, installeer dan Python 3 en zorg ervoor dat python3 in uw PATH staat, of gebruik de onderstaande commando’s om Jupyter in een gecontroleerde omgeving te installeren.

Hoe installeer je JupyterLab (of Notebook) in een virtuele omgeving?

Dit gedeelte is misschien wat saai, maar wel cruciaal. Door een virtuele omgeving in te stellen, blijven je Python-projecten gescheiden, zodat er geen rommel ontstaat met afhankelijkheden. Op Windows maak je er een aan zoals hieronder:

py -m venv jupyter-env

en activeer het:

• Voor de opdrachtprompt: jupyter-env\Scripts\activate
• Voor PowerShell: .\jupyter-env\Scripts\Activate.ps1

Zodra Pip is geactiveerd, is het raadzaam om het voor de zekerheid te upgraden.

py -m pip install --upgrade pip

Installeer nu Jupyter of JupyterLab:

py -m pip install jupyterlab

Als je liever de klassieke notebook-interface wilt, vervang dan ‘jupyterlab’ door ‘notebook’.

py -m pip install notebook

Hetzelfde geldt voor macOS/Linux, vervang de commando’s door python3 -m pip en gebruik waarschijnlijk source in plaats van scripts direct te activeren.

Jupyter starten vanuit de juiste map.

Start Jupyter niet zomaar vanuit je Downloads-map of C:\-schijf. Het is handiger om een ​​aparte map aan te maken, bijvoorbeeld in Documenten, en daar vervolgens naartoe te navigeren.

cd "%USERPROFILE%\Documents\Jupyter Notebooks"

of op macOS/Linux:

cd ~/Documents/jupyter-notebooks

Voer vervolgens het volgende uit:

jupyter lab

Als je het programma direct in een specifieke map wilt starten zonder gedoe met navigeren, gebruik dan de optie –notebook-dir als volgt:

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

of

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

Jupyter uitvoeren zonder automatisch een browser te openen.

Soms wil je Jupyter op een externe server of via SSH uitvoeren. Voeg daarvoor gewoon –no-browser toe aan het opstartcommando:

jupyter lab --no-browser

Op deze manier start het programma direct op en toont het een URL met een token. Kopieer en plak die URL in uw lokale of externe browser om verbinding te maken.

De poort wijzigen (voor het geval 8888 bezet is)

Als je tegen het klassieke poortconflict 8888 aanloopt (bijvoorbeeld omdat er al een andere Jupyter-instantie draait), geef dan handmatig een andere poort op:

jupyter lab --port 8890

Dit is handig wanneer je met meerdere projecten tegelijk werkt of servers gebruikt met een beperkt aantal beschikbare poorten.

Controleren of de Jupyter-servers al actief zijn

Als er problemen ontstaan ​​of browsers geen verbinding maken, controleer dan of er actieve servers zijn door het volgende commando uit te voeren:

jupyter server list

Hier ziet u alle actieve sessies, hun URL’s en mappen. Om een ​​sessie te beëindigen, typt u gewoon:

jupyter server stop 8888

Of, als je het proces vanuit dezelfde terminal stopt waar je het bent gestart, druk dan gewoon op Ctrl + C en bevestig indien gevraagd. Soms sluipen er meerdere servers binnen, en dit commando lost dat op.

Je eerste notitieboek aanmaken na het opstarten van Jupyter.

Zodra Jupyter is opgestart (of JupyterLab in je browser is geopend), zoek je de startpagina op. Klik op het Python-pictogram, geef je notebook een naam – bijvoorbeeld my_first.ipynb – en begin met typen:

print("Hello, Jupyter!")

Voer de cel uit (Shift + Enter).Deze zou direct moeten worden uitgevoerd. Sla het bestand op met een duidelijke naam; anders vergeet je later misschien wat wat is als je overal ‘Naamloos’ laat staan.

Veelvoorkomende problemen oplossen

Foutmelding “Jupyter wordt niet herkend”?

Dit betekent meestal dat de map ‘Scripts’ van Python niet in je PATH staat, of dat je je omgeving niet eerst hebt geactiveerd. Doe het volgende:

where jupyter

of op macOS/Linux:

which jupyter

Als het niet naar een locatie binnen uw virtuele omgeving verwijst, probeer dan Jupyter opnieuw te activeren of te installeren:

py -m pip install --upgrade jupyterlab

Opent de browser niet of start Jupyter in de verkeerde map?

Controleer je mapstructuur nogmaals. Zorg ervoor dat je in de juiste projectmap bent beland. Gebruik indien nodig de optie –notebook-dir. Kopieer ook de URL uit de terminal als het venster niet automatisch opent. Soms weigert Windows of je browser gewoon automatisch te starten…

Poortconflicten of een “ModuleNotFoundError” in notebooks?

Bij poortconflicten kunt u een nieuwe poort kiezen met –port. Als er Python-modules ontbreken, activeert u dezelfde omgeving die u voor Jupyter hebt gebruikt en installeert u vervolgens de ontbrekende modules (zoals pandas) met pip. Als u meerdere omgevingen hebt, moet u mogelijk de kernel expliciet installeren met:

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

Het zijn gewoon rare dingen die in verschillende configuraties terugkomen. Meestal is de truc ervoor te zorgen dat je commandoregel en je Jupyter-kernel naar dezelfde omgeving verwijzen.

Samenvatting

Het is niet zo moeilijk om Jupyter aan de praat te krijgen als je die eerste problemen eenmaal hebt opgelost. Vergeet niet om voor elk project een aparte map aan te maken, virtuele omgevingen te gebruiken en vanuit de juiste map te beginnen om verwarring te voorkomen. Daarna is het een kwestie van een paar commando’s en wat geduld. Hopelijk helpt dit iedereen die er als beginner mee worstelt.

Samenvatting

• Controleer welke versie van Python is geïnstalleerd met `py –version` of `python3 –version`.
• Een virtuele omgeving creëren en activeren.
• Installeer JupyterLab of Notebook in die omgeving.
• Start het programma vanuit de juiste map of geef een werkmap op.
• Gebruik de juiste poort als poort 8888 bezet is.
• Controleer de actieve servers met `jupyter server list`.
• Verwijder indien nodig de overgebleven servers.
• Maak en voer je eerste notebook uit – simpele dingen werken al.