thebe-lite

Connect to a pyodide kernel via jupyterlite in thebe-core & thebe.

Usage

in thebe

To use JupyterLite with thebe, load this module on your page using a script tag before loading thebe itself.

<script src="thebe-lite.min.js"></script>
<script src="https://unpkg.com/thebe@latest/dist/lib/index.js"></script>

thebe will then feature detect the library and use the module when appropriate option is set.

Note: at the moment, in order for thebe-lite to work, the entire package must be available at at the root of the host domain as pyolite currently requires wheels to be available at /build/pypi.

with npm

First install the package:

npm i thebe-core thebe-lite

Thebe is loaded asynchronously so you need to copy the build artifacts into your project static directory (e.g. public in react) you can do that using: npx copy-thebe-assets <output_dir>

e.g: npx copy-thebe-assets public/thebe

Interface

thebe-lite will extend the global thebe namespace, making the following available on window:

 window.thebe = {
    ...,
    thebeLite: {
        startJupyterLiteServer: () => Promise<ServiceManager>
    }
 }

In order to connect to a jupyterlite kernel with thebe use set the following options:

{
    useBinder: false,
    useJupyterLite: true
}

When loading in typescript this interface is available as ThebeLiteBundle and a connection can be established by:

import { makeConfiguration, ThebeServer } from 'thebe-core';
import { setupThebeLite } from 'thebe-lite';

setupThebeLite();

const config = makeConfiguration({});
const server = new ThebeServer(config);

await server.connectToJupyterLiteServer();

Read More

For more examples of thebe-lite in use, see apps/simple and apps/demo-core.