A little wrapper around `uv` to launch ephemeral Jupyter notebooks.
Project description
juv
A little wrapper around uv to launch ephemeral Jupyter notebooks.
uvx juv
# A wrapper around uv to launch ephemeral Jupyter notebooks.
#
# Usage: juv [uvx flags] <COMMAND>[@version] [PATH]
#
# Commands:
# lab: Launch JupyterLab
# notebook: Launch Jupyter Notebook
# nbclassic: Launch Jupyter Notebook Classic
#
# Examples:
# uvx juv lab script.py
# uvx juv nbclassic script.py
# uvx juv notebook existing_notebook.ipynb
# uvx juv --python=3.8 notebook@6.4.0 script.ipynb
juv has three main commands:
juv lablaunches a Jupyter Lab sessionjuv notebooklaunches a classic notebook sessionjuv nbclassiclaunches a classic notebook session
These commands accept a single argument: the path to the notebook or script to launch. A script will be converted to a notebook before launching.
uvx juv lab script.py # creates script.ipynb
Any flags that are passed prior to the command (e.g., uvx juv --with=polars lab) will be forwarded to uvx as-is. This allows you to specify additional
dependencies, a different interpreter, etc.
what
PEP 723 (inline script metadata) allows
specifying dependencies as comments within Python scripts, enabling
self-contained, reproducible execution. This feature could significantly
improve reproducibility in the data science ecosystem, since many analyses are
shared as standalone code (not packages). However, a lot of data science code
lives in notebooks (.ipynb files), not Python scripts (.py files).
juv bridges this gap by:
- Extending PEP 723-style metadata support from
uvto Jupyter notebooks - Launching Jupyter sessions with the specified dependencies
It's a simple Python script that parses the notebook and starts a Jupyter
session with the specified dependencies (piggybacking on uv's existing
functionality).
alternatives
juv is opinionated and might not suit your preferences. That's ok! uv is
super extensible, and I recommend reading the wonderful
documentation to learn about its primitives.
For example, you can achieve a similar workflow using the --with-requirements
flag:
uvx --with-requirements=requirements.txt --from=jupyter-core --with=jupyterlab jupyter lab notebook.ipynb
While slightly more verbose and breaking self-containment, this approach totally works and saves you from installing another dependency.
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file juv-0.1.0.tar.gz.
File metadata
- Download URL: juv-0.1.0.tar.gz
- Upload date:
- Size: 15.6 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/5.1.1 CPython/3.12.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 00f2e3799d33bc5509aa5c661ba3da4af715c51f3ebf544b5f74b028c7227459 |
|
| MD5 | ff82824c82dbbb67c5a504e0d97c9a6b |
|
| BLAKE2b-256 | 4bb240cb238a9106f2dbce57137140185fbbd418bd885fdc3ff11110de47789d |
File details
Details for the file juv-0.1.0-py3-none-any.whl.
File metadata
- Download URL: juv-0.1.0-py3-none-any.whl
- Upload date:
- Size: 5.6 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/5.1.1 CPython/3.12.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | e4ca3edfd206005ccaf3129a7fcd06549609e62eda40e15b956e32d9c761118d |
|
| MD5 | 85fecb0580a4561b729ea0ea23ad55d9 |
|
| BLAKE2b-256 | 1a1c6ebf5e49c87e204dab3d479dcb49afe3d518dcba7739f1a8a3b98f328792 |
