Skip to content

jupyterlite/pyodide-kernel

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

jupyterlite-pyodide-kernel

A Python kernel for JupyterLite powered by Pyodide,

ci-badge lite-badge docs-badge

🚧 This is a work in progress 🚧

The Pyodide kernel is currently being extracted from the main JupyterLite repository to this repo. See the JupyterLite issue for background and current status.

⚠️ below denotes instructions that are incomplete or subject to change.

Requirements

  • python >=3.8
  • jupyterlite >=0.1.0b19

⚠️ At present, jupyterlite-pyodide-kernel is only compatible with the in-development version mentioned above, and requires nodejs

A normal install does not require nodejs, but a development install does.

Install

⚠️ jupyterlite-pyodide-kernel is not yet published on PyPI.

For now, the contributing guide describes how to build the package locally.

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

pip install jupyterlite-pyodide-kernel

Then build your JupyterLite site:

jupyter lite build

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

Uninstall

To remove the extension, run:

pip uninstall jupyterlite-pyodide-kernel

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.

  • virtualenv
  • mamba
  • conda

Ensure the local development environment has:

  • git
  • nodejs 18
  • 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