Skip to main content

kernmini

Everything a Jupyter kernel needs except the language.

kernmini is a Rust engine for Jupyter kernels. It owns ZMTP transport, signed Jupyter messages, shell and control routing, IOPub, stdin, heartbeat, execution queues, interrupts, JEP 91 subshells, debugging transport, and process lifecycle. A language supplies execution, completion, inspection, history, and kernel metadata through a small adapter.

ipymini is the reference Python kernel. It uses IPython for Python semantics and kernmini for the kernel protocol.

A complete Python kernel

import sys
from kernmini import run_kernel


class EchoShell:
    def __init__(self):
        self.execution_count = 0
        self.stream = None

    def set_stream_sender(self, sender): self.stream = sender

    def kernel_info(self):
        return dict(implementation="echo", implementation_version="0.1", banner="echo",
            language_info=dict(name="echo", version="0.1", mimetype="text/plain", file_extension=".txt"))

    async def execute(self, code, **kwargs):
        self.execution_count += 1
        if self.stream: self.stream("stdout", f"echo: {code}\n")
        return dict(execution_count=self.execution_count, result={"text/plain": code.upper()})


run_kernel(sys.argv[-1], EchoShell, own_process_group=True)

run_kernel creates a persistent asyncio event loop and runs the Rust engine until shutdown. It uses loopmini when installed and the standard asyncio loop otherwise; loop_factory= can select one explicitly. The factory is also used to create independent language sessions for JEP 91 subshells. Standalone executables can request process-group ownership, while embedded kernels leave their host process group unchanged by default.

Rust language implementations use the Language and LanguageSession traits directly. ExecutionContext provides stream, display, stdin, interrupt, and subshell routing without exposing Jupyter transport details.

Output queues are bounded and apply backpressure rather than silently dropping messages. The output pump batches adjacent same-stream writes without a timer. A slow direct IOPub subscriber can slow execution.

DapClient is the optional language-neutral debugger transport: framed TCP, request correlation, timeouts, asynchronous events, and shutdown. Language adapters retain debugger startup, request policy, source mapping, and variable semantics.

install_kernelspec(name, argv, display_name, language) and install_kernelspec_dir(path, name) install kernelspecs without requiring jupyter_client.

Install

pip install kernmini

Release files for kernmini 0.1.13

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for kernmini 0.1.13
File Size Uploaded
kernmini-0.1.13.tar.gz 38.4 kB Details

Built distributions (wheels)

Table of built distributions (wheels) for kernmini 0.1.13
File
kernmini-0.1.13-cp314-cp314-manylinux_2_17_x86_64.manylinux2014_x86_64.whl CPython 3.14 CPython 3.14 Linux glibc 2.17+ x86-64 Details
kernmini-0.1.13-cp314-cp314-manylinux_2_17_aarch64.manylinux2014_aarch64.whl CPython 3.14 CPython 3.14 Linux glibc 2.17+ ARM64 Details
kernmini-0.1.13-cp314-cp314-macosx_11_0_arm64.whl CPython 3.14 CPython 3.14 macOS 11.0+ ARM64 Details
kernmini-0.1.13-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl CPython 3.13 CPython 3.13 Linux glibc 2.17+ x86-64 Details
kernmini-0.1.13-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl CPython 3.13 CPython 3.13 Linux glibc 2.17+ ARM64 Details
kernmini-0.1.13-cp313-cp313-macosx_11_0_arm64.whl CPython 3.13 CPython 3.13 macOS 11.0+ ARM64 Details
kernmini-0.1.13-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl CPython 3.12 CPython 3.12 Linux glibc 2.17+ x86-64 Details
kernmini-0.1.13-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl CPython 3.12 CPython 3.12 Linux glibc 2.17+ ARM64 Details
kernmini-0.1.13-cp312-cp312-macosx_11_0_arm64.whl CPython 3.12 CPython 3.12 macOS 11.0+ ARM64 Details
kernmini-0.1.13-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl CPython 3.11 CPython 3.11 Linux glibc 2.17+ x86-64 Details
kernmini-0.1.13-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl CPython 3.11 CPython 3.11 Linux glibc 2.17+ ARM64 Details
kernmini-0.1.13-cp311-cp311-macosx_11_0_arm64.whl CPython 3.11 CPython 3.11 macOS 11.0+ ARM64 Details

Total release size: 11.0 MB

Release files / kernmini-0.1.13.tar.gz

Download URL kernmini-0.1.13.tar.gz
Size 38.4 kB
Tags Source
SHA-256 checksum
How to use checksums
9ee8b68d23a832c35e3bf120e6896334f222732e4a356ab65b734c22e21644c6
BLAKE2b-256 checksum
How to use checksums
9226f967affb6e16e5961587e57cfcd88a4a6e78244565bb3c980f5a342bb5f1
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 Sep 14, 2026.

Transparency log

Release files / kernmini-0.1.13-cp314-cp314-manylinux_2_17_x86_64.manylinux2014_x86_64.whl

Download URL kernmini-0.1.13-cp314-cp314-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Size 948.9 kB
Tags CPython 3.14 Linux glibc 2.17+ x86-64
SHA-256 checksum
How to use checksums
3a2e2ebb188100e1c507151dbeb6e9f3d5b17dcb84622a49190497b856c29d7a
BLAKE2b-256 checksum
How to use checksums
d13ae61af231ca4ab6259d8811ff1a80cca05659aaea33b391b5ab974c0ee3fa
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 Sep 14, 2026.

Transparency log

Release files / kernmini-0.1.13-cp314-cp314-manylinux_2_17_aarch64.manylinux2014_aarch64.whl

Download URL kernmini-0.1.13-cp314-cp314-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Size 931.8 kB
Tags CPython 3.14 Linux glibc 2.17+ ARM64
SHA-256 checksum
How to use checksums
377551fc25bae08cf59146729044d6a43f621aa2b53b1a536977f40de385ed5d
BLAKE2b-256 checksum
How to use checksums
6171c31bc66271a4caf3bfffe306d0d69c96db4be3ab65a6aa82e5a1c1162b8e
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 Sep 14, 2026.

Transparency log

Release files / kernmini-0.1.13-cp314-cp314-macosx_11_0_arm64.whl

Download URL kernmini-0.1.13-cp314-cp314-macosx_11_0_arm64.whl
Size 865.7 kB
Tags CPython 3.14 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
7dbf703e5e06a4eb86317ad731d1501e6f79e5d4a0fdd90aa7bcd3a87cfb247b
BLAKE2b-256 checksum
How to use checksums
0eea4c63a1fbe66d7a1721027b79c4af876645deaef7ce0494cc72bd4485f9de
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 Sep 14, 2026.

Transparency log

Release files / kernmini-0.1.13-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl

Download URL kernmini-0.1.13-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Size 949.3 kB
Tags CPython 3.13 Linux glibc 2.17+ x86-64
SHA-256 checksum
How to use checksums
449d736aa86b7419504599050b4495c7b0cbadde385024fe71e40e628397eb65
BLAKE2b-256 checksum
How to use checksums
45e94d9195a2f86d6187f91768a9faa0054adb268435f916d796805571a82ff5
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 Sep 14, 2026.

Transparency log

Release files / kernmini-0.1.13-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl

Download URL kernmini-0.1.13-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Size 932.0 kB
Tags CPython 3.13 Linux glibc 2.17+ ARM64
SHA-256 checksum
How to use checksums
b46162df0155b2ee9c19e552b376c7312ef73e5f2c3614eeed145b0fda4efa16
BLAKE2b-256 checksum
How to use checksums
462b9c5f5e2a1696a8b4ad623e9c31ebe0ec19cdcb2ebf78e0a37981773ce906
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 Sep 14, 2026.

Transparency log

Release files / kernmini-0.1.13-cp313-cp313-macosx_11_0_arm64.whl

Download URL kernmini-0.1.13-cp313-cp313-macosx_11_0_arm64.whl
Size 866.1 kB
Tags CPython 3.13 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
308849348b18c3bc17cb06e79cee655bad3ae990f563f1d55c67c05fc03ffa54
BLAKE2b-256 checksum
How to use checksums
ffe30e72ac94fc00ed57b30caeb591828dd5fdc3218b0733e45c86e7db3b3095
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 Sep 14, 2026.

Transparency log

Release files / kernmini-0.1.13-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl

Download URL kernmini-0.1.13-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Size 946.5 kB
Tags CPython 3.12 Linux glibc 2.17+ x86-64
SHA-256 checksum
How to use checksums
79b583d461d6d06c5edd692ae21035e84095a059cbdb2d3a590f66a5adb55d8a
BLAKE2b-256 checksum
How to use checksums
d0774f45cebb7e78494b2ba5e9a750a2c15711476e445854c938770113da3e76
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 Sep 14, 2026.

Transparency log

Release files / kernmini-0.1.13-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl

Download URL kernmini-0.1.13-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Size 929.7 kB
Tags CPython 3.12 Linux glibc 2.17+ ARM64
SHA-256 checksum
How to use checksums
c749428f556b8531614c16914bc6aaad56f1609df047a502955e1fa54914aea2
BLAKE2b-256 checksum
How to use checksums
a6be6fd9e3e7ec4d574cce5042b6e7f428f1f8079dc041e972faa4feaf6f42eb
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 Sep 14, 2026.

Transparency log

Release files / kernmini-0.1.13-cp312-cp312-macosx_11_0_arm64.whl

Download URL kernmini-0.1.13-cp312-cp312-macosx_11_0_arm64.whl
Size 864.9 kB
Tags CPython 3.12 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
5df7d891b51840d97222595cc9f0b87777b74c398ea078406bb3c465010d58f7
BLAKE2b-256 checksum
How to use checksums
923cce5ca491cb14afd64d9c47cc7f30a20cafa970ffb34b53b50c9ab77c32f1
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 Sep 14, 2026.

Transparency log

Release files / kernmini-0.1.13-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl

Download URL kernmini-0.1.13-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Size 949.1 kB
Tags CPython 3.11 Linux glibc 2.17+ x86-64
SHA-256 checksum
How to use checksums
ac8bc48c2e0385f7341ad4f8b91a7f6a96fcca7a64791ebdfeed9a3e8829a42c
BLAKE2b-256 checksum
How to use checksums
c8d38bc5b102c2fd2630ec957d7f9ec3579aa0bccd5151002065175b9365fbd4
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 Sep 14, 2026.

Transparency log

Release files / kernmini-0.1.13-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl

Download URL kernmini-0.1.13-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Size 933.7 kB
Tags CPython 3.11 Linux glibc 2.17+ ARM64
SHA-256 checksum
How to use checksums
e9b2ddb7c58c4651e2da97ccd63332e617014f71bfc52abe092fa96e45caccaa
BLAKE2b-256 checksum
How to use checksums
8836a5e3cc7500aa9e0b595571867cdea3a99f1c4225c1143e2839e4bc8cdcab
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 Sep 14, 2026.

Transparency log

Release files / kernmini-0.1.13-cp311-cp311-macosx_11_0_arm64.whl

Download URL kernmini-0.1.13-cp311-cp311-macosx_11_0_arm64.whl
Size 870.1 kB
Tags CPython 3.11 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
6dd2da7516f5811000f505f7b5b7093cd393606aae146a71f445dad9441420f6
BLAKE2b-256 checksum
How to use checksums
d4b4093a38c0ac5864ebb6700b13361d60cd52795ff0283b252da46171f34686
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 Sep 14, 2026.

Transparency log

Release history Release notifications | RSS feed

This release

0.1.13 This release

13 release files

0.1.9

13 release files

0.1.4

2 release files

0.1.3

2 release files

0.1.2

2 release files

0.1.1

2 release files

0.1.0

2 release 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