hccl-test

Automate HCCL performance testing across Ascend NPU clusters with MPI.

31|1|Updated Mar 28, 2026
One-click install
npx skills add https://github.com/Ascend/agent-skills --skill hccl-test-ascend
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hccl-test
Source: https://github.com/Ascend/agent-skills/tree/main/skills/hccl-test
Command: npx skills add https://github.com/Ascend/agent-skills --skill hccl-test-ascend

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

Automates and validates HCCL performance testing across Ascend NPU clusters, enabling quick assessment of distributed bandwidth and verification of HCCL functionality for common collective operations such as AllReduce and AllGather.

Core Features & Use Cases

  • Pre-flight multi-node checks (SSH access, CANN version consistency, and NPU health) to ensure a reliable test environment.
  • MPI installation guidance, environment setup, and multi-node test orchestration for core operators (AllReduce, AllGather, AlltoAll, Broadcast) and optional V-series operators.
  • Production-ready workflows including result parsing and logging to support performance benchmarking and regression checks.

Quick Start

Run the quick verification script to perform a baseline HCCL test.

Frequently Asked Questions about hccl-test

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I benchmark HCCL performance across multi-node Ascend NPU clusters?

Automate HCCL performance testing across Ascend NPU clusters by coordinating multi-node benchmarks via MPI, assessing distributed bandwidth for common collective operations like AllReduce and AllGather.

What pre-flight checks are needed before running distributed HCCL tests?

Pre-flight checks for HCCL testing require verifying SSH access across nodes, ensuring CANN version consistency, and checking NPU health to guarantee a reliable multi-node test environment.

Does HCCL testing support both MPICH and Open MPI implementations?

HCCL testing supports both MPICH and Open MPI implementations, applying MPI-based execution to orchestrate core collective operations and parse performance results across multi-node environments.

What collective operations can I validate using automated HCCL multi-node testing?

Validate HCCL functionality for collective operations including core operators like AllReduce, AllGather, AlltoAll, and Broadcast, as well as optional V-series operators across Ascend NPUs.

Why does my HCCL multi-node test fail during environment setup?

HCCL multi-node tests often fail due to inconsistent CANN versions, lack of SSH access between nodes, or missing MPI installations, which pre-flight checks are designed to catch before execution.