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.
Operations return kernmini::Result<T> with a typed ErrorKind and preserved causes. These operational failures are separate from an executed program's LanguageError. See the error contract for cancellation, closure, timeout, and Python exception mappings.
ThreadWorker lets async adapters call a synchronous interpreter on a dedicated thread. Its factory creates the interpreter there, call awaits a closure's result, and shutdown waits for destruction on the same thread. The interpreter need not be Send; the adapter supplies a thread builder for its name and stack size. Language traits stay async.
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.17
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| kernmini-0.1.17.tar.gz | 44.1 kB | Details |
Built distributions (wheels)
Total release size: 11.3 MB
Release files / kernmini-0.1.17.tar.gz
| Download URL | kernmini-0.1.17.tar.gz |
|---|---|
| Size | 44.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
b8e8704d8352f29f139e4a3e6fd6c035c9c76007671c9e13d4fc0871d72a43df
|
|
BLAKE2b-256 checksum How to use checksums |
c015e02e2a687a7c0b3c61c4c8e2a5974541bd4d2df434f66e6f15ee91c63849
|
| 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 30, 2026.
Transparency logRelease files / kernmini-0.1.17-cp314-cp314-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | kernmini-0.1.17-cp314-cp314-manylinux_2_17_x86_64.manylinux2014_x86_64.whl |
|---|---|
| Size | 977.4 kB |
| Tags | CPython 3.14 Linux glibc 2.17+ x86-64 |
|
SHA-256 checksum How to use checksums |
367d4714baafa095d7718dedca19440d5c10f6b97c5211a63f35a4965d6ce8b2
|
|
BLAKE2b-256 checksum How to use checksums |
b7bfdb7925c6abdffbee2316e1b5115369f816b00950c42675b30fefcac6079b
|
| 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 30, 2026.
Transparency logRelease files / kernmini-0.1.17-cp314-cp314-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
| Download URL | kernmini-0.1.17-cp314-cp314-manylinux_2_17_aarch64.manylinux2014_aarch64.whl |
|---|---|
| Size | 955.9 kB |
| Tags | CPython 3.14 Linux glibc 2.17+ ARM64 |
|
SHA-256 checksum How to use checksums |
2203468bdbae2bd30bdf039be06053c4d977f3db954d64368d76e68e262192c8
|
|
BLAKE2b-256 checksum How to use checksums |
5932b823b1db881bfb26fc686756fb30161552201ffa8449bcd72ec0e54ed258
|
| 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 30, 2026.
Transparency logRelease files / kernmini-0.1.17-cp314-cp314-macosx_11_0_arm64.whl
| Download URL | kernmini-0.1.17-cp314-cp314-macosx_11_0_arm64.whl |
|---|---|
| Size | 891.6 kB |
| Tags | CPython 3.14 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
25b2b1b2655bfec889643771d377b61e3f4317e8521214e3b2f962719bd1d8fb
|
|
BLAKE2b-256 checksum How to use checksums |
a7d8803ff89d4c54be528549b60f3d249e6821438c68d6576aebdcf399c5cd0a
|
| 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 30, 2026.
Transparency logRelease files / kernmini-0.1.17-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | kernmini-0.1.17-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl |
|---|---|
| Size | 977.9 kB |
| Tags | CPython 3.13 Linux glibc 2.17+ x86-64 |
|
SHA-256 checksum How to use checksums |
6114aede071a01b44ea0bba036e3f3e5c432e95c132ed2e6c94c8d2a859ada3e
|
|
BLAKE2b-256 checksum How to use checksums |
eee924ab6e1e5276517a3080627e6f993b48cdc289a1e40ef96f29554b4deb09
|
| 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 30, 2026.
Transparency logRelease files / kernmini-0.1.17-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
| Download URL | kernmini-0.1.17-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl |
|---|---|
| Size | 955.9 kB |
| Tags | CPython 3.13 Linux glibc 2.17+ ARM64 |
|
SHA-256 checksum How to use checksums |
e524b05b8e13801280a4180b874974dda7dc5ff323f79e9d1af572bb9b61c1af
|
|
BLAKE2b-256 checksum How to use checksums |
aba598c22ded8bb9a0021f26a41e4405bb17369cc003d175e48286e4f54a3b3a
|
| 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 30, 2026.
Transparency logRelease files / kernmini-0.1.17-cp313-cp313-macosx_11_0_arm64.whl
| Download URL | kernmini-0.1.17-cp313-cp313-macosx_11_0_arm64.whl |
|---|---|
| Size | 892.7 kB |
| Tags | CPython 3.13 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
d15c15b0915aed28c6258e94032375958f29437390bac2124800a391af27129a
|
|
BLAKE2b-256 checksum How to use checksums |
3985bcba9a4be01599f98838e5c38312f7c56beece8d727052377dec82e8f8db
|
| 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 30, 2026.
Transparency logRelease files / kernmini-0.1.17-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | kernmini-0.1.17-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl |
|---|---|
| Size | 975.3 kB |
| Tags | CPython 3.12 Linux glibc 2.17+ x86-64 |
|
SHA-256 checksum How to use checksums |
2fe70a8cb04f97795a736f293486e85df0938181e186302ba13fc22914695023
|
|
BLAKE2b-256 checksum How to use checksums |
284f5fe62af947ff42a20f08384a787af9e8146c92d50332302335c028491e81
|
| 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 30, 2026.
Transparency logRelease files / kernmini-0.1.17-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
| Download URL | kernmini-0.1.17-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl |
|---|---|
| Size | 953.7 kB |
| Tags | CPython 3.12 Linux glibc 2.17+ ARM64 |
|
SHA-256 checksum How to use checksums |
30de90402dfec5965faf6d61e6b082bf6a76e9d94caf55b1c86540e4cf642113
|
|
BLAKE2b-256 checksum How to use checksums |
31cf64dacc0a67c064938bb45e5051419bb2535c296895e5f36b2b0971880371
|
| 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 30, 2026.
Transparency logRelease files / kernmini-0.1.17-cp312-cp312-macosx_11_0_arm64.whl
| Download URL | kernmini-0.1.17-cp312-cp312-macosx_11_0_arm64.whl |
|---|---|
| Size | 889.3 kB |
| Tags | CPython 3.12 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
a222abde8d737ad742a52b31574cc971842ec190f529d931febb33fe807bf8ea
|
|
BLAKE2b-256 checksum How to use checksums |
081d43fa874ceb6b5dcd783ff2b73449f0d855b098fcdbab9619a0575d82c7ce
|
| 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 30, 2026.
Transparency logRelease files / kernmini-0.1.17-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | kernmini-0.1.17-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl |
|---|---|
| Size | 977.8 kB |
| Tags | CPython 3.11 Linux glibc 2.17+ x86-64 |
|
SHA-256 checksum How to use checksums |
6521233bf9fa492e4cdc116bacd0606641afaf20a87ef4d3c757289017cb99b8
|
|
BLAKE2b-256 checksum How to use checksums |
fce95d0765a6a81011f9f0f4ec9c5dc688ae4f042133f956e68fd91d718fd3cd
|
| 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 30, 2026.
Transparency logRelease files / kernmini-0.1.17-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
| Download URL | kernmini-0.1.17-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl |
|---|---|
| Size | 957.4 kB |
| Tags | CPython 3.11 Linux glibc 2.17+ ARM64 |
|
SHA-256 checksum How to use checksums |
afa6e49417c6403f6190debdc8dcf7ea79006255e4a074e01c6c8d871ddc5d8e
|
|
BLAKE2b-256 checksum How to use checksums |
5b6e5a0918ec6c12ff1d3cb0a3c53af91f7d414492d7023bcca0f724efa15663
|
| 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 30, 2026.
Transparency logRelease files / kernmini-0.1.17-cp311-cp311-macosx_11_0_arm64.whl
| Download URL | kernmini-0.1.17-cp311-cp311-macosx_11_0_arm64.whl |
|---|---|
| Size | 897.6 kB |
| Tags | CPython 3.11 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
863003bba989785826ac55d566c6ca48b190285868f08c196275761723c12003
|
|
BLAKE2b-256 checksum How to use checksums |
8d0765c024752b34b932c518505038db50f310b261b9365eb43cf4a69f80a625
|
| 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 30, 2026.
Transparency log
