返回 文章 apply CMS 文章

AWS Trainium 模型支持查询工具上线

快速查询模型在 AWS Trainium 上的运行支持情况,并获取可复现的运行脚本。

AWS TrainiumTorchNeuron模型支持Hugging Face
成长分 / 100 73 综合收获、行动、留存与影响

AWS Trainium 模型支持查询工具上线
为什么值得读了解如何验证 Transformers 模型是否能在 AWS Trainium 上无需修改地运行。

获取在 Trainium 实例上运行模型的详细步骤和脚本。

关键洞察
  1. torch-neuronx 模型支持 Space 展示了热门模型在 Trainium 上的运行结果,包括分片核心数、运行时间和峰值内存。
  2. Space 提供 Selected、Trending 和 Downloads 视图,可按模型名称搜索,并选择 Neuron 编译器和 Transformers 版本。
  3. 每个模型页面提供运行所需的 Neuron 栈、安装包和 run.py 脚本,脚本使用 from_pretrained 加载模型,并采用静态缓存和 torch.compile(backend="neuron") 生成。
转成行动

深入阅读

正文与原文对照

原文保真覆盖:全文原文字符:4602

在之前的文章中,我们介绍了 TorchNeuron,这是 AWS Trainium 的原生 PyTorch 后端(torch-neuronx 包)。借助它,Transformers 可以像在其他任何设备上一样,在 Trainium 上运行自己的建模代码,因此 Hub 上的任何 Transformers 模型都可能运行。那么哪些模型实际可以运行呢?

torch-neuronx 模型支持 Space 为 Hub 上最热门的模型回答了这个问题。它会告诉你某个模型是否无需修改即可在 Trainium 上运行,并给出让你自己运行的脚本。

torch-neuronx 模型支持

查找模型

该 Space 打开时显示 Selected 视图:这是我们自己挑选的模型,选自 Hub 上按下载量和趋势分数排名靠前的模型。每一行给出结果、模型分片所跨的 Trainium 核心数、运行的挂钟时间(包括编译)以及峰值设备内存。

要查找某个模型,请切换到 Trending 或 Downloads 视图,并输入其名称的一部分。这些视图遵循 Hub 自身的排名,一次一个任务,无论模型是否经过测试。当某个模型被有意排除时,Space 会告诉你原因(大多数情况下是未被优先处理,有时是确实不兼容)。你还可以选择要查看的 Neuron 编译器(neuronx-cc)和 Transformers 版本。

在撰写本文时,仅测试 Transformers 模型,且我们的选择仅限于 text-generation 和 image-text-to-text 模型。我们计划扩展到 diffusers、sentence transformers 以及其他 transformers 任务。

自己运行

选择一个模型以查看如何运行它。Space 会列出该模型测试所用的 Neuron 栈、需要在其上安装的包,以及实际运行的 run.py 脚本。该脚本遵循 TorchNeuron 公告中的配方:它使用 from_pretrained 加载模型,在需要时进行分片,然后使用静态缓存和 torch.compile(backend="neuron") 进行生成。

在使用该栈的 Trainium2(trn2)实例上,例如在 AWS Neuron Deep Learning Container 中,安装这些包,然后运行:

python3 run.py

无需 torchrun:当模型被分片时,脚本会自行启动 torch.distributed 进程。

首次运行会先编译模型的图。要跳过该步骤,请从公共 NEFF 缓存桶中复制测试期间由同一编译器构建的图。Space 会给出命令,并附带正确的编译器版本:

hf buckets sync hf://buckets/aws-neuron/torch-neuronx-neff-cache/neuronxcc-<version> /tmp/neff_cache

“运行”的含义

每个测试都会在 trn2 实例上加载模型,并分片到能容纳其权重的最少数量的 Trainium 核心上。大多数模型使用张量并行进行分片。没有张量并行方案的专家混合模型仅使用专家并行。然后测试生成 32 个 token 并对其进行检查。在单核上,这些 token 会与同一检查点的 CPU 运行结果进行比较。当模型被分片时,一个小型评判模型会检查文本是否为流利的英语。

在撰写本文时,仅测试能容纳在 4 个 Trainium2 设备上的模型,这意味着最多 16 个核心。PASS 并不说明吞吐量,也不说明更长的生成情况。

结果是一个数据集

Space 显示的所有内容都来自公共 aws-neuron/torch-neuronx-model-support 数据集,每对 neuronx-cc 和库版本对应一个 Parquet 文件。

每一行包含模型的结果、失败时的错误、整个栈的版本以及实际运行的 run.py。你可以直接查询它:

import pandas as pd

df = pd.read_parquet("hf://datasets/aws-neuron/torch-neuronx-model-support/data")
df[df.model_id == "Qwen/Qwen3-0.6B"][["neuronx_cc", "library", "library_version", "neuron_cores", "result"]]

数据集卡片给出了每个结果的确切含义。

下次你想知道某个模型是否能在 Trainium 上运行时,查一下。