ascend-npu-driver-install

Installation
SKILL.md

Ascend NPU Driver & Firmware Auto-Install

该技能为提供端到端自动化的NPU驱动和固件安装能力,覆盖从安装包校验到驱动生效验证的全流程,无需手动分步操作,严格遵循昇腾官方安装规范,适配主流Linux发行版。

核心能力

  1. 基于官方正则自动提取指定文件夹内的驱动/固件包,强制校验包数量唯一性,仅允许1个驱动包+1个固件包;
  2. 安装包可执行权限按需赋权,无权限时自动执行chmod +x并二次校验赋权结果,避免权限问题导致安装失败;
  3. Python+Shell双重包校验,提前验证包格式、路径、文件有效性,拦截无效安装包;
  4. 系统依赖先验后装
  5. 严格按昇腾官方先驱动后固件顺序安装,安装后提供交互式重启选项+官方npu-smi原生命令验证驱动状态。

前置准备

  • 该版本无需校验系内核,直接进行部署即可

1. 脚本文件准备

将核心脚本check_package.py(Python包校验)和install_npu_driver.sh(Shell主安装)放在同一目录,本技能的根目录建议命名为ascend-npu-driver-install,与name字段保持一致。

2. 安装包要求

指定的安装包文件夹内仅存放1个符合昇腾官方命名格式的驱动.run包和1个固件.run包,无其他无关文件,包名格式严格遵循:

  • 驱动包:Ascend-hdk-<chip_type>-npu-driver_<version>_linux-<arch>.run
  • 固件包:Ascend-hdk-<chip_type>-npu-firmware_<version>.run
Related skills

More from ascend/agent-skills

Installs
50
GitHub Stars
14
First Seen
Apr 3, 2026