Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/jupyter-widgets/ipywidgets
Interactive Widgets for the Jupyter Notebook
https://github.com/jupyter-widgets/ipywidgets
jupyter-notebooks jupyterlab-extension
Last synced: 4 days ago
JSON representation
Interactive Widgets for the Jupyter Notebook
- Host: GitHub
- URL: https://github.com/jupyter-widgets/ipywidgets
- Owner: jupyter-widgets
- License: bsd-3-clause
- Created: 2015-04-17T20:29:25.000Z (over 9 years ago)
- Default Branch: main
- Last Pushed: 2024-10-22T09:21:35.000Z (about 2 months ago)
- Last Synced: 2024-10-29T11:12:53.497Z (about 1 month ago)
- Topics: jupyter-notebooks, jupyterlab-extension
- Language: TypeScript
- Homepage: https://ipywidgets.readthedocs.io
- Size: 36.2 MB
- Stars: 3,155
- Watchers: 78
- Forks: 951
- Open Issues: 762
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
- awesome-jupyterlab - ipywidgets - Interactive widgets for the Jupyter Notebook (Uncategorized / Uncategorized)
- my-awesome-github-stars - jupyter-widgets/ipywidgets - Interactive Widgets for the Jupyter Notebook (TypeScript)
- awesome-jupyter-resources - GitHub - 31% open · ⏱️ 23.08.2022): (交互式小部件和可视化)
- best-of-jupyter - GitHub - 36% open · ⏱️ 22.10.2024): (Interactive Widgets & Visualization)
- awesome-jupyter - ipywidgets - UI widgets for Jupyter. <!--lint enable double-link--> (Visualization)
- -awesome-jupyter - ipywidgets - UI widgets for Jupyter. (Visualization)
- awesome-starred - jupyter-widgets/ipywidgets - Interactive Widgets for the Jupyter Notebook (others)
README
# ipywidgets: Interactive HTML Widgets
| Purpose | Badges |
| ------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Latest (`main`: future 8.0)** | [](https://github.com/jupyter-widgets/ipywidgets/actions?query=branch%3Amain) [](https://ipywidgets.readthedocs.io/en/latest/?badge=latest) [](https://mybinder.org/v2/gh/jupyter-widgets/ipywidgets/main?urlpath=lab/tree/docs%2Fsource%2Fexamples) |
| **Stable** | [](https://pypi.python.org/pypi/ipywidgets) [](https://anaconda.org/conda-forge/ipywidgets) [](https://ipywidgets.readthedocs.io/en/stable/?badge=stable) [](https://mybinder.org/v2/gh/jupyter-widgets/ipywidgets/7.x?urlpath=lab/tree/docs%2Fsource%2Fexamples) |
| **Communication** | [](https://gitter.im/jupyter-widgets/Lobby) [](https://discourse.jupyter.org/c/widgets/46) |
| | |
**ipywidgets**, also known as jupyter-widgets or simply widgets, are
[interactive HTML widgets](https://github.com/jupyter-widgets/ipywidgets/blob/main/docs/source/examples/Index.ipynb)
for Jupyter notebooks 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.
The ipywidgets package is under the [Jupyter-Widgets](https://github.com/jupyter-widgets) [software subproject](https://jupyter.org/governance/software_subprojects.html).
## Core Interactive Widgets
The fundamental widgets provided by this library are called core interactive
widgets. A [demonstration notebook](https://github.com/jupyter-widgets/ipywidgets/blob/main/docs/source/examples/Index.ipynb)
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 the development of **custom widget libraries**. For detailed
information, please refer to the [ipywidgets documentation](https://ipywidgets.readthedocs.io/en/latest/).
### Cookiecutter template for custom widget development
A template project for building custom widgets is available as a
[**cookiecutter**](https://github.com/jupyter-widgets/widget-ts-cookiecutter).
This cookiecutter project helps custom widget authors get started with the
packaging and the distribution of their custom Jupyter interactive widgets.
The cookiecutter 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 as an example.
Popular widget libraries such as
[bqplot](https://github.com/bqplot/bqplot),
[pythreejs](https://github.com/jupyter-widgets/pythreejs) and
[ipyleaflet](https://github.com/jupyter-widgets/ipyleaflet)
follow exactly the same template and directory structure. They serve as
more advanced examples of usage of the Jupyter widget infrastructure.
### Popular custom widget examples
Examples of custom widget libraries built upon ipywidgets are
- [bqplot](https://github.com/bqplot/bqplot) a 2d data visualization library
enabling custom user interactions.
- [pythreejs](https://github.com/jupyter-widgets/pythreejs) a Jupyter - Three.js wrapper,
bringing Three.js to the notebook.
- [ipyleaflet](https://github.com/jupyter-widgets/ipyleaflet) a leaflet widget for Jupyter.
## Install
The stable version of ipywidgets can be installed with pip or conda.
With pip:
```sh
pip install ipywidgets
```
With conda:
```sh
conda install -c conda-forge ipywidgets
```
### Developer install from source
Installing from source is more complicated and requires a developer install,
see the detailed [developer install](docs/source/dev_install.md) instructions.
If you want to install ipywidgets from source, **you will need the
[yarn](https://yarnpkg.com/) package manager version 3 or later**.
To install the latest `main` version from the root directory of the source
code, run `dev-install.sh`. To only build the Python package enter
`pip install -e .`.
## Usage
See the [examples](docs/source/examples.md) section of the documentation. The widgets are being used in a variety of ways; some uses can be seen in these notebooks:
[Demo notebook of interactive widgets](https://github.com/jupyter-widgets/ipywidgets/blob/main/docs/source/examples/Index.ipynb)
## Change log
[Change log](docs/source/changelog.md)
### Version Compatibility with Front-End Clients
Refer to change log for more detail.
| ipywidgets | JupyterLab | [Classic Notebook](https://github.com/jupyter/notebook) | [nbclassic](https://github.com/jupyterlab/nbclassic) |
| ---------- | :--------: | :-----------------------------------------------------: | :--------------------------------------------------: |
| `main` | | - | TBD |
| `7.6.3` | | | 0.2.6 |
| **Legacy** | | | |
| `6.x` | | | - |
| `5.x` | | 4.2 | - |
| `4.1.x` | | 4.1 | - |
| `4.0.x` | | 4.0 | - |
## Contributing to ipywidgets
[Developer information](CONTRIBUTING.md)
## License
We use a shared copyright model that enables all contributors to maintain the
copyright on their contributions.
See the [LICENSE](LICENSE) file in this repository for details.
## Project Jupyter resources
- [Project Jupyter website](https://jupyter.org)
- [Online Demo at try.jupyter.org](https://try.jupyter.org)
- [Documentation for Project Jupyter](https://jupyter.readthedocs.io/en/latest/index.html) [[PDF](https://media.readthedocs.org/pdf/jupyter/latest/jupyter.pdf)]
- [](https://discourse.jupyter.org/)
[](https://groups.google.com/forum/#!forum/jupyter)
## [Weekly Team Meetings](https://github.com/jupyter-widgets/team-compass/issues/1)
Developer Meetings take place on [zoom](https://zoom.us/my/jovyan?pwd=c0JZTHlNdS9Sek9vdzR3aTJ4SzFTQT09), on Tuesdays at 9:30AM Pacific Time ([your time](https://www.thetimezoneconverter.com/?t=9%3A30%20am&tz=San%20Francisco)).
Minutes are taken at [Hackmd.io](https://hackmd.io/5XWHyOoLTRqyXzEHsVmxXg).