File size: 1,302 Bytes
46fc829
 
4d11725
 
46fc829
5855eff
85807c3
fe0b56a
46fc829
62499b7
4b91b40
62499b7
1300f6d
1bd5560
 
9d1ab18
62499b7
4b91b40
ae17afc
4b91b40
 
 
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
---
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.