satnogs-wut/README-voila.md

# Voila

Voila is a way to turn Jupyter notebooks into web applications.

# Install
Start with basic Debian Buster install.

```
# set up partitions
# XXX deps...
sudo apt update
sudo apt install apache2 python3-certbot-apache python3-pip sshfs
certbot
systemctl restart apache2
adduser wut
sudo su - wut
pip3 install --upgrade pip
# make sure new `pip3` at `~/.local/bin/pip3` is in front in `$PATH`.
logout #log back in
sudo su - wut
pip3 install --user --upgrade setuptools
pip3 install --user simplejson
pip3 install --user pillow
pip3 install --user tensorflow
pip3 list | grep tensorflow
pip3 install --user voila
pip3 install --user ipywidgets
pip3 install --user matplotlib
# probably not needed
pip3 install --user sklearn
pip3 install --user seaborn
# set up hosts file, network, etc.
# set up apache proxy
# start voila
```

# Misc
Other deps, perhaps used, needed.

* https://ipywidgets.readthedocs.io/en/stable/user_install.html

To enable Jupyter widgets:

```
apt install npm nodejs
jupyter nbextension enable --py widgetsnbextension
jupyter labextension install @jupyter-widgets/jupyterlab-manager
```
Misc:
```
pip3 install --user ipython_blocking
```

# wut?
Site:

* https://wut.spacecruft.org