一键在 Manus 中运行任何 Skill

开始使用

cann-env-setup

星标4

分支8

更新时间2026年5月25日 12:32

昇腾 NPU 上 CANN 安装与环境配置指导。触发场景：需安装 CANN、配置开发环境或排查安装问题时。

安装

用 Codex 或 Claude 帮你安装复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。

在 Manus 中运行

来源

LingquLab

LingquLab/TileXR

打开 GitHub 仓库查看创作者相关仓库

下载

在 Manus 中运行

CANN开发环境配置

此技能为在昇腾NPU平台上安装CANN（神经网络计算架构）提供全面指导。

调用时机

在以下情况下调用此技能：

用户询问CANN安装
用户需要帮助设置昇腾开发环境
用户遇到CANN安装问题
用户想了解CANN安装方法

安装步骤

第1步：检查驱动是否安装

硬件要求

已安装昇腾NPU设备
设备状态正常

驱动检查命令

npu-smi info

检查结果

如果显示NPU设备信息，说明驱动已安装
记录驱动版本用于后续CANN版本兼容性检查
如果提示"command not found"，需要先安装昇腾驱动

第2步：检查CANN安装依赖

检查CANN安装依赖（Python和pip）是否已安装：

# 检查Python
if ! command -v python3 &> /dev/null && ! command -v python &> /dev/null; then
    echo "Python not found, please install from env_dependence.md"
fi

# 检查pip
if ! command -v pip3 &> /dev/null && ! command -v pip &> /dev/null; then
    echo "pip not found, please install from env_dependence.md"
fi

如果任何依赖缺少，会显示提示信息，请参考环境依赖安装指南进行安装。

第3步：安装CANN

方法一：离线安装

步骤3.1：检查当前文件夹是否存在安装包

# 检查当前文件夹是否存在CANN安装包
if ls Ascend-cann-toolkit_*.run 2>/dev/null | grep -q .; then
    echo "找到CANN Toolkit安装包"
    TOOLKIT_PACKAGE=$(ls Ascend-cann-toolkit_*.run)
else
    echo "未找到CANN Toolkit安装包，请使用在线安装方式"
    # 退出离线安装，建议使用在线安装
    exit 1
fi

# 检查当前文件夹是否存在ops安装包
if ls Ascend-cann-*-ops_*.run 2>/dev/null | grep -q .; then
    echo "找到CANN ops安装包"
    OPS_PACKAGE=$(ls Ascend-cann-*-ops_*.run)
else
    echo "未找到CANN ops安装包，请使用在线安装方式"
    # 退出离线安装，建议使用在线安装
    exit 1
fi

步骤3.2：安装CANN

重要：必须先安装Toolkit，再安装ops

run格式安装：

# 安装 Toolkit (默认路径 /usr/local/Ascend)
bash "$TOOLKIT_PACKAGE" --install --quiet
# 安装 ops
bash "$OPS_PACKAGE" --install --quiet

方法二：在线安装（conda方式）

注意：conda主要用于创建Python虚拟环境，CANN工具包仍需通过离线安装包安装。

步骤3.1：创建conda虚拟环境

# 创建Python环境（CANN支持Python 3.7.x - 3.13.11）
conda create -n cann_env python
# 激活环境
conda activate cann_env

步骤3.2：配置昇腾conda官方源

# 添加昇腾conda源
conda config --add channels https://repo.huaweicloud.com/ascend/repos/conda

步骤3.3：安装CANN包

# 使用conda安装CANN工具包
conda install ascend::cann-toolkit
# 安装CANN ops包（根据芯片类型选择，如910、910b、310等）
conda install ascend::cann-{芯片类型}-ops

方法三：在线安装（yum方式 - CentOS/RHEL）

步骤3.1：配置华为官方源

sudo curl https://repo.oepkgs.net/ascend/cann/ascend.repo -o /etc/yum.repos.d/ascend.repo && yum makecache

步骤3.2：安装CANN包

yum install -y Ascend-cann-toolkit
yum install -y Ascend-cann-{芯片类型}-ops

第4步：环境变量配置

临时设置（仅当前终端生效）

source /usr/local/Ascend/ascend-toolkit/set_env.sh

永久设置（写入Shell配置文件）

echo "source /usr/local/Ascend/ascend-toolkit/set_env.sh" >> ~/.bashrc

第5步：安装验证

使用Python验证ACL接口

python3 -c "import acl;acl.init();acl.rt.set_device(0)"

验证结果

如果执行成功，说明CANN Python接口正常工作
如果执行失败，检查环境变量是否配置正确

第6步：安装运行时依赖

pip3 install attrs cython numpy decorator sympy cffi pyyaml pathlib2 psutil protobuf==3.20.0 scipy requests absl-py --user
pip3 install protobuf==3.20.0

注意事项

版本兼容性：确保CANN版本与驱动版本匹配
安装顺序：必须先安装Toolkit，再安装ops
环境变量：安装后必须设置环境变量
权限问题：某些操作可能需要root权限
依赖包：确保所有必要的依赖包已安装

故障排查

如果安装过程中遇到问题：

检查驱动版本是否与CANN版本兼容
检查依赖包是否安装完整
查看安装日志获取详细错误信息
参考昇腾社区文档或寻求技术支持

参考资料

详细参考资料请查看 reference 目录，包含：

环境依赖安装指南：必需软件安装命令和验证方法

同仓库更多 Skills

同仓库

ascendc-code-review

LingquLab/TileXR

Ascend C 代码检视技能。基于假设检验方法论对代码进行安全规范检视。当用户提供代码片段和检视规则描述时，可使用此技能进行代码检视，使用时必须明确提供：代码片段和检视规则描述。

2026-07-164

commit-push-pr

LingquLab/TileXR

Use when the user wants to commit changes, push to remote, and open a pull request in one step. Triggers on requests like "commit and push", "open a PR", "create pull request", or "ship this".

2026-06-044

ascendc-api-best-practices

LingquLab/TileXR

Ascend C API 使用最佳实践。提供算术、归约、数据搬运、Buffer管理、精度转换等 API 的正确用法和限制说明。触发：用户询问具体 API 用法（如"DataCopy 怎么用"）、遇到 API 参数错误或限制报错（如 repeatTimes、对齐问题）、需要查看 API 最佳实践或避坑指南时。

2026-05-254

ascendc-docs-search

LingquLab/TileXR

Ascend C 开发资源检索技能。通过本地 API 文档索引、示例代码映射和在线文档兜底搜索定位开发资料，优先查本地、缺失时再查在线。当需要查询 API 用法、示例代码、兼容性信息、官方资料入口或定位文档来源时使用。

2026-05-254

ascendc-env-check

LingquLab/TileXR

Ascend C 算子开发环境检查技能。用于：(1) 通过 npu-smi 查询 NPU 设备信息（设备列表、状态、资源使用），(2) 检查 CANN 环境配置（CANN Toolkit、Ops、自定义算子包），(3) 验证开发依赖是否完整。触发关键词：环境检查、NPU设备、npu-smi、CANN安装、设备查询、资源监控、检查CANN环境变量。

2026-05-254

name	cann-env-setup
description	昇腾 NPU 上 CANN 安装与环境配置指导。触发场景：需安装 CANN、配置开发环境或排查安装问题时。

CANN开发环境配置

此技能为在昇腾NPU平台上安装CANN（神经网络计算架构）提供全面指导。

调用时机

在以下情况下调用此技能：

用户询问CANN安装
用户需要帮助设置昇腾开发环境
用户遇到CANN安装问题
用户想了解CANN安装方法

安装步骤

第1步：检查驱动是否安装

硬件要求

已安装昇腾NPU设备
设备状态正常

驱动检查命令

npu-smi info

检查结果

如果显示NPU设备信息，说明驱动已安装
记录驱动版本用于后续CANN版本兼容性检查
如果提示"command not found"，需要先安装昇腾驱动

第2步：检查CANN安装依赖

检查CANN安装依赖（Python和pip）是否已安装：

# 检查Python
if ! command -v python3 &> /dev/null && ! command -v python &> /dev/null; then
    echo "Python not found, please install from env_dependence.md"
fi

# 检查pip
if ! command -v pip3 &> /dev/null && ! command -v pip &> /dev/null; then
    echo "pip not found, please install from env_dependence.md"
fi

如果任何依赖缺少，会显示提示信息，请参考环境依赖安装指南进行安装。

第3步：安装CANN

方法一：离线安装

步骤3.1：检查当前文件夹是否存在安装包

# 检查当前文件夹是否存在CANN安装包
if ls Ascend-cann-toolkit_*.run 2>/dev/null | grep -q .; then
    echo "找到CANN Toolkit安装包"
    TOOLKIT_PACKAGE=$(ls Ascend-cann-toolkit_*.run)
else
    echo "未找到CANN Toolkit安装包，请使用在线安装方式"
    # 退出离线安装，建议使用在线安装
    exit 1
fi

# 检查当前文件夹是否存在ops安装包
if ls Ascend-cann-*-ops_*.run 2>/dev/null | grep -q .; then
    echo "找到CANN ops安装包"
    OPS_PACKAGE=$(ls Ascend-cann-*-ops_*.run)
else
    echo "未找到CANN ops安装包，请使用在线安装方式"
    # 退出离线安装，建议使用在线安装
    exit 1
fi

步骤3.2：安装CANN

重要：必须先安装Toolkit，再安装ops

run格式安装：

# 安装 Toolkit (默认路径 /usr/local/Ascend)
bash "$TOOLKIT_PACKAGE" --install --quiet
# 安装 ops
bash "$OPS_PACKAGE" --install --quiet

方法二：在线安装（conda方式）

注意：conda主要用于创建Python虚拟环境，CANN工具包仍需通过离线安装包安装。

步骤3.1：创建conda虚拟环境

# 创建Python环境（CANN支持Python 3.7.x - 3.13.11）
conda create -n cann_env python
# 激活环境
conda activate cann_env

步骤3.2：配置昇腾conda官方源

# 添加昇腾conda源
conda config --add channels https://repo.huaweicloud.com/ascend/repos/conda

步骤3.3：安装CANN包

# 使用conda安装CANN工具包
conda install ascend::cann-toolkit
# 安装CANN ops包（根据芯片类型选择，如910、910b、310等）
conda install ascend::cann-{芯片类型}-ops

方法三：在线安装（yum方式 - CentOS/RHEL）

步骤3.1：配置华为官方源

sudo curl https://repo.oepkgs.net/ascend/cann/ascend.repo -o /etc/yum.repos.d/ascend.repo && yum makecache

步骤3.2：安装CANN包

yum install -y Ascend-cann-toolkit
yum install -y Ascend-cann-{芯片类型}-ops

第4步：环境变量配置

临时设置（仅当前终端生效）

source /usr/local/Ascend/ascend-toolkit/set_env.sh

永久设置（写入Shell配置文件）

echo "source /usr/local/Ascend/ascend-toolkit/set_env.sh" >> ~/.bashrc

第5步：安装验证

使用Python验证ACL接口

python3 -c "import acl;acl.init();acl.rt.set_device(0)"

验证结果

如果执行成功，说明CANN Python接口正常工作
如果执行失败，检查环境变量是否配置正确

第6步：安装运行时依赖

pip3 install attrs cython numpy decorator sympy cffi pyyaml pathlib2 psutil protobuf==3.20.0 scipy requests absl-py --user
pip3 install protobuf==3.20.0

注意事项

版本兼容性：确保CANN版本与驱动版本匹配
安装顺序：必须先安装Toolkit，再安装ops
环境变量：安装后必须设置环境变量
权限问题：某些操作可能需要root权限
依赖包：确保所有必要的依赖包已安装

故障排查

如果安装过程中遇到问题：

检查驱动版本是否与CANN版本兼容
检查依赖包是否安装完整
查看安装日志获取详细错误信息
参考昇腾社区文档或寻求技术支持

参考资料

详细参考资料请查看 reference 目录，包含：

环境依赖安装指南：必需软件安装命令和验证方法