matthiaskoenig / ipywidgets

IPython widgets for the Jupyter Notebook

Interactive HTML Widgets

Interactive HTML widgets for Jupyter notebooks and the IPython kernel.

A demonstration notebook provides an overview of the interactive widgets. For detailed information, please refer to the ipywidgets documentation.

Install

Install the current version of ipywidgets using pip or conda:

pip install ipywidgets

or

conda install ipywidgets

Development install

To install ipywidgets from git, you will need npm.

0. clone the repo:

    git clone https://github.com/ipython/ipywidgets
    cd ipywidgets
   

1. Dev-install of the package (run from repo directory):

    pip install -v -e .
   

   Note: You need to have npm installed. The installation process will complain if you don't. If you install using sudo, you need to make sure that npm is also available in the PATH used with sudo.

Test

To run the Python tests:

nosetests --with-coverage --cover-package=ipywidgets ipywidgets

To run the Javascript tests:

npm run test

This will run the test suite using karma with 'debug' level logging.

Resources

ipywidgets

• Demo notebook of interactive widgets
• Documentation for ipywidgets [PDF]
• Issues
• Technical support - Jupyter Google Group

Project Jupyter

• Project Jupyter website
• Online Demo of Jupyter Notebook at try.jupyter.org
• Documentation for Project Jupyter [PDF]