The Ultra-Scale Playbook

The Ultra-Scale Playbook

讲解如何在大型 GPU 集群上训练大语言模型，是一份在浏览器里阅读的网页指南，文件里还附有 PDF 副本。适合运行或规划大型训练任务的工程师和研究人员。

由 nanotron 在 Hugging Face 上制作。这些说明是 Mindket 根据它的 Space 页面和 README 写的，应用自己的文件和许可证在 Hugging Face 上。

简介

它是什么：The Ultra-Scale Playbook 是一份在大型 GPU 集群上训练大语言模型的指南。它是一个在浏览器里阅读的网页，由仓库里的源文件构建，旁边还放着这份指南的 PDF 副本。

适合谁：它适合训练或打算在多块 GPU 上训练大模型的人，也适合想通过一份长指南学习这个领域的人。

行业 | 谁在用 | 怎么用 | 例子
AI 研究 | 研究人员 | 在规划大型训练任务之前先读这份指南 | 打开页面，从头读起
机器学习工程 | 机器学习工程师 | 搭建 GPU 集群时把它当作参考 | 打开仓库里的 PDF 副本
教育 | 学生 | 了解大模型训练是怎么组织的 | 一节一节地读完页面
网页发布 | 前端开发者 | 研究页面如何由片段拼装而成 | 阅读 src 里的文件和 webpack 配置

如果你想要一个可运行的软件工具，可以跳过它，因为这是阅读材料，加上页面背后的代码。

用在哪里：

• 浏览器：打开 Hugging Face 上这个 Space 的页面
• 本地副本：在 Windows、macOS 或 Linux 上，从 dist/index.html 打开
• 仓库自带的 PDF 副本

使用场景 | 谁用 | 得到什么
在线阅读指南 | 工程师 | 完整页面，不需要安装任何东西
保留离线副本 | 学生 | 电脑上的文件，包括 PDF
修改页面 | 网页开发者 | 一个可以在 src 里编辑并重新构建的版本

如何设置：在线阅读只需要浏览器。本地副本需要 Python 来获取文件。编辑页面还需要带 npm 的 Node 和 Git LFS。

• 一个网页浏览器
• Python 和 pip，用来获取文件
• 带 npm 的 Node 和 Git LFS，仅在你想修改页面时需要

1. 安装 Hugging Face hub 库。
2. 把 Space 的文件下载到名为 ultrascale-playbook 的文件夹。
3. 进入该文件夹。
4. 在浏览器中加载 dist/index.html。

pip install -U huggingface_hub
hf download nanotron/ultrascale-playbook --repo-type space --local-dir ultrascale-playbook
cd ultrascale-playbook

要编辑页面，在项目文件夹里使用下面这些命令。

# fetch LFS-tracked files (large assets)
git lfs pull

npm install
npm run build
npm run dev

如何使用：在浏览器里阅读指南。如果你要编辑，就修改 src 下的文件，运行构建，然后提交 dist 文件夹。

工具 | 作用
git lfs pull | 获取仓库用 LFS 跟踪的大文件
npm install | 安装页面构建所需的东西
npm run dev | 以开发方式运行页面，并在控制台列出可用的片段
npm run build | 把页面从 src 构建到 dist，然后你再提交它

示例：你想在页面上加一个横幅。你在 src/fragments 下新建一个名为 banner.html 的文件，把它的占位符放进 src/index.html，运行开发命令，再确认控制台列出了新的片段。

新手与专家：打开页面，从头读起。这不需要任何设置，仓库里的 PDF 副本包含同一份指南，可以离线阅读。

页面由 HTML 片段组成，片段有两种加载方式。编译期片段会烤进构建出的 HTML，所以每位访客在加载后立刻就能看到。运行期片段稍后才获取并插入，这样最终的 HTML 保持较小，最好在 1MB 以内。代价是运行期片段会比页面晚一会儿出现。仓库里还有转换脚本和这份指南的 markdown 源文件。

在 src 里编辑文件
运行 npm run dev 并查看控制台
运行 npm run build
提交 dist 文件夹
打开 dist/index.html

注意事项：

• 规模：仓库有 383 个文件，大型资源用 Git LFS 跟踪。
• 空缺：来源描述的是构建过程，没有描述指南的章节。
• License：apache-2。
• Cost to run：未提及。
• Data it reaches：只有本地文件。页面在浏览器里运行，来源没有提到账号或密钥。

Hugging Face 上的数据（2026年11月13日）

• 点赞：4,131
• 构建方式：static
• 许可证：apache-2.0

链接

• Space：https://huggingface.co/spaces/nanotron/ultrascale-playbook
• 文件：https://huggingface.co/spaces/nanotron/ultrascale-playbook/tree/main

试用

在浏览器里打开这个 Space，或在它的页面上把它复制到你自己的 Hugging Face 账号。这个工具包里没有会自己运行的东西。