hyperpod-nccl

Community

Diagnose and debug NCCL failures on HyperPod GPU clusters

Authorhaozhx23
Version1.0.0
Installs0

System Documentation

What problem does it solve?

This Skill helps diagnose and debug NCCL failures on HyperPod GPU clusters, including training hangs, AllReduce/collective-op timeouts, EFA or libfabric errors, rendezvous failures, and other related issues.

Core Features & Use Cases

  • NCCL Diagnostics: Identify and diagnose NCCL failures, including timeouts, rendezvous issues, and version mismatches.
  • Infrastructure Checks: Validate cluster health, security group rules, and Kubernetes node readiness.
  • Hardware Health: Check GPU and EFA hardware health, including XID errors, ECC, and NVLink issues.
  • Use Case: If your training job on HyperPod suddenly stops, use this Skill to identify the root cause, such as NCCL timeouts, GPU OOM, or network issues, and take appropriate actions.

Quick Start

Run the hyperpod-nccl skill to diagnose NCCL issues on your cluster.

Dependency Matrix

Required Modules

awsclikubectlpython3unbufferjqnccl-diagnose.sh

Components

scriptsreferences

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: hyperpod-nccl
Download link: https://github.com/haozhx23/HyperPod-InstantStart/archive/main.zip#hyperpod-nccl

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 620,000+ vetted skills library on demand.