Skip to main content

Voila apps

Environment requirements

Your conda environment (used in JHub Apps Launcher's App creation form) must have the following packages for successful app deployment:

  • jhsingle-native-proxy >= 0.8.2
  • voila >= 0.5.6
  • Other libraries used in the app
note

In some cases, you may need ipywidgets

Example application

To deploy the Voila Basic Example using JHub Apps, you can use the following code and environment:

Code (Jupyter Notebook)

In a Jupyter Notebook, copy the following lines of code into a cell.

voila-basic-slider.ipynb
import ipywidgets as widgets

slider = widgets.FloatSlider(description='x')
text = widgets.FloatText(disabled=True, description='x^2')

def compute(*ignore):
text.value = str(slider.value ** 2)

slider.observe(compute, 'value')

slider.value = 4

widgets.VBox([slider, text])

You will see a basic slider app as shown in this screenshot:

Simple interactive Voilà app displaying a slider for variable x and its squared value

Environment specification

Use the following spec to create a Conda environment wherever JHub Apps is deployed. If using Nebari, use this spec to create an environment with conda-store.

channels:
- conda-forge
dependencies:
- ipywidgets
- jhsingle-native-proxy>=0.8.2
- pandas
- python
- pip
- pip:
- voila==0.5.6
- ipykernel
note

When voila (>=0.5.6) is available on Conda Forge, it can be moved outside of the pip section of the dependencies

Next steps

Launch app →