Jupyter Notebook : créer et lancer son premier notebook

Un notebook Jupyter est un document interactif qui combine code, texte et résultats dans le navigateur : on écrit du code par petits blocs, on l'exécute, et le résultat s'affiche juste en dessous. C'est l'outil de référence pour apprendre Python, explorer des données et faire de la data science.

Ce guide montre comment installer Jupyter, lancer l'interface, créer votre premier notebook, exécuter des cellules de code et de texte, et sauvegarder le tout au format .ipynb. Public : débutants, aucune expérience requise.

Ce que vous allez apprendre

• Installer Jupyter dans un environnement Python propre.
• Lancer JupyterLab ou Jupyter Notebook.
• Créer et nommer un notebook.
• Exécuter des cellules de code et de Markdown.
• Comprendre le fichier .ipynb et le kernel.

Qu'est-ce qu'un notebook Jupyter ?

Un notebook est une suite de cellules. Chaque cellule contient soit du code, soit du texte (Markdown). On exécute les cellules une par une, et les résultats (valeurs, tableaux, graphiques) apparaissent immédiatement sous la cellule. Cette approche interactive permet d'avancer par étapes et de garder une trace de son raisonnement.

Le notebook est sauvegardé dans un fichier .ipynb : un fichier JSON qui contient le code, le texte, les résultats et des métadonnées. Il est portable et s'ouvre sur n'importe quel système équipé de Jupyter.

Installer Jupyter

Le plus propre est d'installer Jupyter dans un environnement isolé avec Conda, pour ne pas polluer votre Python système :

conda create -n data python=3.12 -y
conda activate data
conda install -c conda-forge jupyterlab notebook

Vérifiez l'installation :

jupyter --version

Vous obtenez les versions des composants installés :

IPython          : 9.15.0
jupyter_core     : 5.9.1
jupyter_server   : 2.20.0
jupyterlab       : 4.6.1
notebook         : 7.6.0

Anaconda inclut déjà Jupyter

Si vous préférez tout installer d'un coup, la distribution Anaconda embarque Python, Jupyter et les bibliothèques scientifiques. Attention toutefois à sa licence commerciale pour les grandes organisations ; Miniconda + conda-forge reste le choix libre et recommandé.

Lancer Jupyter

Deux interfaces existent. JupyterLab est l'interface moderne (onglets, explorateur, éditeur) ; Jupyter Notebook est la version classique, plus simple. Depuis votre environnement activé :

jupyter lab        # interface moderne, recommandée
# ou
jupyter notebook   # interface classique

Jupyter démarre un serveur local et ouvre votre navigateur sur http://localhost:8888. L'interface d'accueil ressemble à un explorateur de fichiers : vos dossiers à gauche, un bouton pour créer un notebook.

Créer et nommer un notebook

Cliquez sur New, puis sélectionnez Python 3 : un notebook vierge s'ouvre dans un nouvel onglet. Par défaut, il s'appelle Untitled. Cliquez sur ce nom pour le renommer, par exemple mon-premier-notebook. Jupyter sauvegarde automatiquement votre travail à intervalles réguliers.

Exécuter des cellules de code

Dans la première cellule, tapez du code Python, puis exécutez-le avec Shift + Entrée (ou le bouton Run) :

print("Bonjour depuis un notebook Jupyter")

Le résultat s'affiche immédiatement sous la cellule :

Les variables persistent entre les cellules

Le point fort de Jupyter : les variables restent en mémoire d'une cellule à l'autre, dans l'ordre où vous les exécutez. Une valeur calculée dans une cellule est réutilisable dans les suivantes :

a = 10
b = 5
resultat = a * b
print(f"Résultat : {resultat}")

# La variable resultat reste accessible ici
print(f"Le double vaut {resultat * 2}")

L'ordre d'exécution compte

Une cellule utilise les variables déjà exécutées, pas leur position dans le notebook. Si vous obtenez une erreur NameError, vérifiez que vous avez bien exécuté les cellules dans le bon ordre, ou redémarrez le kernel.

Créer un graphique

Jupyter affiche les graphiques directement dans le notebook. Avec matplotlib (à installer via conda install -c conda-forge matplotlib) :

import matplotlib.pyplot as plt

x = [1, 2, 3, 4, 5]
y = [2, 4, 6, 8, 10]

plt.plot(x, y, marker="o")
plt.title("Mon premier graphique")
plt.show()

Ajouter du texte avec Markdown

Un notebook ne contient pas que du code. Pour documenter votre démarche, créez une cellule, puis changez son type de Code à Markdown (raccourci M en mode commande). Vous y écrivez du texte formaté :

# Mon analyse

Ceci est une **cellule Markdown** pour expliquer mon travail.

## Objectifs
- Apprendre Jupyter
- Créer des graphiques

Après exécution (Shift + Entrée), le texte s'affiche mis en forme :

Le workflow efficace alterne Markdown (expliquer) et code (implémenter), pour construire un notebook lisible qui raconte une analyse.

Comprendre le kernel

Le kernel est le processus qui exécute votre code Python en arrière-plan. Quand une cellule reste bloquée sur [*] ou que l'interface ne répond plus, le kernel est occupé ou planté. Le menu Kernel permet de le reprendre en main :

• Interrupt : arrêter l'exécution en cours.
• Restart : redémarrer le kernel (les variables sont perdues).
• Restart & Clear Output : redémarrage complet, sorties effacées.

En cas de doute après beaucoup de modifications, redémarrer le kernel et réexécuter les cellules dans l'ordre repart sur une base saine.

Les raccourcis essentiels

Jupyter distingue le mode édition (on tape dans la cellule) du mode commande (la cellule est sélectionnée, bordure bleue). Les raccourcis les plus utiles :

Raccourci	Action
Shift + Entrée	Exécuter la cellule et passer à la suivante
Ctrl + Entrée	Exécuter sans changer de cellule
Échap puis A / B	Insérer une cellule au-dessus / en dessous
Échap puis M / Y	Convertir en Markdown / en Code
Échap puis D D	Supprimer la cellule

Glissez pour voir

Questions fréquentes

Comment installer Jupyter ?

Le plus propre est de créer un environnement Conda, puis d'y installer Jupyter : conda install -c conda-forge jupyterlab notebook. La distribution Anaconda l'inclut aussi d'office.

Comment lancer Jupyter Notebook ?

Depuis un terminal, dans l'environnement activé, tapez jupyter lab (interface moderne) ou jupyter notebook (interface classique). Jupyter s'ouvre dans le navigateur sur http://localhost:8888.

C'est quoi un fichier .ipynb ?

.ipynb est le format d'un notebook Jupyter : un fichier JSON qui contient le code, le texte, les résultats et les métadonnées. Il s'ouvre avec Jupyter, VS Code ou en ligne.

Jupyter Notebook ou JupyterLab ?

JupyterLab est l'interface moderne (onglets, explorateur, éditeur avancé) ; Jupyter Notebook est plus simple et épurée. Les deux ouvrent les mêmes fichiers .ipynb.

À retenir

1. Un notebook est une suite de cellules de code et de texte, exécutées une par une.
2. Installez Jupyter dans un environnement Conda isolé avec conda-forge.
3. jupyter lab ou jupyter notebook lancent l'interface sur localhost:8888.
4. Les variables persistent entre cellules selon l'ordre d'exécution ; en cas d'erreur, redémarrez le kernel.
5. Le fichier .ipynb stocke code, texte et résultats au format JSON, portable.

Prochaines étapes

Découvrir Jupyter Concepts, JupyterLab et kernels plus en détail.

Conda Gérer l'environnement Python de vos notebooks.

Machine Learning : les bases Utiliser un notebook pour entraîner un premier modèle.

×

📖 Voir la documentation →