Voilà#
To deploy an app first create an account.
Voila applications#
To deploy an application you need two files:
A Jupyter notebook file (
.ipynb)A dependencies file (
requirements.txt)
For information on how to write Voilà applications, please check the documentation.
Note that the application will run with Python 3.11. Refer to this section for customized deployments.
Here is a sample Docker-based Voila application.
Dependencies#
To deploy a new project, list your dependencies in a (requirements.txt). For example, if you’re using JupySQL, pandas and matplotlib, your requirements.txt file will look like this:
# sample requirements.txt
jupysql
pandas
matplotlib
Deploy#
Deploy from the menu
Once you have all your files, create a zip file.
To deploy a Voilà app from the deployment menu, follow these instructions:
Try an example
To download and deploy an example Voila application start by installing Ploomber Cloud and setting your API key:
pip install ploomber-cloud
ploomber-cloud key YOUR-KEY
Tip
If you don’t have an API key yet, follow the instructions here.
Now, download an example. It will prompt you for a location to download the app. To download in the current directory, just press enter.
ploomber-cloud examples voila/chat-with-csv
You should see a confirmation with instructions on deploying your app. Now, navigate to your application:
cd location-you-entered/chat-with-csv
Deploy from the CLI
Initialize and deploy your app with:
ploomber-cloud init
ploomber-cloud deploy --watch
Tip
To ensure your app doesn’t break on re-deployments, pin your dependencies.
Features#
Ploomber Cloud supports many features to help you build Voilà applications quickly!
Integration with GitHub
Safely store secrets such as API keys
Add password protection to your app
Usage analytics such as unique visitors, total requests, etc.
Spin up larger resources (CPUs and RAM)
Spin up GPUs
Add custom domains or subdomains to your application
Task queues to scale applications to more users
