README.md

---
title: Livebook
emoji: 📓
colorFrom: red
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.

There's only one caveat about 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.