Pixi kernel
Per-directory Pixi environments with multi-language Jupyter kernels.
Pixi kernel supports Jupyterlab 4, Python 3.9+ and Pixi 0.39.0+ using pyproject.toml and
pixi.toml configurations.
Disclaimer: This project is not affiliated with Pixi, and not an official Pixi plugin.
Quick Start
This assumes you want a Python kernel. For other languages, check the Kernel
support table and replace ipykernel with the desired kernel package.
- Install Pixi and
pixi-kernelalongside JupyterLab using your favorite package manager. - Restart JupyterLab.
- Create a new directory and initialize a Pixi project with
pixi initandpixi add ipykernel. - Select the Python Pixi kernel and you are good to go.
See the Pixi docs for more information on how to use Pixi.
Configuration
Custom Pixi binary location
By default, pixi-kernel will try to find the Pixi binary in this order:
- Use
shutil.which("pixi")to find Pixi in your PATH - Check for a configuration file stored at:
- Linux/macOS:
$HOME/.config/pixi-kernel/config.toml - Windows:
$Env:USERPROFILE\.config\pixi-kernel\config.toml
- Linux/macOS:
- Check the default Pixi installation location:
- Linux/macOS:
$HOME/.pixi/bin/pixi - Windows:
$Env:USERPROFILE\.pixi\bin\pixi.exe
- Linux/macOS:
If you have Pixi installed in a non-standard location, you can create a configuration file to specify its path:
pixi-path = "/path/to/your/pixi"
Kernel support
Pixi kernel supports the following kernels:
| Language | Kernel | Package name |
|---|---|---|
| Python | IPython Kernel | ipykernel |
| R | IR Kernel | r-irkernel |
| R | Ark R Kernel | ark |
Pixi environments
Pixi kernel supports multiple Pixi environments in a single Pixi project. To select a specific environment, use JupyterLab property inspector, save your notebook and restart your kernel.
If an environment cannot be determined, Pixi kernel will fallback to the value in the
PIXI_KERNEL_DEFAULT_ENVIRONMENT environment variable, if specified. Otherwise, the default Pixi
environment will be used.
JupyterHub deployments with limited permissions
If you're using pixi-kernel on JupyterHub and cannot access the environment where JupyterLab is installed, you can use the following workaround:
- Install
pixi-kernellocally:pip install pixi-kernel --user - Install Pixi
- Restart your JupyterLab server
See https://github.com/renan-r-santos/pixi-kernel/issues/62 and https://github.com/renan-r-santos/pixi-kernel/issues/51 for more information.
Limitations
Pixi kernel only works with the default environment in VSCode.
Related
1 maintainer
Metadata
1 maintainer
Release files for pixi-kernel 0.7.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| pixi_kernel-0.7.1.tar.gz | 714.1 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| pixi_kernel-0.7.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 759.5 kB
Release files / pixi_kernel-0.7.1.tar.gz
| Download URL | pixi_kernel-0.7.1.tar.gz |
|---|---|
| Size | 714.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
b8788c9f07e24397576947771ef81fc3cb58d374e245939bf4f5a4a827edaf1f
|
|
BLAKE2b-256 checksum How to use checksums |
57329cd86c46272ce0c10cfe9dbf1966afbd8faa4452c9ba97974977b2fe6572
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
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 Nov 25, 2025.
Transparency logRelease files / pixi_kernel-0.7.1-py3-none-any.whl
| Download URL | pixi_kernel-0.7.1-py3-none-any.whl |
|---|---|
| Size | 45.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
93b51c8a95ca58fb4b743cb2ce5d73b951f467e7c39b0c766f20e05bdf950478
|
|
BLAKE2b-256 checksum How to use checksums |
c436ce5f75aa7c736a663a901766edc3580098c7ea3959a0e878363a54a3714e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
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 Nov 25, 2025.
Transparency log
