custom jupyter widgets made easy
Project description
anywidget
custom jupyter widgets made easy
installation .
docs .
discord .
learn
About
anywidget uses modern web standards to simplify authoring and distributing custom Jupyter Widgets.
- 🛠️ create widgets without complicated cookiecutter templates
- 📚 publish to PyPI like any other Python package
- 🤖 prototype within
.ipynbor.pyfiles - 🚀 run in Jupyter, JupyterLab, Google Colab, VSCode, and more
- ⚡ develop with instant HMR, like modern web frameworks
Learn more in the Jupyter blog.
Installation
anywidget is available on PyPI:
pip install "anywidget[dev]"
and also on conda-forge:
conda install -c conda-forge anywidget
Usage
import anywidget
import traitlets
class CounterWidget(anywidget.AnyWidget):
# Widget front-end JavaScript code
_esm = """
function render({ model, el }) {
let button = document.createElement("button");
button.innerHTML = `count is ${model.get("value")}`;
button.addEventListener("click", () => {
model.set("value", model.get("value") + 1);
model.save_changes();
});
model.on("change:value", () => {
button.innerHTML = `count is ${model.get("value")}`;
});
el.appendChild(button);
}
export default { render };
"""
# Stateful property that can be accessed by JavaScript & Python
value = traitlets.Int(0).tag(sync=True)
Front-end code can also live in separate files (recommend):
import pathlib
import anywidget
import traitlets
class CounterWidget(anywidget.AnyWidget):
_esm = pathlib.Path("index.js")
_css = pathlib.Path("styles.css")
value = traitlets.Int(0).tag(sync=True)
Read the documentation to learn more.
Packages
Beyond the primary Python package, anywidget provides an ecosystem of tooling to help you build and distribute custom Jupyter Widgets.
| Name | Description | Version (click for changelogs) |
|---|---|---|
anywidget |
Primary Python package |  |
npm:@anywidget/types |
Client type declarations |  |
npm:@anywidget/vite |
Vite plugin |  |
npm:@anywidget/react |
React framework adapter |  |
npm:@anywidget/svelte |
Svelte framework adapter |  |
npm:create-anywidget |
CLI to bootstrap a new project |  |
jsr:@anywidget/deno |
Backend for Deno Jupyter kernel |  |
Support
Having trouble? Get help in our Discord or open a Discussion.
Contributing
New contributors welcome! Check out our Contributors Guide for help getting started.
Join us on Discord to meet other maintainers. We'll help you get your first contribution in no time!
License
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file anywidget-0.9.13.tar.gz.
File metadata
- Download URL: anywidget-0.9.13.tar.gz
- Upload date:
- Size: 9.7 MB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/5.1.0 CPython/3.11.9
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | c655455bf51f82182eb23c5947d37cc41f0b1ffacaf7e2b763147a2332cb3f07 |
|
| MD5 | fe94edef8ca060f81f7741a631a92d1f |
|
| BLAKE2b-256 | 8779647983b0cbddd797d9d79e09f89ee5912bb066af6bf456bd8acde66b1a39 |
File details
Details for the file anywidget-0.9.13-py3-none-any.whl.
File metadata
- Download URL: anywidget-0.9.13-py3-none-any.whl
- Upload date:
- Size: 213.7 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/5.1.0 CPython/3.11.9
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 43d1658f1043b8c95cd350b2f5deccb123fd37810a36f656d6163aefe8163705 |
|
| MD5 | e58f8a9c6868c8741718f04d482528b1 |
|
| BLAKE2b-256 | 1a5a7b024920cca385eb9b56bc63edf0a647de208346bfac5b339b544733d53a |
