Skip to main content

Python kernel for JupyterLite powered by Pyodide

Project description

jupyterlite-pyodide-kernel

A Python kernel for JupyterLite powered by Pyodide,

ci-badge lite-badge docs-badge

Requirements

  • python >=3.8

Compatibility

status jupyterlite-pyodide-kernel jupyterlite-core jupyterlab notebook retrolab
stable 0.2.* >=0.2,<0.3 >=4.0.7,<5 >=7.0.5,<8 -
stable 0.1.* >=0.1,<0.2 >=3.5,<3.6 - >=0.3,<0.4

Installing the matching version of JupyterLab with your package manager can help ensure matching labextension assets and kernel dependencies, even though this kernel does not yet work in a full, jupyter_server-hosted client such as JupyterLab or Notebook.

Install

To install the Pyodide kernel labextension and the CLI addons for jupyter lite, run:

pip install jupyterlite-pyodide-kernel

or with conda, mamba, micromamba, etc.

conda install -c conda-forge jupyterlite-pyodide-kernel

For more options see the development install or contributing guide.

Usage

Build a JupyterLite site:

jupyter lite build

Some new CLI options are also available:

jupyter lite --help

This should show something like this:

  --piplite-wheels=<typedtuple-item-1>...
      Local paths or URLs of piplite-compatible wheels to copy and index
      Default: ()
      Equivalent to: [--PipliteAddon.piplite_urls]
  --pyodide=<Unicode>
      Local path or URL of a pyodide distribution tarball
      Default: ''
      Equivalent to: [--PyodideAddon.pyodide_url]

Learn more

⚠️ The documentation for advanced configuration is available from the main JupyterLite documentation site:

Uninstall

To remove the extension, run:

pip uninstall jupyterlite-pyodide-kernel  # or however you installed it

Prerelease Versions

To install pre-release versions with pip:

pip install --upgrade --pre jupyterlite-pyodide-kernel

Or, similarly for the conda ecosystem, for alpha packages:

conda install \
  -c conda-forge/label/jupyterlite_core_alpha \
  -c conda-forge/label/jupyterlite_pyodide_kernel_alpha \
  -c conda-forge \
  jupyterlite-pyodide-kernel

Note: _beta and _rc packages would follow a similar channel naming convention

Development Install

Below is an short overview of getting up and running quickly. Please see the contributing guide for full details.

Development Requirements

Recommended a Python virtual environment provided by a tool of choice, e.g. one of:

  • virtualenv
  • mamba
  • conda

Ensure the local development environment has:

  • git
  • nodejs 20
  • python >=3.8

Development Quick Start

git clone https://github.com/jupyterlite/pyodide-kernel
cd pyodide-kernel
npm run quickstart

Then, serve the built demo site, documentation, and test reports with Python's built-in HTTP server:

jlpm serve

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

jupyterlite_pyodide_kernel-0.2.0.tar.gz (194.8 kB view details)

Uploaded Source

Built Distribution

jupyterlite_pyodide_kernel-0.2.0-py3-none-any.whl (210.3 kB view details)

Uploaded Python 3

File details

Details for the file jupyterlite_pyodide_kernel-0.2.0.tar.gz.

File metadata

File hashes

Hashes for jupyterlite_pyodide_kernel-0.2.0.tar.gz
Algorithm Hash digest
SHA256 5979ffd9e4eeb8af145e14a900952a2e8ce3633158b385b9444a8238520f3482
MD5 03c09dfa8ed147f9beca2330c8531363
BLAKE2b-256 d20755b3088f052b60f0acfd4242e96f2e41712401056e3d903d19bbd214e4bd

See more details on using hashes here.

Provenance

File details

Details for the file jupyterlite_pyodide_kernel-0.2.0-py3-none-any.whl.

File metadata

File hashes

Hashes for jupyterlite_pyodide_kernel-0.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 17d713f0eeb3f778c4d51129834096d364c16f05ac06e10292383c43c0eb5bd9
MD5 08ce0a8b8eba71e7484c75a572878275
BLAKE2b-256 1ca8d4c30081747f4c5d3d75c1e77251ef64f2c3b927023f2796168a83aa65e2

See more details on using hashes here.

Provenance

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page