NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI, #323 most downloaded on PyPI
Jupyter protocol implementation and client libraries
Latest stable
8.10.0
Last release 2 months ago
28 Aug 2026
Release timing varies
gaps range from 2 weeks to 1.2 years
Nearly every release is documented
notes for 59 of the last 60 stable releases
3 versions withdrawn
withdrawn after publishing
11 years old
100 releases · first in 2015
Drag across the ruler to compare, or tap a release to open it.
Nothing published for this version
Nothing published for this version
Yanked (PyPI) and marked as broken (conda)
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Yanked (PyPI) and marked as broken (conda)
Shutdown request sequence has been modified to be more graceful, it now is preceded by interrupt, and will also send a SIGTERM before forcibly killing
SIGTERM before
forcibly killing the kernel. #620ipython_genutils as a dependency. It was implicit
before; but required by at least traitlets thus avoiding issues. We
are working on completely removing it from all jupyter dependencies;
as it might lead to issues packaging for Python 3.10, and was mostly
used for compatibility with python 2. (#620, #605)shutdown_kernel and restarter.
(#607.)See the full list of pull-requests
Move jedi pinning to test requirements #599
Add change parameter needed for observer method of kernel_spec_manager trait #598
- Pin jedi\<=0.17.2 #596
Fix path to the connection file #568
Nothing published for this version
Removed warnings in more cases for KernelManagers that use new cleanup method #560
Gracefully Close ZMQ Context upon kernel shutdown to fix memory leak #548
Add AsyncKernelClient client_class to AsyncKernelManager #542
Fixed a bug causing clients to sometimes hang after a stop call was made #536
Subprocess kill action fix for async execution #535
This release includes support for asyncio patterns! Downstream tools should soon have releases to additionally support async patterns.
This release includes support for asyncio patterns! Downstream tools should soon have releases to additionally support async patterns.
The git history had to be reworked heavily in merging 5.x and master, so a link to all the changes at once in github had been left out as it's just co
The git history had to be reworked heavily in merging 5.x and master, so a link to all the changes at once in github had been left out as it's just confusing.
An exciting change in this release is some async support (huge thanks to @davidbrochart for doing most of the work)! See linked PR below for more details, we're working on integrating this into nbclient as well in the near future.
New Features:
Changes:
Fixes:
Docs:
Breaking changes:
Backported memory leak fix #548 #555.
Changed secure_write to be imported from jupyter_core with fix for extended usernames in Windows #483.
Fixed issue with non-english windows permissions #478. Potential issue still open in use with jupyerlab.
Important files creation now checks umask permissions #469.
Fix bug with control channel socket introduced in 5.3.0 #456.
Multiprocessing and Threading support #437 and #450
Prevent creating new console windows on Windows #346
Fix errors when using deprecated .KernelManager.kernel_cmd (#343, #344).
Fix .KernelSpecManager.get_all_specs method in subclasses that only override .KernelSpecManager.find_kernel_specs and .KernelSpecManager.get_kernel_sp
.KernelSpecManager.get_all_specs method in subclasses that only override
.KernelSpecManager.find_kernel_specs and
.KernelSpecManager.get_kernel_spec.
See #338 and
#339.Add parenthesis to conditional pytest requirement to work around a bug in the wheel package, that generate a .whl which otherwise always depends on py
Define Jupyter protocol version 5.3:
kernelspecs and
msging_interrupt
#294.jupyter kernel command to launch an installed kernel by name
#240.python3 or
python3.6---matching the version jupyter_client is running
on---are now launched with the same Python executable as the
launching process #306. This
extends the special handling of python added in 5.0.{resource_dir}, which will be substituted with the kernelspec
resource directory path when the kernel is launched
#289.metadata field to hold arbitrary
metadata about kernels---see kernelspecs #274.KernelRestarter class used by a KernelManager
configurable #290..KernelSpecManager.get_kernel_spec #311..KernelSpecManager.get_all_specs
will no longer raise an exception on encountering an invalid
kernel.json file. It will raise a warning and continue
#310.Define Jupyter protocol version 5.2, resolving ambiguity of cursor_pos field in the presence of unicode surrogate pairs.
Define Jupyter protocol version 5.2, resolving ambiguity of
cursor_pos field in the presence of unicode surrogate pairs.
::: {.seealso}
cursor_pos_unicode_note
:::
Add Session.clone for making a copy
of a Session object without sharing the digest history. Reusing a
single Session object to connect multiple sockets to the same IOPub
peer can cause digest collisions.
Avoid global references preventing garbage collection of background threads.
Nothing published for this version
Update internal protocol version number to 5.1, which should have been done in 5.0.0.
New features:
Implement Jupyter protocol version 5.1.
Introduce jupyter run command
for running scripts with a kernel, for instance:
jupyter run --kernel python3 myscript.py
New method
.BlockingKernelClient.execute_interactive for running code and capturing or redisplaying its
output.
New KernelManager.shutdown_wait_time configurable for adjusting
the time for a kernel manager to wait after politely requesting
shutdown before it resorts to forceful termination.
Fixes:
jupyter_client.launcher.launch_kernel passes through additional options to the underlying
Popen, matching KernelManager.start_kernel.buffers argument in
.Session.send, so that TypeErrors
are raised immediately, rather than in the eventloop.Changes:
python (as opposed
to an absolute path), sys.executable will be used rather than
resolving python on PATH. This should enable Python-based kernels
to install kernelspecs as part of wheels.Backward-incompatible changes:
.datetime objects returned in
parsed messages are now always timezone-aware. Timestamps in
messages without timezone info are interpreted as the local
timezone, as this was the behavior in earlier versions.Add .KernelClient.load_connection_info on KernelClient, etc. for loading connection info directly from a dict, not just from files.
.KernelClient.load_connection_info on KernelClient, etc. for loading connection info
directly from a dict, not just from files.Adds --sys-prefix argument to jupyter kernelspec install, for better symmetry with jupyter nbextension install, etc.
--sys-prefix argument to
jupyter kernelspec install, for
better symmetry with jupyter nbextension install, etc.Nothing published for this version
Nothing published for this version
Another fix for the start_new_kernel issue in 4.2.1 affecting slow-starting kernels.
start_new_kernel issue in 4.2.1 affecting slow-starting kernels.start_new_kernel to fail while waiting for kernels to become available.jupyter kernelspec remove
for removing kernelspecsenv
argumentname field to connection files identifying the kernelspec
name, so that consumers of connection files (alternate frontends)
can identify the kernelspec in useKernelSpecManager.get_all_specs for getting all kernelspecs more efficientlyNothing published for this version
Setuptools fixes for jupyter kernelspec
Highlights:
jupyter kernelspecjupyter kernelspec list includes pathsKernelManager.blocking_clientcomm_info requests from upcoming 5.1
release of the protocolThe first release of Jupyter Client as its own package.
The first release of Jupyter Client as its own package.
Nothing published for this version
One column per quarter.