{"id":544,"library":"notebook","title":"Jupyter Notebook","description":"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.","status":"active","version":"7.5.5","language":"python","source_language":"en","source_url":"https://github.com/jupyter/notebook","tags":["jupyter","notebook","interactive computing","web application","data science","python"],"install":[{"cmd":"pip install notebook","lang":"bash","label":"Install stable version"}],"dependencies":[{"reason":"Notebook v7 uses jupyter-server (>=2.0.0) for its Python backend.","package":"jupyter-server","optional":false},{"reason":"Notebook v7's frontend is built upon JupyterLab (>=4.0.0,<5) components.","package":"jupyterlab","optional":false},{"reason":"Required for managing kernel connections.","package":"jupyter-client","optional":false},{"reason":"Essential for running Python code within a Jupyter Notebook. While not a direct dependency of the 'notebook' package itself, it's a fundamental runtime dependency for Python users.","package":"ipykernel","optional":true}],"imports":[],"quickstart":{"code":"# 1. Start the Jupyter Notebook server from your terminal:\n# Navigate to your desired working directory first.\n# cd /path/to/your/notebooks\n# jupyter notebook\n\n# 2. Once the browser opens, click 'New' -> 'Python 3' to create a new notebook.\n# 3. In the first cell, type and run the following Python code:\n\nprint('Hello, Jupyter Notebook!')\n\n# Or a more complex example:\nimport pandas as pd\ndata = {'col1': [1, 2], 'col2': [3, 4]}\ndf = pd.DataFrame(data)\nprint(df)\n","lang":"bash","description":"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."},"warnings":[{"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.","message":"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.","severity":"breaking","affected_versions":"7.0.0 and above"},{"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.","message":"Classic Notebook extensions are not compatible with Notebook v7's new architecture. The extension system is now aligned with JupyterLab's.","severity":"gotcha","affected_versions":"7.0.0 and above"},{"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.","message":"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.","severity":"deprecated","affected_versions":"7.5.x and possibly future 7.x releases"},{"fix":"Be aware that configurations and extensions might affect both applications. For specific Notebook 6.x behavior, `nbclassic` offers the classic UI.","message":"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.","severity":"gotcha","affected_versions":"7.0.0 and above"},{"fix":"Install the missing package using pip: `pip install pandas` in the environment where the script or Jupyter Notebook is executed.","message":"The required 'pandas' module was not found in the environment. This indicates that the necessary third-party library has not been installed.","severity":"gotcha","affected_versions":"All versions (installation issue)"},{"fix":"Ensure all necessary Python packages (e.g., `pandas`) are listed in `requirements.txt` or explicitly installed using `pip install <package-name>` within the environment where your script runs.","message":"A `ModuleNotFoundError` indicates that a required Python package is not installed in the environment where the script is being executed.","severity":"gotcha","affected_versions":"all"}],"env_vars":null,"last_verified":"2026-04-11T05:51:27.385Z","next_check":"2026-06-26T00:00:00.000Z","problems":[{"fix":"Ensure the package is installed in the correct Python environment using `pip install some_module` or `conda install some_module`. If you have multiple Python versions, verify that Jupyter is using the environment where the package is installed. You may also need to restart the Jupyter kernel.","cause":"This error occurs when the Python interpreter in your Jupyter Notebook environment cannot find a module that you are trying to import. This often happens due to the module not being installed in the active environment or conflicts with multiple Python installations.","error":"ModuleNotFoundError: No module named 'some_module'"},{"fix":"Add the directory containing the Jupyter executable (often `~/.local/bin` on Linux/macOS or a `Scripts` folder within your Python installation on Windows) to your system's PATH environment variable. Alternatively, you can run Jupyter using `python -m notebook` or `python3 -m notebook`.","cause":"This error indicates that the 'jupyter' command (or 'jupyter-notebook') is not recognized by your system's command-line interpreter, typically because its installation path is not included in the system's PATH environment variable.","error":"jupyter: command not found"},{"fix":"First, try restarting the kernel from the Jupyter Notebook menu. If the issue persists, check your code for errors, monitor memory usage, update Jupyter and relevant packages (`pip install --upgrade jupyter`), or consider reinstalling `ipykernel` in your environment.","cause":"This error means the Python kernel, which executes your code, has crashed unexpectedly. Common causes include running out of memory, bugs in the code (e.g., infinite loops, syntax errors leading to crashes), conflicts between Python packages, or issues with an outdated or corrupted Jupyter installation.","error":"The kernel appears to have died. It will restart automatically."},{"fix":"First, ensure the Jupyter server is still running in your terminal; if not, restart it by running `jupyter notebook`. Try clearing your browser's cache or using a different browser. Temporarily disable any VPNs or internet security software. Verify that `localhost` or `127.0.0.1` are being used in the browser address bar.","cause":"This error occurs when the Jupyter frontend (your browser) cannot establish or maintain a connection with the Jupyter server process running on your machine. This can be caused by the server unexpectedly shutting down, network issues (like VPN interference), browser caching problems, or incorrect server configuration.","error":"A connection to the notebook server could not be established. The notebook will continue trying to reconnect. Check your network connection or notebook server configuration."}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":0,"quickstart_tag":"stale","pypi_latest":null,"quickstart_checks":{"last_tested":"2026-04-23","tag":"stale","tag_description":"widespread failures or data too old to trust","results":[{"runtime":"python:3.10-alpine","exit_code":1},{"runtime":"python:3.10-slim","exit_code":1},{"runtime":"python:3.11-alpine","exit_code":1},{"runtime":"python:3.11-slim","exit_code":1},{"runtime":"python:3.12-alpine","exit_code":1},{"runtime":"python:3.12-slim","exit_code":1},{"runtime":"python:3.13-alpine","exit_code":1},{"runtime":"python:3.13-slim","exit_code":1},{"runtime":"python:3.9-alpine","exit_code":1},{"runtime":"python:3.9-slim","exit_code":1}]}}