jupyterlab-workshop
Guided, interactive workshops inside JupyterLab.
Teaching in JupyterLab usually means a notebook with explanation between the code cells. Learners read down it pressing Run, everything has to be a cell in one language, and nothing can tell whether a step was done. This extension separates the instructions from the work: they live in a side panel, one page at a time, and each step is a clickable action that does something real in the JupyterLab session beside it, in a terminal, the editor, a notebook, a kernel or the interface itself. Workshops can check what the learner has done, ask questions, collect values, hold pages until requirements are met, and snapshot the working directory, and the subject can be anything JupyterLab can host, including JupyterLab itself.
A workshop is a directory with a workshop.yaml manifest and Markdown
pages. The format is text based and git friendly. A workshop runs
wherever JupyterLab runs, and can be handed to learners through a
published collection, a Binder link, a container image, or a static
JupyterLite site that runs entirely in the browser.
Install
The quickest way in is as a tool, which gives you a jupyter-workshop
command with JupyterLab, the extension and a Python kernel in an
environment of its own, and then to start your workshop library:
uv tool install "jupyterlab-workshop[lab]"
jupyter-workshop library
That opens JupyterLab on your
workshop library,
~/Workshops unless you say otherwise, creating it the first time. The
library is one place for everything you have in the way of workshops:
the ones you install from published collections, kept by collection;
the ones you make for yourself; the courses you write to publish for
others; your subscriptions, which belong to the library rather than to
your JupyterLab settings; and a
learning journal,
the record of what you install, start, finish and make, kept as files
you can open and read. To try it without installing anything:
uvx --from "jupyterlab-workshop[lab]" jupyter-workshop library
If you use Claude, add the ai extra, here in the form that runs
straight away without installing, or to the tool install above:
uvx --from "jupyterlab-workshop[lab,ai]" jupyter-workshop library
With it a library offers two AI agents inside JupyterLab, working under
the Claude Code login on your machine or an ANTHROPIC_API_KEY.
Workshop Author
writes workshops for you to learn from and designs courses with you.
The mentor
learns who you are as a learner in a few questions, keeps a profile in
your journal that Workshop Author then writes for, reads the journal to
see how you have been getting on, and can have a workshop made for you.
Nothing in the journal leaves your machine unless you talk to an agent.
The package is also a prebuilt JupyterLab 4 extension with its server extension, so in a project of your own it installs alongside JupyterLab:
uv add jupyterlab jupyterlab-workshop
or the pip equivalent, and the commands above run as jupyter workshop.
Getting started
walks through the setup, runs an example workshop and scaffolds one of
your own; the jupyter workshop command lints, self-tests and publishes
workshops, and author mode in JupyterLab edits them in place.
Learn more
-
Launch the showcase on Binder: three short workshops that show what the extension does and why, in a full JupyterLab with a real terminal, from the showcase repository that is also the pattern for publishing a collection of your own. Or try the demo: the Hello JupyterLab example running in JupyterLite, started afresh on every visit.
-
How workshops work and the tutorial, which writes a small workshop from nothing and publishes it.
-
Using workshops for learners and Deploying workshops for Binder, containers, JupyterHub and locked-down images.
-
The documentation for the rest: every action a page can use, checks and forms, variables, layouts, platforms, JupyterLite, publishing, trust, the manifest and settings references, the command line and authoring in JupyterLab.
-
Source, issues and contributing: see
CONTRIBUTING.mdin the repository for the development setup.
Developed with AI
This package was developed with the help of AI coding assistants, working to the author's design and direction, with the author reviewing what they produce. If you would rather not use software produced that way, that is understood, and this package is not for you.
License
Apache License 2.0.
1 maintainer
Metadata
1 maintainer
Release files for jupyterlab-workshop 0.30.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| jupyterlab_workshop-0.30.0.tar.gz | 1.7 MB | With provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| jupyterlab_workshop-0.30.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 2.4 MB
Release files / jupyterlab_workshop-0.30.0.tar.gz
| Download URL | jupyterlab_workshop-0.30.0.tar.gz |
|---|---|
| Size | 1.7 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
829c77fd419a363d0e49df1d964b72ab15214868b0e96c69995dc574b59d3d47
|
|
BLAKE2b-256 checksum How to use checksums |
d868b6942accc6900b1698cbaacdc31c3c5a8782eff2572cc747effa4344a942
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 10, 2026.
Transparency logRelease files / jupyterlab_workshop-0.30.0-py3-none-any.whl
| Download URL | jupyterlab_workshop-0.30.0-py3-none-any.whl |
|---|---|
| Size | 734.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
d5c8e877c4ca198c0bc350aa09760f78c647992c9299b54753c5c9529fcf48a9
|
|
BLAKE2b-256 checksum How to use checksums |
ee2e3abb05943ed685142ec8af8eaff0f08d77670a11e829c303fdd5663f1e55
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 10, 2026.
Transparency logSecurity for jupyterlab-workshop 0.30.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
All 2 files in this release have been uploaded with provenance metadata.
Attestation for jupyterlab_workshop-0.30.0.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 10, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
