voila-dashboards /voila
Voilà turns Jupyter notebooks into standalone web applications
★ 5,956⑂ 529👁 75⑃ 782● 769▤ 57
+0
Daily
5,956
stars
529
forks
75
watchers
782
prs
769
issues
57
releases
README
!voila Rendering of live Jupyter notebooks with interactive widgets. Introduction Voilà turns Jupyter notebooks into standalone web applications. Unlike the usual HTML-converted notebooks, each user connecting to the Voilà tornado application gets a dedicated Jupyter kernel which can execute the callbacks to changes in Jupyter interactive widgets. - By default, Voilà disallows execute requests from the front-end, preventing execution of arbitrary code. - By default, Voilà runs with the strip_sources option, which strips out the input cells from the rendered notebook. Installation Voilà can be installed with the mamba (or conda) package manager from conda-forge mamba install -c conda-forge voila or from PyPI pip install voila JupyterLab preview extension Voilà provides a JupyterLab extension that displays a Voilà preview of your Notebook in a side-pane. Starting with JupyterLab 3.0, the extension is automatically installed after installing voila with pip install voila. If you would like to install the extension from source, run the following command. jupyter labextension install @voila-dashboards/jupyterlab-preview Usage As a standalone tornado application To render the bqplot example notebook as a standalone app, run voila bqplot.ipynb. To serve a directory of jupyter notebooks, run voila with no argument. For example, to render the example notebook bqplot.ipynb from this repository with Voilà, you can first update your current environment with the requirements of this notebook (in this case in a conda environment and render the notebook with mamba env update -f .binder/environment.yml cd notebooks/ voila bqplot.ipynb For more command line options (e.g., to specify an alternate port number), run voila --help. As a server extension to notebook or jupyter_server Voilà can also be used as a Jupyter server extension, both with the notebook server or with jupyter_server. To install the Jupyter server extension, run jupyter serverextension enable voila jupyter server extension enable voila When running the Jupyter server, the Voilà app is accessible from the base url suffixed with voila. Documentation To get started with using Voilà, check out the full documentation: https://voila.readthedocs.io/ Examples The following two examples show how a standalone Jupyter notebook can be turned into a separate app, from the command-line integration. Rendering a notebook including interactive widgets and rich mime-type rendering !Voilà basics Rendering a notebook making use of a custom widget library (bqplot) !Voilà bqplot Showing the source code for a Voilà notebook The sources of the Jupyter notebook can be displayed in a Voilà app if option strip_sources is set to False. !Voilà sources Voilà dashboards with other language kernels\\ Voilà is built upon Jupyter standard formats and protocols, and is agnostic to the programming language of the notebook. In this example, we present an example of
Top issues
#112voila on jupyterhub (or on a public cloud instance)46 comments · 2019-04-13#1428Rendering stuck randomly39 comments · 2023-12-10#1107Using --enable_nbextensions=True in v0.3.2 shows an error in console27 comments · 2022-03-08#171Make it possible to hide markdown cells24 comments · 2019-06-02#216Can I choose who can read/run my voila notebooks?21 comments · 2019-06-11#532Use of display after notebook execution does not show20 comments · 2020-01-29#864How to programmatically quit Voilà?19 comments · 2021-03-26#431Updating view in the background with threads16 comments · 2019-10-15
Discussions
#1545Stop rendering if e.g. JWT Token is not present0 comments · 2025-10-13#1531How did you configure your binder to work with voila ?1 comments · 2025-06-07#1517Notebook as a REST Server with voila possible?2 comments · 2025-02-12#1455Some simple questions concerning Voila6 comments · 2024-03-29#1448Voila - All URLs being hit0 comments · 2024-03-07#1440Path traversal vulnerability on voila instance1 comments · 2024-01-22#1376Questions1 comments · 2023-08-10#1351How to set up Social Media meta tags for Voila Dashboards hosted as dockerized container (Open Graph Protocol)2 comments · 2023-07-24
Latest release
v0.5.13 v0.5.13 2026-09-040.5.13 (Full Changelog) Enhancements made - request confirmation before rendering untrusted notebook 1560 (@trungleduc, @martinRenou) Bugs fixed - Patching the reveal template to fix ipywidgets 8 support there + fix CI 1561 (@martinRenou, @trungleduc) Other merged PRs - Point to GH gallery page 1558 (@Haleshot, @MalteIwanicki, @trungleduc) Contributors to this release The following people contributed discussions, new ideas, code and documentation contributions, and review. See our definition of contributors. (GitHub contributors page for this release) @Haleshot (activity) | @Mal