NCCL Cluster Visualizer

NCCL Cluster Visualizer

根据 NCCL XML 转储文件画出你的 GPU 集群图，显示带 NVLink 的 PCIe 和 NUMA 树，或者 NCCL 选择的 NVLink 环。适合运行多 GPU 训练的工程师。

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

简介

它是什么：NCCL Cluster Visualizer 是一个 Gradio 应用，把 NCCL XML 转储文件变成你的 GPU 集群的示意图。它接受两种转储类型，并根据文件的根元素区分它们。仓库里自带两份在装有 H100 GPU 的机器上采集的示例转储。

适合谁：运行分布式 GPU 任务、想看看机器怎样连接以及 NCCL 选了哪些路径的工程师。

Industry | Who uses it | How they use it | Example
机器学习 | 训练工程师 | 检查 GPU、NVLink 和 NVSwitch 怎样连接 | 一个训练节点的拓扑转储
基础设施 | 集群管理员 | 确认 NCCL 选择了哪些链路和速度 | 一次运行变慢之后的图转储
研究 | 系统研究者 | 对比不同机器之间的通信布局 | 两个接线不同的节点
教育 | 高性能计算的学生 | 了解多 GPU 节点内部是什么样子 | 自带的 H100 转储

如果你不用 NCCL 或多 GPU 机器，可以跳过它。

用在哪里：

• 网页浏览器，在 Hugging Face 上这个 Space 的页面里
• 装有 Python 的 Windows、macOS 或 Linux，用下载下来的副本
• 运行你的 NCCL 任务的那台机器，转储文件就是在那里生成的

Use case | Who | What they get back
拓扑视图 | 集群管理员 | 一棵由 PCIe 和 NUMA 部件组成的树，绿线表示通向 NVSwitch 的 NVLink
环与通道视图 | 训练工程师 | NCCL 选择的 NVLink 环和通道，带有速度和链路类型
试用 | 新手 | 用仓库里的示例转储画出的图

如何设置：

• 你的电脑上装好 Python
• requirements.txt 里的 Python 软件包，包括 Gradio 5.34.2
• 一次 NCCL 运行产生的转储文件，或者自带的两个示例

1. 安装 Hugging Face hub 软件包。
2. 用 hf 命令下载这个 Space。
3. 进入下载好的文件夹。
4. 先安装 Gradio 5.34.2，再安装依赖。
5. 启动 app.py。

pip install -U huggingface_hub
hf download nouamanetazi/nccl-cluster-visualizer --repo-type space --local-dir nccl-cluster-visualizer
cd nccl-cluster-visualizer
pip install gradio==5.34.2
pip install -r requirements.txt
python app.py

如何使用：用下面的设置把你的分布式脚本运行一次，让 NCCL 写出两个转储文件。然后把 nccl-topo.xml 或 nccl-graphs.xml 这两个文件之一交给应用。

NCCL_DEBUG=INFO NCCL_DEBUG_SUBSYS=INIT,GRAPH,NET \
NCCL_TOPO_DUMP_FILE=nccl-topo.xml \
NCCL_GRAPH_DUMP_FILE=nccl-graphs.xml \
  python your_distributed_script.py

Tool | What it does
nccl-topo.xml | 拓扑转储，应用把它画成 PCIe、NUMA 和 NVLink 树
nccl-graphs.xml | 图转储，应用把它画成 NVLink 环和通道

示例：你把自带的 nccl-topo.xml 拖进应用。它画出 H100 节点的 PCIe 和 NUMA 树，用绿线表示通向 NVSwitch 网络的 NVLink 连线。

新手与专家：先用那两份示例转储，这样在自己生成之前就能看到结果。拓扑转储显示硬件怎样连接，图转储显示 NCCL 决定使用的路径。

应用读取根元素来区分转储，拓扑用 system，图转储用 graphs。它们分别来自 NCCL_TOPO_DUMP_FILE 和 NCCL_GRAPH_DUMP_FILE 这两个设置。来源没有说集群规模的限制或速度，所以请在你自己的转储上测试。

NCCL 在运行时写出 XML 转储
你把文件拖进应用
根元素决定转储类型
应用画出集群示意图

注意事项：

• 用 Gradio 5.34.2 构建
• 支持两种转储类型，通过根元素识别
• License: mit
• Cost to run: 没有提到
• Data it reaches: 你给它的 NCCL 转储文件
• Not for: NCCL 拓扑和图转储以外的文件

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

• 点赞：1
• 构建方式：gradio
• 许可证：mit

链接

• Space：https://huggingface.co/spaces/nouamanetazi/nccl-cluster-visualizer
• 文件：https://huggingface.co/spaces/nouamanetazi/nccl-cluster-visualizer/tree/main

试用

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