JupyterLab Desktop est l'application de bureau multiplateforme pour JupyterLab. Il s'agit du moyen le plus rapide et le plus simple de démarrer avec les blocs-notes Jupyter sur votre ordinateur personnel, avec la flexibilité nécessaire aux cas d'utilisation avancés.
Installez JupyterLab Desktop en utilisant l'une des méthodes répertoriées ci-dessous pour votre système.
Windows (10, 11) | Mac (macOS 10.15+) | Linux |
---|---|---|
Programme d'installation x64 | Installateur arm64 (silicium Apple) | Snap Store [recommandé] |
Programme d'installation x64 (puce Intel) | Programme d'installation .deb x64 (Debian, Ubuntu) | |
Programme d'installation .rpm x64 (Red Hat, Fedora, SUSE) |
De plus, JupyterLab Desktop peut être installé sur Windows via winget : winget install jupyterlab
.
Si vous devez supprimer une installation précédente de JupyterLab Desktop, veuillez suivre les instructions de désinstallation.
JupyterLab Desktop peut être lancé depuis l'interface graphique de votre système d'exploitation en cliquant sur l'icône de l'application ou en utilisant la commande jlab
depuis la ligne de commande. Le double-clic sur les fichiers .ipynb
est également pris en charge et lancera JupyterLab Desktop et chargera le fichier du bloc-notes.
JupyterLab Desktop définit le répertoire racine du navigateur de fichiers en fonction de la méthode de lancement.
S'il est lancé à partir de l'icône de l'application sur l'interface graphique ou à l'aide de la commande jlab
sans aucun argument, le répertoire de travail par défaut est défini comme répertoire racine. Le répertoire de travail par défaut est le répertoire personnel de l'utilisateur, mais il peut être personnalisé à partir de la boîte de dialogue Paramètres.
S'il est lancé en double-cliquant sur le fichier .ipynb
ou sur la commande jlab
avec un chemin de fichier comme argument, le répertoire parent du fichier est défini comme répertoire racine. De même, si un fichier est ouvert à l'aide des liens Open...
ou Open File...
dans la section Démarrer ou par glisser-déposer, le répertoire parent du fichier est défini comme répertoire racine.
Si la commande jlab
est utilisée avec un chemin de répertoire comme argument ou avec l'argument --working-dir
, alors le répertoire dans l'argument est défini comme répertoire racine. De même, si un dossier est ouvert à l'aide du lien Open Folder...
dans la section Démarrer ou par glisser-déposer, alors le répertoire ouvert est défini comme répertoire racine.
Les sessions représentent les lancements de projets locaux et les connexions aux serveurs JupyterLab existants. Chaque fenêtre de l'interface utilisateur JupyterLab de l'application est associée à une session distincte et les sessions peuvent être restaurées ultérieurement avec la même configuration.
Chaque lancement de JupyterLab dans un répertoire de travail différent est un projet distinct et les projets peuvent avoir leur propre configuration telle que l'environnement Python et la disposition de l'interface utilisateur.
Vous pouvez démarrer une nouvelle session en utilisant les liens dans la section Démarrer de la page de bienvenue.
New notebook...
crée un nouveau bloc-notes dans le répertoire de travail par défaut.
New session...
lance une nouvelle session JupyterLab dans le répertoire de travail par défaut.
Open...
démarre une nouvelle session JupyterLab dans le répertoire de travail sélectionné. Si des fichiers sont choisis, le répertoire parent des fichiers sélectionnés devient le répertoire de travail et les fichiers sélectionnés sont ouverts dans la session. Sous Windows et Linux, les options Open Folder...
et Open Files...
sont présentées comme des éléments distincts.
Connect...
crée une session en se connectant à un serveur JupyterLab existant exécuté localement ou à distance. Les serveurs JupyterLab exécutés localement sont automatiquement détectés et répertoriés dans la boîte de dialogue Connecter.
De même, les lancements CLI de l'application, la suppression des fichiers et des dossiers et le double-clic pour ouvrir les fichiers créent également de nouvelles sessions.
Les sessions précédemment ouvertes sont stockées dans les données de l'application et sont répertoriées sur la page de bienvenue. Cliquer sur un élément dans la liste Recent sessions
restaure la session sélectionnée.
Ouvrir des répertoires en utilisant un chemin relatif ou absolu
jlab .
lancer dans le répertoire courant
jlab ../notebooks
lancé avec un chemin relatif
jlab /Users/username/notebooks
se lance avec un chemin absolu
Ouvrir des blocs-notes et d'autres fichiers en utilisant un chemin relatif ou absolu
jlab /Users/username/notebooks/test.ipynb
lance le notebook avec un chemin absolu
jlab ../notebooks/test.ipynb
lance le notebook avec un chemin relatif
jlab ../test.py
lance le fichier python avec un chemin relatif
Ouvrir avec un environnement Python personnalisé
jlab --python-path /Users/username/custom_env/bin/python ../notebooks/test.ipynb
lance le notebook avec un environnement Python personnalisé
Connectez-vous au serveur JupyterLab existant
jlab https://example.org/lab?token=abcde
Consultez la documentation CLI pour plus de commandes et d’options CLI.
JupyterLab Desktop prend actuellement en charge les extensions prédéfinies conviviales. Les extensions source qui nécessitent une reconstruction ne sont pas prises en charge.
Voir le guide de l'utilisateur pour les options de configuration
Guide de gestion de l'environnement Python pour gérer les environnements Python sur votre système à l'aide de JupyterLab Desktop
Voir la documentation CLI pour les commandes et options CLI
Consultez le guide de dépannage pour résoudre les problèmes.
Pour contribuer, consultez la documentation du développeur