How do I run a Jupyter notebook with uv?

Run `uv run --with jupyter jupyter lab` to launch Jupyter Lab in a temporary isolated environment. For a specific notebook file, run `uv run --with jupyter jupyter notebook my-notebook.ipynb`. uv creates the environment on-the-fly, installs Jupyter, and cleans up after you quit without affecting your project files.

How do I launch Jupyter Lab with uv?

Run `uv run --with jupyter --with pandas --with matplotlib jupyter lab`. uv creates a temporary environment, installs Jupyter and the listed dependencies, and starts Jupyter Lab in one step. No activation is required, and the temporary environment doesn't touch any project files.

How do I use uv add jupyter in a project?

Run `uv init --bare` to create a project, then `uv add --dev jupyter` to add Jupyter as a dev dependency. Launch with `uv run jupyter lab`. This creates a persistent, reproducible Jupyter environment tracked in `uv.lock`, so anyone who clones the project gets the same setup after `uv sync`.

Can I run Jupyter without adding it to my project's dependencies?

Yes. Use `uv run --with jupyter jupyter lab` to spin up an ephemeral environment for the session. The packages live in uv's cache and never get written to `pyproject.toml` or `uv.lock`. This is ideal for one-off notebooks where you don't want to commit Jupyter as a project dependency.

How do I make Jupyter persistent in a uv project?

Run `uv init --bare`, then `uv add --dev jupyter matplotlib pandas numpy` to track Jupyter and its companions under dev dependencies. Launch with `uv run jupyter lab`. The lockfile pins exact versions, so anyone who clones the project gets the same notebook environment after `uv sync`.

How to Run a Jupyter Notebook with uv

by Tim Hopper · Markdown

uv Scientific Python verified with uv 0.12

uv gives two ways to run Jupyter: a temporary environment for one-off sessions, or a project-tracked environment for reproducible notebooks.

Launch Jupyter in a temporary environment

uv run --with jupyter --with pandas --with matplotlib jupyter lab

uv creates an isolated environment, installs Jupyter and the listed packages, and starts Jupyter Lab. No activation needed. Inside a project directory, uv includes your project dependencies automatically.

Add Jupyter to a project

uv init --bare
uv add --dev jupyter matplotlib pandas numpy
uv run jupyter lab

The --dev flag marks Jupyter as a development dependency , keeping it out of production installs. The lockfile pins exact versions, so anyone cloning the project runs uv sync to get the same environment.

If a notebook cell raises ModuleNotFoundError for a package you installed, the kernel may be running in a different environment. How to fix ModuleNotFoundError: no module named X shows how to diagnose from inside a cell.

Last updated on August 24, 2026

How to require a virtualenv when installing packages with pip?How to Run a Python REPL with uv

Please submit corrections and feedback...