skillfed

metakernel

A Jupyter/IPython Kernel base class in Python

metakernel v1.0.0 75.2K downloads/30d#14,734 on PyPI371
Permissive license BSD-3-Clause Active released

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 metakernel

uv

uv add metakernel

poetry

poetry add metakernel

Installing 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

Framework :: IPythonIntended Audience :: DevelopersProgramming Language :: Python :: 3Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.14Topic :: System :: Shells

Tags

jupyter kernel base classcustom jupyter kernel frameworkjupyter magic functionsipython kernel wrapperparallel jupyter kernels
jupyter-kernelinteractive-computing

More Shells packages