README¶

fish-kernel is a Jupyter kernel implementation for the fish shell.

Requirements¶

Python >=3.10
fish command available on PATH
Jupyter frontend (jupyterlab or notebook)
Supported OS: Linux, macOS, and Windows (WSL)
Native Windows is not supported (fish shell dependency)

Install¶

PyPI¶

pip install fish-kernel

After installation, register the kernelspec.

fish-kernel install requires one of --user, --sys-prefix, or --prefix.

Install for your user account:

fish-kernel install --user

Or install into the current Python environment:

fish-kernel install --sys-prefix

After installation, verify the kernel is registered:

jupyter kernelspec list

You should see a fish kernel entry.

Development¶

git clone https://github.com/eunos-1128/fish-kernel.git
cd fish-kernel
uv sync --dev
uv run pytest
uv run fish-kernel install --sys-prefix
uv run jupyter kernelspec list

Usage examples¶

Simple calculation:

set a 7
set b 13
math $a + $b

Acknowledgements¶

This project was developed with inspiration from: