async-kernel

pypi downloads CI Ruff uv basedpyright - checked Built with Material for MkDocs codecov

logo-svg

async-kernel is a Python kernel for Jupyter that provides concurrent message handling via an asynchronous backend (asyncio or trio).

The kernel provides two external interfaces:

  1. Direct ZMQ socket messaging via a configuration file and kernel spec - (Jupyter, VS Code, etc).
  2. An experimental callback style interface (Jupyterlite).

Highlights

Avoid deadlocks

The standard (synchronous) kernel implementation processes messages sequentially irrespective of the message type. The problem being that long running execute requests make the kernel non-responsive.

Another problem exists when an asynchronous execute request awaits a result that is delivered via a kernel message - this will cause a deadlock because the message will be stuck in the queue behind the blocking execute request4.

async-kernel handles messages according to the channel and message type. So widget com message will get processed in a separate queue to an execute request. Further detail is given in the concurrency notebook, a Jupyterlite version is available here.

Example

Make a blocking call in a Jupyter lab notebook or console.

# Make the shell's thread busy
import time

time.sleep(1e6)

While the above is blocking (the kernel is busy).

dir()  # try code completion (tab) or view the docstring (shift tab)

Interrupt the kernel.

It also works for awaitables.

import ipywidgets as ipw
from aiologic import Event

b = ipw.Button(description="Click me")
event = Event()
b.on_click(lambda _: event.set())
display(b)
await event

Installation

pip install async-kernel

Kernelspecs

A kernelspec with the name 'async' is added when async-kernel is installed.

Kernel specs can be installed/uninstalled via the command line.

async-kernel install

# To install for a user
async-kernel install --user

For further detail about kernel spec customisation see command line and kernel configuration and custom kernel.ipynb.

Faster data serialization

orjson (a fast JSON library) is supported and will be used by default if it has been installed.

Free-threading support

async-kernel's Caller's are thread-local and it's methods are internally synchronised5.

Origin

async-kernel started as a fork of IPyKernel. Thank you to the original contributors of IPyKernel that made async-kernel possible.

  1. A gui (host) enabled kernel interface starts a gui's mainloop (host) which starts the backend as a guest, then finally the Kernel is started. ↩

  2. The asyncio implementation of start_guest_run was written by the author of aiologic and provided as a gist. ↩ ↩2

  3. trio's start_guest_run. ↩ ↩2

  4. IPyKernel solves this issue specifically for widgets by using the concept of 'widget coms over subshells'. Widget messages arrive in a different thread which on occasion can cause unexpected behaviour, especially when using asynchronous libraries. ↩

  5. free threading terminology ↩

Project links

Data verified by PyPI on Jul 19, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (0.22.3)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for fleming79 from gravatar.com fleming79

Credits

Author: Alan Fleming

GitHub Statistics

Data verified by PyPI on Jul 19, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License expression

MIT
View SPDX License List

Requires

Python >=3.11

Tags

Interactive Interpreter Jupyter Shell Web

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

async_kernel-0.21.0.tar.gz (333.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

async_kernel-0.21.0-py3-none-any.whl (122.5 kB view details)

Uploaded Python 3

File details

Details for the file async_kernel-0.21.0.tar.gz.

File metadata

  • Download URL: async_kernel-0.21.0.tar.gz
  • Upload date:
  • Size: 333.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for async_kernel-0.21.0.tar.gz
Algorithm Hash digest
SHA256 a13fc8b2ca99e5bbfec406473c8a5b999f8b5e56a1d3d8ff3793297ed6c59f31
MD5 0e9cd84fb46f8f36a1652796f5f82307
BLAKE2b-256 0a7eacebbd64c25c7865ef9958cb991d26f98c6354f03ae4c3ae8b7a8da44ead

See more details on using hashes here.

Provenance

The following attestation bundles were made for async_kernel-0.21.0.tar.gz:

Publisher: publish-to-pypi.yml on fleming79/async-kernel

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file async_kernel-0.21.0-py3-none-any.whl.

File metadata

  • Download URL: async_kernel-0.21.0-py3-none-any.whl
  • Upload date:
  • Size: 122.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for async_kernel-0.21.0-py3-none-any.whl
Algorithm Hash digest
SHA256 506d3bdc03027e1c8d3c2de9d2ab6b021a73291242f7df06e7ec449f89fc686c
MD5 4b9683289ca46e156e378efdae4f6a40
BLAKE2b-256 b967204db502f34c84323b19253f9d9b497732af535bfffb1b34f717d5f04b8b

See more details on using hashes here.

Provenance

The following attestation bundles were made for async_kernel-0.21.0-py3-none-any.whl:

Publisher: publish-to-pypi.yml on fleming79/async-kernel

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

0.22.3

2 files

0.22.2

2 files

0.22.1

2 files

0.22.0

2 files

This release

0.21.0 This release

2 files

0.20.2

2 files

0.20.1

2 files

0.20.0

2 files

0.19.2

2 files

0.19.1

2 files

0.19.0

2 files

0.18.3

2 files

0.18.2

2 files

0.18.1

2 files

0.18.0

2 files

0.17.1

2 files

0.17.0

2 files

0.16.4

2 files

0.16.3

2 files

0.16.2

2 files

0.16.1

2 files

0.16.0

2 files

0.15.0

2 files

0.14.0

2 files

0.13.3

2 files

0.13.2

2 files

0.13.1

2 files

0.13.0

2 files

0.12.5

2 files

0.12.4

2 files

0.12.3

2 files

0.12.2

2 files

0.12.1

2 files

0.12.0

2 files

0.11.2

2 files

0.11.1

2 files

0.11.0

2 files

0.10.3

2 files

Yanked

0.10.2

2 files

Yanked reason: Blank message buffers were not being provided.

0.10.1

2 files

Yanked

0.10.0

2 files

Yanked reason: queue_call is unreliable.

Pre-release

0.10.0rc2

2 files

Pre-release

0.10.0rc1

2 files

0.9.2

2 files

0.9.1

2 files

0.9.0

2 files

Pre-release

0.9.0rc4

2 files

Pre-release

0.9.0rc3

2 files

Pre-release

0.9.0rc2

2 files

Pre-release

0.9.0rc1

2 files

0.8.0

2 files

Yanked

0.7.2

2 files

Yanked reason: Made release 0.8.0 instead.

0.7.1

2 files

0.7.0

2 files

Pre-release

0.7.0rc2

2 files

Yanked

0.7.0rc1

2 files

Yanked reason: Repo head got replaced.

0.6.3

2 files

0.6.2

2 files

0.6.1

2 files

0.6.0

2 files

0.5.4

2 files

0.5.3

2 files

0.5.2

2 files

0.5.1

2 files

0.5.0

2 files

0.4.0

2 files

0.3.0

2 files

0.2.1

2 files

0.2.0

2 files

0.1.4

2 files

0.1.3

2 files

0.1.2

2 files

0.1.1

2 files

0.1.0

2 files

Pre-release

0.1.0rc3

2 files

Pre-release

0.1.0rc2

2 files

Pre-release

0.1.0rc1

2 files

Pre-release

0.1.0rc0

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page