# Jupyter Dash
[![Binder](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/plotly/jupyter-dash/master?urlpath=tree/notebooks/getting_started.ipynb)
This library makes it easy to develop Plotly Dash apps interactively from within Jupyter environments (e.g. classic Notebook, JupyterLab, Visual Studio Code notebooks, nteract, PyCharm notebooks, etc.).
![jupterlab example](https://user-images.githubusercontent.com/15064365/82324108-150d4200-99a7-11ea-8d22-5c1bb8acaadb.gif)
See the [notebooks/getting_started.ipynb](https://github.com/plotly/jupyter-dash/blob/master/notebooks/getting_started.ipynb) for more information and example usage.
# Installation
You can install the JupyterDash Python package using pip...
```
$ pip install jupyter-dash
```
or conda
```
$ conda install -c conda-forge -c plotly jupyter-dash
```
## JupyterLab support
When used in JupyterLab, JupyterDash depends on the [`jupyterlab-dash`](https://www.npmjs.com/package/jupyterlab-dash) JupyterLab extension, which requires JupyterLab version 2.0 or above.
This extension is included with the Python package, but in order to activate it JupyterLab must be rebuilt. JupyterLab should automatically produce a popup dialog asking for permission to rebuild, but the rebuild can also be performed manually from the command line using:
```
$ jupyter lab build
```
To check that the extension is installed properly, call `jupyter labextension list`.
## Colab support
As of version 0.3.0, `JupyterDash` works in Colab with no additional configuration. Just install `jupyter-dash` using pip in a Colab notebook cell
```
!pip install jupyter-dash
```
# Features
To learn more about the features of JupyterDash, check out the [announcement post](https://medium.com/plotly/introducing-jupyterdash-811f1f57c02e).
# Development
To develop JupyterDash, first create and activate a virtual environment using virtualenv or conda.
Then clone the repository and change directory to the repository root:
```
$ git clone https://github.com/plotly/jupyter-dash.git
$ cd jupyter-dash
```
Then install the dependencies:
```
$ pip install -r requirements.txt -r requirements-dev.txt
```
Then install the Python package in editable mode. Note: this will require [nodejs](https://nodejs.org/en/) to be installed.
```
$ pip install -e .
```
Then install the classic notebook extension in development mode:
```
$ jupyter nbextension install --sys-prefix --symlink --py jupyter_dash
$ jupyter nbextension enable --py jupyter_dash
```
Then install the JupyterLab extension in development mode:
```
$ jupyter labextension link extensions/jupyterlab
```
For release, build the JupyterLab extension to bundle with the Python package (see [RELEASE.md](https://github.com/plotly/jupyter-dash/blob/master/RELEASE.md) for the full process):
```
$ python setup.py build_js
```
Raw data
{
"_id": null,
"home_page": "https://github.com/plotly/jupyter-dash",
"name": "jupyter-dash",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.5",
"maintainer_email": "",
"keywords": "",
"author": "Plotly",
"author_email": "",
"download_url": "https://files.pythonhosted.org/packages/d6/49/1f99474c4d22c7bc05a96ee9d1301ed5eda6aee27f0bce0d9761f3759e49/jupyter-dash-0.4.2.tar.gz",
"platform": null,
"description": "# Jupyter Dash\n[![Binder](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/plotly/jupyter-dash/master?urlpath=tree/notebooks/getting_started.ipynb)\n\nThis library makes it easy to develop Plotly Dash apps interactively from within Jupyter environments (e.g. classic Notebook, JupyterLab, Visual Studio Code notebooks, nteract, PyCharm notebooks, etc.).\n\n![jupterlab example](https://user-images.githubusercontent.com/15064365/82324108-150d4200-99a7-11ea-8d22-5c1bb8acaadb.gif)\n\nSee the [notebooks/getting_started.ipynb](https://github.com/plotly/jupyter-dash/blob/master/notebooks/getting_started.ipynb) for more information and example usage.\n\n# Installation\nYou can install the JupyterDash Python package using pip...\n```\n$ pip install jupyter-dash\n```\nor conda\n```\n$ conda install -c conda-forge -c plotly jupyter-dash\n```\n\n## JupyterLab support\nWhen used in JupyterLab, JupyterDash depends on the [`jupyterlab-dash`](https://www.npmjs.com/package/jupyterlab-dash) JupyterLab extension, which requires JupyterLab version 2.0 or above.\n \nThis extension is included with the Python package, but in order to activate it JupyterLab must be rebuilt. JupyterLab should automatically produce a popup dialog asking for permission to rebuild, but the rebuild can also be performed manually from the command line using:\n \n ```\n$ jupyter lab build\n```\n\nTo check that the extension is installed properly, call `jupyter labextension list`.\n\n## Colab support\nAs of version 0.3.0, `JupyterDash` works in Colab with no additional configuration. Just install `jupyter-dash` using pip in a Colab notebook cell\n```\n!pip install jupyter-dash\n```\n\n# Features\nTo learn more about the features of JupyterDash, check out the [announcement post](https://medium.com/plotly/introducing-jupyterdash-811f1f57c02e).\n\n# Development\nTo develop JupyterDash, first create and activate a virtual environment using virtualenv or conda.\n\nThen clone the repository and change directory to the repository root:\n```\n$ git clone https://github.com/plotly/jupyter-dash.git\n$ cd jupyter-dash\n```\n\nThen install the dependencies:\n```\n$ pip install -r requirements.txt -r requirements-dev.txt \n```\n\nThen install the Python package in editable mode. Note: this will require [nodejs](https://nodejs.org/en/) to be installed.\n```\n$ pip install -e .\n```\n\nThen install the classic notebook extension in development mode:\n```\n$ jupyter nbextension install --sys-prefix --symlink --py jupyter_dash\n$ jupyter nbextension enable --py jupyter_dash\n```\n\nThen install the JupyterLab extension in development mode:\n```\n$ jupyter labextension link extensions/jupyterlab\n```\n\nFor release, build the JupyterLab extension to bundle with the Python package (see [RELEASE.md](https://github.com/plotly/jupyter-dash/blob/master/RELEASE.md) for the full process):\n\n```\n$ python setup.py build_js\n```\n\n\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Dash support for the Jupyter notebook interface",
"version": "0.4.2",
"project_urls": {
"Github": "https://github.com/plotly/jupyter-dash",
"Homepage": "https://github.com/plotly/jupyter-dash"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "38622c51aeb18c6d765c03c911e4d70f029ccb9de1a991d88cf30e362d2433c9",
"md5": "cd632d8932636c06fbb145f0ecabdc4f",
"sha256": "b07d90ccf38d4dfb04efd630a2b2627f367b79fa4296ee3912d0c4e21e73e9b2"
},
"downloads": -1,
"filename": "jupyter_dash-0.4.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "cd632d8932636c06fbb145f0ecabdc4f",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.5",
"size": 23566,
"upload_time": "2022-04-01T20:05:08",
"upload_time_iso_8601": "2022-04-01T20:05:08.382457Z",
"url": "https://files.pythonhosted.org/packages/38/62/2c51aeb18c6d765c03c911e4d70f029ccb9de1a991d88cf30e362d2433c9/jupyter_dash-0.4.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "d6491f99474c4d22c7bc05a96ee9d1301ed5eda6aee27f0bce0d9761f3759e49",
"md5": "91f7fa23a63cece012e0f5bb8866b634",
"sha256": "d546c7c25a2867c14c95a48af0ad572803b26915a5ce6052158c9dede4dbf48c"
},
"downloads": -1,
"filename": "jupyter-dash-0.4.2.tar.gz",
"has_sig": false,
"md5_digest": "91f7fa23a63cece012e0f5bb8866b634",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.5",
"size": 17888,
"upload_time": "2022-04-01T20:05:10",
"upload_time_iso_8601": "2022-04-01T20:05:10.464572Z",
"url": "https://files.pythonhosted.org/packages/d6/49/1f99474c4d22c7bc05a96ee9d1301ed5eda6aee27f0bce0d9761f3759e49/jupyter-dash-0.4.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2022-04-01 20:05:10",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "plotly",
"github_project": "jupyter-dash",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [
{
"name": "dash",
"specs": []
},
{
"name": "requests",
"specs": []
},
{
"name": "flask",
"specs": []
},
{
"name": "retrying",
"specs": []
},
{
"name": "ipython",
"specs": []
},
{
"name": "ipykernel",
"specs": []
},
{
"name": "ansi2html",
"specs": []
},
{
"name": "nest-asyncio",
"specs": []
}
],
"lcname": "jupyter-dash"
}