# Spaces 上的 Livebook

**Livebook** 是一款用于在 [Elixir](https://elixir-lang.org/) 中编写交互式代码笔记本的开源工具。它是不断壮大的 Elixir [数值计算](https://github.com/elixir-nx/nx)、[数据科学](https://github.com/elixir-nx/explorer) 和 [机器学习](https://github.com/elixir-nx/bumblebee) 工具集的一部分。

Livebook 最令人兴奋的功能包括：

- **可复现的工作流**：Livebook 以可预测的顺序运行您的代码，直至包管理层面
- **智能单元格**：借助 Livebook 可扩展的笔记本单元格，只需几次点击即可执行复杂任务，例如数据操作和运行机器学习模型
- **由 Elixir 提供支持**：利用 Elixir 编程语言的功能，编写可并发和分布式运行的笔记本，使其规模可扩展至超越单台机器

如需了解更多，请观看这段[15 分钟的视频](https://www.youtube.com/watch?v=EhSNXWkji6o)。或者访问[Livebook 的官方网站](https://livebook.dev/)。也可以关注其[Twitter](https://twitter.com/livebookdev)和[博客](https://news.livebook.dev/)，以获取最新的功能和更新。

## 您的第一个 Livebook Space

只需几次点击，您就可以在 Space 中运行 Livebook。点击下面的按钮，使用 Livebook 的 Docker 模板开始创建一个新的 Space：

    

然后：

1. 为你的 Space 命名
2. 设置您的 Livebook 密码
3. 将其可见性设置为公开
4. 创建你的 Space

![Creating a Livebok Space ](https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/hub/spaces-livebook-new-space.png)

这将开始使用 Livebook 的 Docker 镜像来构建您的 Space。

为了让 Livebook 中的 Smart cells 功能正常运行，Space 的可见性必须设置为 public。不过，您的 Livebook 实例会受到 Livebook 身份验证的保护。

> [!TIP]
> Smart cell 是一种 Livebook 单元格，它提供了一个用于完成特定任务的 UI 组件。该任务的代码会根据用户与 UI 的交互自动生成，从而无需从头编写代码即可更快地完成高级任务。

应用构建完成后，前往您的 Space 中的“App”选项卡，并使用您之前设置的密码登录您的 Livebook：

![Livebook authentication](https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/hub/spaces-livebook-authentication.png)

就是这样！现在你可以在你的 Space 中开始使用 Livebook 了。

如果你是第一次使用 Livebook，可以在 Livebook 内部通过其交互式笔记本学习如何使用它：

![Livebook's learn notebooks](https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/hub/spaces-livebook-learn-section.png)

## 与 Hugging Face Models 的 Livebook 集成

Livebook 提供了与 Hugging Face 模型的[官方集成](https://livebook.dev/integrations/hugging-face)。借助此功能，您只需点击几下即可在 Livebook 中运行各种机器学习模型。

这里有一个简短的视频，演示了如何操作：

## 如何更新 Livebook 的版本

To update Livebook to its latest version, go to the Settings page of your Space and click on "Factory reboot this Space":

![Factory reboot a Space](https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/hub/spaces-livebook-factory-reboot.png)

## 注意事项

在 Space 中运行 Livebook 时，请注意以下事项：

- 该 Space 的可见性设置必须为公开。否则，Smart cells 将无法正常工作。不过，由于您已设置了 `LIVEBOOK_PASSWORD` 密钥，您的 Livebook 实例仍将受到 Livebook 身份验证的保护。
- Space 重启后，Livebook 的全局配置将会丢失。如果您需要在多次部署之间持久化配置，请考虑使用 [桌面应用](https://livebook.dev/#install)。

## 反馈与支持

如果您有改进建议或需要特定支持，请加入 [GitHub 上的 Livebook 社区](https://github.com/livebook-dev/livebook/discussions)。