README.md

metadata

title: Livebook
emoji: 📓
colorFrom: pink
colorTo: purple
sdk: docker
fullWidth: true
pinned: true

You can install and run Livebook inside a Hugging Face Space. Here's how you can do it:

1. Duplicate the Livebook Space to your account (by clicking on the [︙] in the top right and choosing "Duplicate this Space")
2. Create a secret inside your new Space with the name LIVEBOOK_PASSWORD and set the secret value to a password of your choice with at least 12 characters
3. (Optional) If you plan to use GPU Hardware, also set a secret named XLA_TARGET to cuda118
4. Restart the Space

Hugging Face will start Livebook inside your Space. Livebook will show you a login page, and you can use the value you set for the LIVEBOOK_PASSWORD Space secret.

The following caveats apply to running Livebook inside a Hugging Face Space:

• The Space's visibility setting must be public. Otherwise, Smart Cells won't work. That said, your Livebook instance will still be behind Livebook authentication since you've set the LIVEBOOK_PASSWORD secret.
• Configuration and "Settings" done in Livebook will be lost once the instance restarts. Consider using the desktop app if you find yourself in need to persist configuration across deployments.