metakernel
A Jupyter/IPython Kernel base class in Python
What it is and what it does
MetaKernel is a framework for building custom Jupyter kernels by subclassing a base class that bundles common kernel functionality. It provides a set of line and cell magics (help, completion, shell commands, parallel execution), tab completion for magics and file paths, and configuration hooks for plot behavior and other traits. The package is designed so that kernel developers can focus on language-specific logic while inheriting standard interactive features.
You can use MetaKernel directly to add a subset of its magics to IPython, or use it as the foundation for a new kernel targeting a different language or runtime. The description lists many existing kernels built on MetaKernel, including matlab_kernel, octave_kernel, and others. It also supports parallel execution across multiple nodes when used with ipyparallel.
Use it for:
- Build a custom Jupyter kernel for a new language or runtime by subclassing MetaKernel.
- Add MetaKernel magics (help, completion, shell commands) to an existing IPython kernel.
- Run code in parallel across multiple Jupyter kernel instances using the %px and %%px magics.
- Configure plot behavior and other kernel traits via configuration files in the Jupyter config directory.
Worth the install?
AI-flagged interpretation of the facts on this page — verify before relying
MetaKernel is a base class for building custom Jupyter kernels in Python, providing core magic functions like help, completion, parallel processing, and shell integration.
Yes. MetaKernel is actively maintained, has low install friction, carries a permissive license, and no known vulnerabilities. Install it if you are building a custom Jupyter kernel or want to add MetaKernel magics to IPython. It is not necessary for standard Jupyter use.
Install
metakernel on PyPI
pip
pip install metakerneluv
uv add metakernelpoetry
poetry add metakernelInstalling metakernel
Before you install
Low install friction with a pure-Python wheel distribution. Actively maintained with a recent release (143 days ago) and an active repository.
License in practice
BSD-3-Clause is a permissive license; you can use, modify, and distribute this package with minimal restrictions.
Quickstart
pip install metakernel
from metakernel import register_ipython_magics
register_ipython_magics()
Requires Python 3.11 or later.
Verify before relying
- Whether the package's parallel processing features require ipyparallel to be pre-installed or if it's optional.
- Whether custom kernel subclasses need additional configuration beyond the base class to function.
Package facts
| License | BSD-3-Clause (permissive) |
| Python support | supports the current Python release (>=3.11) |
| Install friction | low — pure-Python wheel |
| Runtime dependencies | 5 — comm, ipykernel, jedi, jupyter_core, pexpect |
| Maintenance | actively maintained — 143 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 75,240/month — #14,734 on PyPI (30-day window, as of 2026-08-14) |
| Known vulnerabilities | none known (OSV.dev, checked 2026-08-14) |
Evidence: metakernel-1.0.0-py3-none-any.whl
Tags
More Shells packages
Wraps any iterable to display a real-time…
copyleft · top 100 on PyPI
pexpectPexpect spawns and controls interactive console…
permissive · top 1,000 on PyPI
ipythonIPython is an enhanced interactive Python shell…
permissive · top 1,000 on PyPI
argcompleteProvides bash and zsh tab completion for Python…
permissive · top 1,000 on PyPI
humanfriendlyFormats and parses numbers, file sizes,…
permissive · top 1,000 on PyPI
coloredlogsAdds colored output to Python's standard…
permissive · top 1,000 on PyPI
ipyparallelManages clusters of IPython processes for…
permissive · top 15,000 on PyPI
ipykernelProvides the IPython kernel backend that powers…
permissive · top 1,000 on PyPI
jupyterJupyter is a metapackage that installs the core…
permissive · top 5,000 on PyPI
spyder-kernelsProvides Jupyter kernels that integrate Python…
permissive · top 15,000 on PyPI
jupyter-kernel-gatewayJupyter Kernel Gateway is a web server that…
permissive · top 5,000 on PyPI
emr-notebooks-magicsProvides iPython magics for Amazon EMR…
permissive · top 5,000 on PyPI
bigquery-magicsProvides IPython magic commands to query Google…
permissive · top 15,000 on PyPI
bash_kernelEnables running and interacting with bash…
permissive · top 15,000 on PyPI
kernelsLoads optimized compute kernels from Hugging…
permissive · top 5,000 on PyPI