How to Run a Jupyter Notebook with uv

When working with Jupyter notebooks, you should run them in isolated environments to prevent dependency conflicts. uv provides several streamlined ways to do this.

Using Jupyter with uv’s Isolated Environments

To launch a Jupyter notebook with specific dependencies using uv:

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

This single command:

1. Creates a temporary environment
2. Installs Jupyter and your specified dependencies
3. Launches Jupyter Lab ready to use

No activation steps are required! If you’re working within a project, uv will automatically incorporate your project’s dependencies.

Creating a Project-Specific Environment

For a more persistent setup:

# Create a new project directory
mkdir jupyter-project
cd jupyter-project

# Initialize a project
uv init --bare

# Add Jupyter and other dependencies
uv add --dev jupyter matplotlib pandas numpy

Then launch Jupyter within your project:

uv run jupyter lab