Jupyter Notebook

7.5.5 · active · verified Sat Mar 28

Jupyter Notebook is a web-based notebook environment for interactive computing, enabling users to create and share documents that contain live code, equations, visualizations, and narrative text. The current stable version is 7.5.5. Version 7 represents a significant architectural shift, building its frontend on JupyterLab components and its backend on Jupyter Server. The project maintains an active release cadence, with frequent patch updates and ongoing development towards future major versions.

Warnings

breaking Jupyter Notebook 7.0 introduced a completely re-architected application based on JupyterLab components and Jupyter Server. This breaks backward compatibility with extensions and configurations designed for Notebook 6.x and earlier versions.
Fix: Users migrating from Notebook 6.x must review their extensions and configurations. Many classic Notebook extensions are incompatible with v7; users should seek JupyterLab-compatible alternatives or explicitly install `nbclassic` for continued access to the classic Notebook interface.
gotcha Classic Notebook extensions are not compatible with Notebook v7's new architecture. The extension system is now aligned with JupyterLab's.
Fix: Check for JupyterLab-compatible versions of your extensions. Many popular extensions have been ported. If an extension is critical and not ported, consider using `nbclassic` (which provides the Notebook 6 UI on top of Jupyter Server) as a temporary solution.
deprecated Python 3.9 support is being phased out in testing/CI for Notebook 7.5.x, although the PyPI metadata currently lists Python 3.9 as supported.
Fix: It is recommended to use Python 3.10 or a newer supported Python version (3.11, 3.12, 3.13) to ensure full compatibility and receive the latest updates and security fixes.
gotcha The `jupyter notebook` command (for v7) shares its underlying server and extension system with JupyterLab. If both are installed, they can detect and enable each other's user experience.
Fix: Be aware that configurations and extensions might affect both applications. For specific Notebook 6.x behavior, `nbclassic` offers the classic UI.

Install

pip install notebook Install stable version

Quickstart

The primary way to use Jupyter Notebook is by launching its web-based server from the command line, which then opens in your default web browser. You interact with it directly in the browser. Direct Python imports from the `notebook` library to programmatically launch the UI are not a typical workflow; for programmatic interaction with kernels or notebook execution, `jupyter_client` or `nbclient`/`papermill` are often used.

# 1. Start the Jupyter Notebook server from your terminal:
# Navigate to your desired working directory first.
# cd /path/to/your/notebooks
# jupyter notebook

# 2. Once the browser opens, click 'New' -> 'Python 3' to create a new notebook.
# 3. In the first cell, type and run the following Python code:

print('Hello, Jupyter Notebook!')

# Or a more complex example:
import pandas as pd
data = {'col1': [1, 2], 'col2': [3, 4]}
df = pd.DataFrame(data)
print(df)

view raw JSON →