The widgyts project depends on a number of packages. Minimally, your machine
PyPI Installation (recommended)¶
widgyts is packaged and available on the Python Package Index. You can install
widgyts from pypi by
$ pip install widgyts
Note that if you do not already have jupyter widgets or jupyter datawidgets installed on your machine or in your current active environment, this step may take some time.
Installation from Source¶
widgyts from source, you’ll need to clone the repository from
$ git clone https://github.com/yt-project/widgyts.git
Then navigate into the newly created directory and install using pip:
$ cd widgyts $ pip install .
$ git clone https://github.com/yt-project/widgyts.git $ cd widgyts/js $ npm install $ cd ../ $ pip install -e . $ jupyter serverextension enable --py --sys-prefix widgyts $ jupyter nbextension install --py --symlink --sys-prefix widgyts $ jupyter nbextension enable --py --sys-prefix widgyts
If you are modifying code on the python side, you may have to periodically
update your installation from the steps
pip install onwards. If you are
npm install to have your
changes available in jupyter notebooks.
Note that in previous versions, serverextension was not provided and you were required to set up your own mimetype in your local configuration. This is no longer the case and you are now able to use this server extension to set up the correct wasm mimetype.
To install the jupyterlab extension, you will need to make sure you are on a recent enough version of Jupyterlab, preferably 0.35 or above. For a development installation, do:
$ jupyter labextension install js
To install the latest released version,
$ jupyter labextension install @data-exp-lab/yt-widgets