| name | external-gitcode-ascend-cann-nnal-installer |
| description | 昇腾NPU CANN Toolkit+Kernels+NNAL安装部署技能。支持从官网下载run包安装和从Docker镜像提取两种方式，覆盖驱动检查、包下载、安装、环境变量配置与验证全流程。当用户需要安装CANN全套组件或指定版本CANN到自定义路径时调用。 |
| keywords | ["cann","nnal","toolkit","kernels","installer","昇腾","ascend","环境搭建"] |
| metadata | {"short-description":"安装CANN Toolkit、Kernels、NNAL到指定路径，支持run包和Docker镜像两种安装方式。","why":"CANN是昇腾NPU开发的基础软件栈，但安装流程涉及多个组件和严格顺序，容易出错。","what":"提供CANN Toolkit+Kernels+NNAL的端到端安装指导，支持离线run包安装和Docker镜像提取两种方式。","how":"按照驱动检查→下载→安装(Toolkit→Kernels→NNAL)→环境变量配置→验证的固定流程执行。","results":"产出安装验证报告，确认Toolkit/Kernels/NNAL版本正确、环境变量生效、bisheng/atc等工具可用。","version":"1.0.0","updated":"2026-04-16T00:00:00Z","jtbd-1":"当用户需要在新环境或Docker容器中安装指定版本的CANN Toolkit+Kernels+NNAL时。","jtbd-2":"当用户需要将CANN安装到自定义路径（非默认/usr/local/Ascend）时。","jtbd-3":"当用户因官网下载链接需要登录认证而无法直接wget获取CANN安装包时。","skill-type":"env-setup"} |
| allowed-tools | Bash(*) |
| original-name | cann-nnal-installer |
| synced-from | https://gitcode.com/Ascend/agent-skills |
| synced-date | 2026-05-26 |
| synced-commit | 1f7666e7768a0ceb21bb1d40ce4b5179fcb6f1d6 |
| license | UNKNOWN |
CANN Toolkit+Kernels+NNAL 安装部署
在昇腾NPU环境中安装CANN完整组件（Toolkit、Kernels、NNAL）到指定路径。
核心原则：安装顺序必须为 Toolkit → Kernels → NNAL，不可颠倒。NNAL依赖Toolkit的环境变量。
调用时机
- 用户要求安装CANN（含toolkit、kernels、nnal）
- 用户需要将CANN安装到自定义路径
- 用户在Docker容器中搭建昇腾开发环境
- 用户需要安装特定版本的CANN（如9.0.0-beta.2）
前置检查
第1步：检查NPU驱动
npu-smi info
预期结果：输出NPU设备信息（芯片型号、显存等）。
异常处理：如果 command not found，需先安装昇腾驱动和固件，参考 ascend-npu-driver-install 技能。
第2步：确认芯片型号
从 npu-smi info 输出中获取芯片型号，用于选择对应的Kernels包：
| 芯片型号 | Kernels包名后缀 |
|---|
| 910B / 910B3 | 910b |
| 910 | 910 |
| 310P | 310p |
| 310B | 310b |
第3步：确认系统架构
uname -m
aarch64：ARM架构，选择 _linux-aarch64.runx86_64：x86架构，选择 _linux-x86_64.run
安装方式一：从官网下载run包安装
第4步：获取CANN安装包
访问昇腾社区下载中心获取安装包：
https://www.hiascend.com/developer/download/community/result?module=cann&cann=<版本号>
需要下载的包（3个）：
| 包名 | 格式 | 说明 |
|---|
Ascend-cann-toolkit_<版本>_linux-<架构>.run | run包 | 开发工具包（必须先安装） |
Ascend-cann-kernels-<芯片>_<版本>_linux-<架构>.run | run包 | 算子库（依赖Toolkit） |
Ascend-cann-nnal_<版本>_linux-<架构>.run | run包 | 加速库（依赖Toolkit环境变量） |
注意：官网下载链接需要登录认证，无法直接 wget。替代方案：
