ipywidgets: Interactive HTML Widgets

ipywidgets are interactive HTML widgets for Jupyter notebooks, JupyterLab and the IPython kernel.

Notebooks come alive when interactive widgets are used. Users gain control of their data and can visualize changes in the data.

Learning becomes an immersive, fun experience. Researchers can easily see how changing inputs to a model impact the results. We hope you will add ipywidgets to your notebooks, and we're here to help you get started.

Core Interactive Widgets

A demonstration notebook provides an overview of the core interactive widgets, including:

sliders
progress bars
text boxes
toggle buttons and checkboxes
display areas
and more

Jupyter Interactive Widgets as a Framework

Besides the widgets already provided with the library, the framework can be extended with custom widget libraries.

A template project is available in the form of a cookie cutter here.

This project is meant to help custom widget authors get started with the packaging and the distribution of Jupyter interactive widgets.

It produces a project for a Jupyter interactive widget library following the current best practices for using interactive widgets. An implementation for a placeholder "Hello World" widget is provided.

Popular widget libraries such as bqplot, pythreejs and ipyleaflet

follow exactly the same template and directory structure. They can serve as more advanced examples of usage of the Jupyter widget infrastructure.

For detailed information, please refer to the ipywidgets documentation.

More advanced examples

Examples of custom widget libraries built upon ipywidgets are

bqplot a 2d data visualization library enabling custom user interactions.
pythreejs a Jupyter - Three.js wrapper, bringing Three.js to the notebook.
ipyleaflet a leaflet widget for Jupyter.

Install

Install the current version of ipywidgets using pip or conda.

With pip:

pip install ipywidgets
jupyter nbextension enable --py --sys-prefix widgetsnbextension  # can be skipped for notebook version 5.3 and above

With conda:

conda install -c conda-forge ipywidgets

Install the front-end extension to JupyterLab (note that this requires nodejs to be installed):
- For JupyterLab 1.0.x and 1.1.x, use jupyter labextension install @jupyter-widgets/jupyterlab-manager@1.0
- For JupyterLab 1.2.x, use jupyter labextension install @jupyter-widgets/jupyterlab-manager@1.1
- For JupyterLab 2.x, use jupyter labextension install @jupyter-widgets/jupyterlab-manager@2.0
See the Installation section of the documentation for additional details.

Installing from git

If you want to install ipywidgets from git, you will need the yarn package manager version 1.2.1 or later. Installing from git is more complicated and requires a developer install, see the developer install instructions.

To install the latest master version from the root directory of the source code, run dev-install.sh. To only build the Python package enter pip install -e ..