NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI, #300 most downloaded on PyPI
Jupyter core package. A base package on which Jupyter projects rely.
Latest stable
5.9.1
Last release 1 years ago
16 Oct 2025
Ships unpredictably
gaps range from 8 days to 1.2 years
Most releases are documented
notes for 35 of 52 stable releases
2 versions withdrawn
withdrawn after publishing
11 years old
64 releases · first in 2015
Drag across the ruler to compare, or tap a release to open it.
Fixes a regression in 5.9.0 only affecting Windows
Fixes a regression in 5.9.0 only affecting Windows
filterwarnings() TypeError #449 (@Darshan808)<!-- END SILENT CHANGELOG ENTRY -->
<!-- <END NEW CHANGELOG ENTRY> -->
Your coding agent can read these notes before it upgrades. Set up the MCP server →
remove deprecation warning, platformdirs won't become default #447 ( @minrk )
jupyter-core 5.9 requires Python 3.10.
The dependency on pywin32 on WIndows is removed, unblocking installation on free-threaded Python.
f specifier in f-string used to print config file path #433 (@krassowski)(GitHub contributors page for this release)
@AThePeanut4 | @Carreau | @dependabot | @krassowski | @minrk | @nikimagic | @stonebig
Fixes a regression in 5.8.0 for code which may assume SYSTEM_CONFIG_PATH is non-empty (Jupyter Server).
Fixes a regression in 5.8.0 for code which may assume SYSTEM_CONFIG_PATH is non-empty (Jupyter Server).
<!-- END SILENT CHANGELOG ENTRY -->
<!-- START SILENT CHANGELOG ENTRY -->
Fixes CVE-2025-30167 / GHSA-33p9-3p43-82vq on Windows (advisory to be published 2025-06-02)
(GitHub contributors page for this release)
@blink1073 | @Carreau | @dependabot | @hugokerstens | @minrk | @krassowski
Maintenance and upkeep improvements
Derive JupyterAsyncApp from JupyterApp #389 ( @blink1073 )
Modernize event loop behavior #387 ( @blink1073 )
Fix export of package version #386 ( @blink1073 )
Enable async JupyterApp #381 ( @blink1073 )
Account for read only file systems in migration #379 ( @blink1073 )
Fix typing for traitlets 5.13 #372 (@blink1073)
Add python 3.12 support #367 (@blink1073)
Fix event loop handling #362 (@blink1073)
Better handling of config migration #356 (@smartass101)
(GitHub contributors page for this release)
@blink1073 | @davidbrochart | @jamescooke | @pre-commit-ci | @smartass101
Fix pywin32 version constraint #347 (@blink1073)
Set up shell command-line tab-completion for jupyter and subcommands #337 (@azjps)
MAINT: Don't format logs in log call. #336 (@Carreau)
Suppress any exception in \_do_i_own shortcut #335 (@minrk)
Clear the test environment before each function run #333 (@jasongrout)
Add spell check and ensure docstrings #327 (@blink1073)
Only prefer envs owned by the current user #323 (@minrk)
Add run_sync and ensure_async functions #315 (@davidbrochart)
…platform-specific directories. We raise a deprecation warning if the variable is not set. In version 6, JUPYTER_PLATFORM_DIRS will be opt-out. In vers…
We now make the assumption that if we are running in a virtual environment, we should prioritize the environment-level sys.prefix over the user-level paths. Users can opt out of this behavior by setting JUPYTER_PREFER_ENV_PATH, which takes precedence over our autodetection.
In version 5, we introduce a JUPYTER_PLATFORM_DIRS environment variable to opt in to using more appropriate platform-specific directories. We raise a deprecation warning if the variable is not set. In version 6, JUPYTER_PLATFORM_DIRS will be opt-out. In version 7, we will remove the environment variable checks and old directory logic.
We are dropping support for Python 3.7 ahead of its official end of life, to reduce maintenance burden as we add support for Python 3.11.
Contributing guide #289 (@jamesr66a)(GitHub contributors page for this release)
@blink1073 | @bollwyvl | @dependabot | @dlqqq | @gaborbernat | @gutow | @jamesr66a | @jaraco | @jasongrout | @kevin-bates | @maartenbreddels | @martinRenou | @meeseeksmachine | @pre-commit-ci
Nothing published for this version
Nothing published for this version
Try to detect if we are in a virtual environment and change path precedence accordingly by @jasongrout in https://github.com/jupyter/jupyter_core/pull
Contributing guide by @jamesr66a in https://github.com/jupyter/jupyter_core/pull/289Full Changelog: https://github.com/jupyter/jupyter_core/compare/4.11.1...5.0.0rc0
Nothing published for this version
Nothing published for this version
Fix inclusion of jupyter file and check in CI by @blink1073 in https://github.com/jupyter/jupyter_core/pull/276
Full Changelog: https://github.com/jupyter/jupyter_core/compare/4.11.0...4.11.1
Use hatch backend by @blink1073 in https://github.com/jupyter/jupyter_core/pull/265
Full Changelog: https://github.com/jupyter/jupyter_core/compare/4.10.0...4.11.0
Update changelog for 4.9.2 by @blink1073 in https://github.com/jupyter/jupyter_core/pull/252
jupyter_core by @jonringer in https://github.com/jupyter/jupyter_core/pull/253Full Changelog: https://github.com/jupyter/jupyter_core/compare/4.9.2...4.10.0
set proper sys.argv[0] for subcommand by @bnavigator in https://github.com/jupyter/jupyter_core/pull/248
Full Changelog: https://github.com/jupyter/jupyter_core/compare/4.9.1...4.9.2
Nothing published for this version
Nothing published for this version
Set proper sys.argv[0] for subcommand.
sys.argv[0] for subcommand. (#248)jupyter_config_dir - reorder home_dir initialization.
(#251)See the jupyter_core 4.9 milestone on GitHub for the full list of pull requests and issues closed.
site.ENABLE_USER_SITE is True. One way to
disable these directory additions is to set the PYTHONNOUSERSITE
environment variable. These locations can be customized by setting
the PYTHONUSERBASE environment variable. (#242)Nothing published for this version
Nothing published for this version
Nothing published for this version
jupyter_core 4.8.1 was released the same day as 4.8.0 and also included the fix below for the Windows tests. Unfortunately, the 4.8.1 release commit a
jupyter_core 4.8.1 was released the same day as 4.8.0 and also included the fix below for the Windows tests. Unfortunately, the 4.8.1 release commit and tag were not pushed to GitHub. We are releasing 4.8.2 so we have a commit and tag in version control.
See the jupyter_core 4.8 milestone on GitHub for the full list of pull requests and issues closed.
jupyter-core now has experimental support for PyPy (Python 3.7). Some features are known not to work due to limitations in PyPy, such as hidden file detection on Windows.
%APPDATA% on Windows
(#222)pywin32 package on PyPy
(#230)jupyter --version
(#232)--show-config from traitlets 5 (#233)Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Allow creating user to delete secure file
See the jupyter_core 4.7 milestone on GitHub for the full list of pull requests and issues closed.
JUPYTER_PREFER_ENV_PATH variable, which can be set to
switch the order of the environment-level path and the user-level
path in the Jupyter path hierarchy (e.g., jupyter --paths). It is
considered set if it is a value that is not one of 'no', 'n',
'off', 'false', '0', or '0.0' (case insensitive). If you are
running Jupyter in multiple virtual environments as the same user,
you will likely want to set this environment variable.jupyter --paths --debug now explains the environment variables
that affect the current path list.jupyter troubleshoot._version.version_info and _version.__version__ to follow
Python conventions.Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Deprecation warnings relative to _runtime_dir_changed are no longer produced (#158).
mock is now only required for testing on Python 2
(#157)._runtime_dir_changed are no
longer produced (#158).scripts directory relative to the current python environment
is now appended to the search directory for subcommands
(#162).exists(), is_hidden(), secure_write())
have been moved from jupyter_client and jupyter_server to
jupyter_core (#163).jupyter --version now tries to show the version number of various other installed Jupyter packages, not just jupyter_core (#136). This will hopefully
jupyter --version now tries to show the version number of various
other installed Jupyter packages, not just jupyter_core
(#136). This will hopefully make
it clearer that there are various packages with their own version
numbers.JUPYTER_CONFIG_PATH
environment variable to specify a search path of additional
locations for config (#139).jupyter subcommand no longer modifies the PATH environment variable when it runs
jupyter-subcommand (#148).XDG_RUNTIME_DIR
(#143). While it has some
attractive properties, it has led to various problems; see the pull
request for details.JupyterApp to respect the raise_config_file_errors traitlet
(#149).setup.py script now always uses setuptools, like most other
Jupyter projects (#147).jupyter troubleshoot gets the list of packages from the Python environment it's in, by using sys.executable to call pip list (#104).
jupyter troubleshoot gets the list of packages from the Python
environment it's in, by using sys.executable to call pip list
(#104).ensure_dir_exists, and switched to using it
over the one from ipython_genutils, which does permissions wrong
(#113).~/.ipython directory when checking if it exists
for config migration (#118).jupyter_core and build the
docs (#110).Add JUPYTER_NO_CONFIG environment variable for disabling all Jupyter configuration.
JUPYTER_NO_CONFIG environment variable for
disabling all Jupyter configuration.Nothing published for this version
Fix error message on Windows when subcommand not found.
jupyter troubleshoot on Windows.jupyter directory top
priority in search path for subcommands, so that
jupyter-subcommand next to
jupyter will always be picked if
present.shell=True for subcommand dispatch on Windows.Nothing published for this version
Include symlink directory and real location on subcommand PATH when jupyter is a symlink.
jupyter is a symlink.jupyter.py module, so that
python -m jupyter always works.jupyter troubleshoot command for displaying
environment info.jupyter executable is included when
dispatching subcommands.Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
One column per quarter.