Skip to main content

A Waldiez JupyterLab extension.

Project description

@waldiez/jupyter

CI Build Coverage Status PyPI version

A Waldiez JupyterLab extension.

This extension is composed of a Python package named waldiez-jupyter for the server extension and a NPM package named @waldiez/jupyter for the frontend extension.

Quick Start

Using docker:

CONTAINER_COMMAND=docker # or podman
$CONTAINER_COMMAND run \
  --rm \
  -it \
  -p 10000:8888 \
  -v ${PWD}/notebooks:/home/user/notebooks \
  ghcr.io/waldiez/jupyter:latest

# with selinux and/or podman, you might get permission errors, so you can try:
$CONTAINER_COMMAND run \
  --rm \
  -it \
  -p 10000:8888 \
  -v ${PWD}/notebooks:/home/user/notebooks \
  --userns=keep-id \
  --security-opt label=disable ghcr.io/waldiez/jupyter:latest

Then open your browser at http://localhost:10000 and you should see the JupyterLab interface.

Optional environment variables for the container:

# no password or token by default
JUPYTER_PASSWORD=
JUPYTER_TOKEN=

Requirements

  • JupyterLab >= 4.0.0

Install

To install the extension, execute:

## if not already, install jupyter:
# pip install jupyter
pip install waldiez-jupyter
## you can now start jupyter lab:
# jupyter lab

Or from the repository:

# Note: node js and yarn are required to build the extension
pip install git+https://github.com/waldiez/jupyter

Uninstall

To remove the extension, execute:

pip uninstall waldiez_jupyter

Troubleshoot

If you are seeing the frontend extension, but it is not working, check that the server extension is enabled:

jupyter server extension list

If the server extension is installed and enabled, but you are not seeing the frontend extension, check the frontend extension is installed:

jupyter labextension list

License

This project is licensed under the MIT License - see the LICENSE file for details.

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

waldiez_jupyter-0.1.7.tar.gz (530.5 kB view details)

Uploaded Source

Built Distribution

waldiez_jupyter-0.1.7-py3-none-any.whl (288.4 kB view details)

Uploaded Python 3

File details

Details for the file waldiez_jupyter-0.1.7.tar.gz.

File metadata

  • Download URL: waldiez_jupyter-0.1.7.tar.gz
  • Upload date:
  • Size: 530.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/5.1.1 CPython/3.12.7

File hashes

Hashes for waldiez_jupyter-0.1.7.tar.gz
Algorithm Hash digest
SHA256 2913ff384120e8681d4794be3ef9dde9abd85b0daaac796ab0a44c946d759cf2
MD5 d1074d25574adc695fd571c6c5fd3016
BLAKE2b-256 a3038451430fafe42bb019cad0d94129a0695df682dc9da2108eae2c2af3177b

See more details on using hashes here.

Provenance

The following attestation bundles were made for waldiez_jupyter-0.1.7.tar.gz:

Publisher: package.yaml on waldiez/jupyter

Attestations:

File details

Details for the file waldiez_jupyter-0.1.7-py3-none-any.whl.

File metadata

File hashes

Hashes for waldiez_jupyter-0.1.7-py3-none-any.whl
Algorithm Hash digest
SHA256 fb59efb88f9c74559887197fc6d6d730f80524917b8e15d5d2d369f61e783f9a
MD5 633322a7023456153bc4da757c93f1ce
BLAKE2b-256 2771be12aa45a8c11927fc818359d230bb693f7617e1deb65352b86e804aec9e

See more details on using hashes here.

Provenance

The following attestation bundles were made for waldiez_jupyter-0.1.7-py3-none-any.whl:

Publisher: package.yaml on waldiez/jupyter

Attestations:

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