Introduction to Valohai Hosted Notebooks

Valohai allows you to easily launch a cloud hosted notebook.

With them you can:

• run a notebook execution on any standard execution environment that your organisation has enabled
• use the packages and libraries that you need in your job
• install additional packages on the fly
• execute cell-by-cell on a cloud based CPU or GPU machine

Launching a notebook execution

To start a notebook execution:

• go the Notebooks tab in your project
• click "Create notebook execution"
• choose the environment and Docker image for your notebook
  • You can use any standard Docker image. Valohai will try to install Jupyter during the startup, if the image doesn't have Jupyter pre-installed on it.

Optionally you can also define:

• title and tags to easily find your notebooks later on
• add inputs to download files from your data store to the notebook environment.

Once a notebook has been launched and is ready to be used you can use the "Open Notebook" button to connect to your cloud hosted notebook instance.

Stopping a notebook

Hosted Notebooks run for as long as you need them. Once you're done with your notebook and don't need it anymore you can stop it from the Valohai UI, either from Notebooks or the Executions tab.

Valohai will automatically save all changed notebooks as Valohai outputs in the execution that was hosting the notebook. This way you'll be able to continue later on from these checkpoints.

Continue from where you left off

You can copy any past Hosted Notebook execution and click "Copy" to create a new hosted notebook instance. By default, Valohai will mount all the saved snapshots from the execution you're copying.

This allows you to continue from the snapshot of the notebook that was saved when you shut down the notebook.