README.md

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

You can install and run [Livebook](https://livebook.dev/) 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](https://livebook.dev/) if you find yourself in need to persist configuration across deployments.