Jupyverse

A set of FPS modules implementing a Jupyter server.

Try it online:

• JupyterLab frontend:
• Jupyter Notebook frontend:

Documentation is available here.

Install

From PyPI

Jupyverse can be installed with pip, for instance the following:

pip install "jupyverse[jupyterlab,auth]"

will install jupyverse with the JupyterLab frontend and the auth plugin.

From conda-forge

Jupyverse can be installed with micromamba:

micromamba create -n jupyverse
micromamba activate jupyverse
micromamba install jupyverse fps-jupyterlab fps-auth

Development install

Clone or fork this repository:

git clone https://github.com/jupyter-server/jupyverse.git
cd jupyverse

Use uv to install all plugins:

uv venv
uv pip install --group test -e ".[ \
    jupyterlab, \
    notebook, \
    auth, \
    auth-fief, \
    auth-jupyterhub, \
    noauth, \
    file-watcher-poll, \
    kernel-web-worker, \
    resource-usage, \
    webdav \
]"

Run tests with:

uv run pytest -v

For testing, all the plugins are installed in the same environment. Jupyverse will automatically start all plugins registered in the jupyverse.modules entry point. Some of them should be disabled, for instance there should be only one authentication plugin:

uv run jupyverse \
    --disable auth_fief \
    --disable auth_jupyterhub \
    --disable noauth \
    --disable file_watcher_poll \
    --disable notebook