--- title: 安装CANN description: "安装前需确保已具备Python环境及pip3，当前CANN支持Python3.7.x至3.13.x版本，若不满足可执行以下命令安装。" url: https://www.hiascend.com/document/detail/zh/canncommercial/latest/softwareinst/instg/instg_0008.html sourcePath: /source/zh/canncommercial/900/softwareinst/instg/instg_0008.html indexId: 48ca79aacabc3a1090d27b9012879505d819987faed692e9b2302d43d8c5b7f664 --- # 安装CANN #### 前提条件 安装前需确保已具备Python环境及pip3，当前CANN支持Python3.7.x至3.13.x版本，若不满足可执行以下命令安装。 Debian、Ubuntu、veLinux：``` sudo apt-get install -y python3 python3-pip ``` openEuler、CentOS、Kylin、BCLinux、UOS V20、AntOS、AliOS、CTyunOS、CULinux、Tlinux、MTOS、vesselOS：``` sudo yum install -y python3 python3-pip ``` 若安装失败、版本不满足或未包含动态库libpython3.x.so，请参考编译安装Python操作。 #### 安装Toolkit开发套件包 CANN Toolkit开发套件包，在训练&推理&开发调试场景下安装，主要用于训练和推理业务、模型转换、算子/应用/模型的开发和编译。 安装Toolkit软件前请确保安装目录可用空间大于10G，如不满足请清理空间或更换安装目录。 | 架构 | 安装命令 | | | | --- | --- | --- | --- | | aarch | 1 2 wget https://ascend\-repo.obs.cn\-east\-2.myhuaweicloud.com/CANN/CANN%209.0.0/Ascend\-cann\-toolkit\_9.0.0\_linux\-aarch64.run bash ./Ascend\-cann\-toolkit\_9.0.0\_linux\-aarch64.run \-\-install | 1 2 | wget https://ascend\-repo.obs.cn\-east\-2.myhuaweicloud.com/CANN/CANN%209.0.0/Ascend\-cann\-toolkit\_9.0.0\_linux\-aarch64.run bash ./Ascend\-cann\-toolkit\_9.0.0\_linux\-aarch64.run \-\-install | | 1 2 | wget https://ascend\-repo.obs.cn\-east\-2.myhuaweicloud.com/CANN/CANN%209.0.0/Ascend\-cann\-toolkit\_9.0.0\_linux\-aarch64.run bash ./Ascend\-cann\-toolkit\_9.0.0\_linux\-aarch64.run \-\-install | | | | x86\_64 | 1 2 wget https://ascend\-repo.obs.cn\-east\-2.myhuaweicloud.com/CANN/CANN%209.0.0/Ascend\-cann\-toolkit\_9.0.0\_linux\-x86\_64.run bash ./Ascend\-cann\-toolkit\_9.0.0\_linux\-x86\_64.run \-\-install | 1 2 | wget https://ascend\-repo.obs.cn\-east\-2.myhuaweicloud.com/CANN/CANN%209.0.0/Ascend\-cann\-toolkit\_9.0.0\_linux\-x86\_64.run bash ./Ascend\-cann\-toolkit\_9.0.0\_linux\-x86\_64.run \-\-install | | 1 2 | wget https://ascend\-repo.obs.cn\-east\-2.myhuaweicloud.com/CANN/CANN%209.0.0/Ascend\-cann\-toolkit\_9.0.0\_linux\-x86\_64.run bash ./Ascend\-cann\-toolkit\_9.0.0\_linux\-x86\_64.run \-\-install | | | 安装命令支持--install-path=等参数，具体使用方式请参见参数说明。如果用户未指定安装路径，则软件会安装到默认路径下，默认安装路径如下。root用户：“/usr/local/Ascend”，非root用户：“${HOME}/Ascend”，${HOME}为当前用户目录。 安装完成后请配置环境变量，当前以非root用户安装后的默认路径为例，请用户根据set_env.sh的实际路径执行如下命令。``` source ${HOME}/Ascend/cann/set_env.sh ``` 上述环境变量配置只在当前窗口生效，用户可以按需将以上命令写入环境变量配置文件（如.bashrc文件）。 #### 安装ops算子包 CANN算子包集成一系列库文件，包括算子基础框架，算子库（包含math、nn、cv和transformer）、TBE算子、HCCL集合通信库、HIXL单边通信库和 DVPP库，具体文件包括单算子API执行（如aclnn类API）动态库/静态库文件、算子源码以及kernel二进制文件，优化高性能计算场景下的整体运行能力。 安装ops算子包前，需已安装兼容版本的Toolkit软件包，并安装在同一路径下，请选择运行设备对应的ops软件包。多个芯片的ops算子包暂不支持安装在同一路径下，用户可以在不同路径下分别安装Toolkit和不同芯片的ops，以满足多芯片环境下的开发和部署需求。 **表1 安装ops算子包** | 产品类型 | 架构 | 安装命令 | | | | --- | --- | --- | --- | --- | | Atlas 350 加速卡 | aarch | 1 2 wget https://ascend\-repo.obs.cn\-east\-2.myhuaweicloud.com/CANN/CANN%209.0.0/Ascend\-cann\-950\-ops\_9.0.0\_linux\-aarch64.run bash ./Ascend\-cann\-950\-ops\_9.0.0\_linux\-aarch64.run \-\-install | 1 2 | wget https://ascend\-repo.obs.cn\-east\-2.myhuaweicloud.com/CANN/CANN%209.0.0/Ascend\-cann\-950\-ops\_9.0.0\_linux\-aarch64.run bash ./Ascend\-cann\-950\-ops\_9.0.0\_linux\-aarch64.run \-\-install | | Atlas 350 加速卡 | 1 2 | wget https://ascend\-repo.obs.cn\-east\-2.myhuaweicloud.com/CANN/CANN%209.0.0/Ascend\-cann\-950\-ops\_9.0.0\_linux\-aarch64.run bash ./Ascend\-cann\-950\-ops\_9.0.0\_linux\-aarch64.run \-\-install | | | | x86\_64 | 1 2 wget https://ascend\-repo.obs.cn\-east\-2.myhuaweicloud.com/CANN/CANN%209.0.0/Ascend\-cann\-950\-ops\_9.0.0\_linux\-x86\_64.run bash ./Ascend\-cann\-950\-ops\_9.0.0\_linux\-x86\_64.run \-\-install | 1 2 | wget https://ascend\-repo.obs.cn\-east\-2.myhuaweicloud.com/CANN/CANN%209.0.0/Ascend\-cann\-950\-ops\_9.0.0\_linux\-x86\_64.run bash ./Ascend\-cann\-950\-ops\_9.0.0\_linux\-x86\_64.run \-\-install | | | 1 2 | wget https://ascend\-repo.obs.cn\-east\-2.myhuaweicloud.com/CANN/CANN%209.0.0/Ascend\-cann\-950\-ops\_9.0.0\_linux\-x86\_64.run bash ./Ascend\-cann\-950\-ops\_9.0.0\_linux\-x86\_64.run \-\-install | | | | | Atlas A3 系列产品 | aarch | 1 2 wget https://ascend\-repo.obs.cn\-east\-2.myhuaweicloud.com/CANN/CANN%209.0.0/Ascend\-cann\-A3\-ops\_9.0.0\_linux\-aarch64.run bash ./Ascend\-cann\-A3\-ops\_9.0.0\_linux\-aarch64.run \-\-install | 1 2 | wget https://ascend\-repo.obs.cn\-east\-2.myhuaweicloud.com/CANN/CANN%209.0.0/Ascend\-cann\-A3\-ops\_9.0.0\_linux\-aarch64.run bash ./Ascend\-cann\-A3\-ops\_9.0.0\_linux\-aarch64.run \-\-install | | Atlas A3 系列产品 | 1 2 | wget https://ascend\-repo.obs.cn\-east\-2.myhuaweicloud.com/CANN/CANN%209.0.0/Ascend\-cann\-A3\-ops\_9.0.0\_linux\-aarch64.run bash ./Ascend\-cann\-A3\-ops\_9.0.0\_linux\-aarch64.run \-\-install | | | | x86\_64 | 1 2 wget https://ascend\-repo.obs.cn\-east\-2.myhuaweicloud.com/CANN/CANN%209.0.0/Ascend\-cann\-A3\-ops\_9.0.0\_linux\-x86\_64.run bash ./Ascend\-cann\-A3\-ops\_9.0.0\_linux\-x86\_64.run \-\-install | 1 2 | wget https://ascend\-repo.obs.cn\-east\-2.myhuaweicloud.com/CANN/CANN%209.0.0/Ascend\-cann\-A3\-ops\_9.0.0\_linux\-x86\_64.run bash ./Ascend\-cann\-A3\-ops\_9.0.0\_linux\-x86\_64.run \-\-install | | | 1 2 | wget https://ascend\-repo.obs.cn\-east\-2.myhuaweicloud.com/CANN/CANN%209.0.0/Ascend\-cann\-A3\-ops\_9.0.0\_linux\-x86\_64.run bash ./Ascend\-cann\-A3\-ops\_9.0.0\_linux\-x86\_64.run \-\-install | | | | | Atlas A2 系列产品 | aarch | 1 2 wget https://ascend\-repo.obs.cn\-east\-2.myhuaweicloud.com/CANN/CANN%209.0.0/Ascend\-cann\-910b\-ops\_9.0.0\_linux\-aarch64.run bash ./Ascend\-cann\-910b\-ops\_9.0.0\_linux\-aarch64.run \-\-install | 1 2 | wget https://ascend\-repo.obs.cn\-east\-2.myhuaweicloud.com/CANN/CANN%209.0.0/Ascend\-cann\-910b\-ops\_9.0.0\_linux\-aarch64.run bash ./Ascend\-cann\-910b\-ops\_9.0.0\_linux\-aarch64.run \-\-install | | Atlas A2 系列产品 | 1 2 | wget https://ascend\-repo.obs.cn\-east\-2.myhuaweicloud.com/CANN/CANN%209.0.0/Ascend\-cann\-910b\-ops\_9.0.0\_linux\-aarch64.run bash ./Ascend\-cann\-910b\-ops\_9.0.0\_linux\-aarch64.run \-\-install | | | | x86\_64 | 1 2 wget https://ascend\-repo.obs.cn\-east\-2.myhuaweicloud.com/CANN/CANN%209.0.0/Ascend\-cann\-910b\-ops\_9.0.0\_linux\-x86\_64.run bash ./Ascend\-cann\-910b\-ops\_9.0.0\_linux\-x86\_64.run \-\-install | 1 2 | wget https://ascend\-repo.obs.cn\-east\-2.myhuaweicloud.com/CANN/CANN%209.0.0/Ascend\-cann\-910b\-ops\_9.0.0\_linux\-x86\_64.run bash ./Ascend\-cann\-910b\-ops\_9.0.0\_linux\-x86\_64.run \-\-install | | | 1 2 | wget https://ascend\-repo.obs.cn\-east\-2.myhuaweicloud.com/CANN/CANN%209.0.0/Ascend\-cann\-910b\-ops\_9.0.0\_linux\-x86\_64.run bash ./Ascend\-cann\-910b\-ops\_9.0.0\_linux\-x86\_64.run \-\-install | | | | | Atlas 训练系列产品 | aarch | 1 2 wget https://ascend\-repo.obs.cn\-east\-2.myhuaweicloud.com/CANN/CANN%209.0.0/Ascend\-cann\-910\-ops\_9.0.0\_linux\-aarch64.run bash ./Ascend\-cann\-910\-ops\_9.0.0\_linux\-aarch64.run \-\-install | 1 2 | wget https://ascend\-repo.obs.cn\-east\-2.myhuaweicloud.com/CANN/CANN%209.0.0/Ascend\-cann\-910\-ops\_9.0.0\_linux\-aarch64.run bash ./Ascend\-cann\-910\-ops\_9.0.0\_linux\-aarch64.run \-\-install | | Atlas 训练系列产品 | 1 2 | wget https://ascend\-repo.obs.cn\-east\-2.myhuaweicloud.com/CANN/CANN%209.0.0/Ascend\-cann\-910\-ops\_9.0.0\_linux\-aarch64.run bash ./Ascend\-cann\-910\-ops\_9.0.0\_linux\-aarch64.run \-\-install | | | | x86\_64 | 1 2 wget https://ascend\-repo.obs.cn\-east\-2.myhuaweicloud.com/CANN/CANN%209.0.0/Ascend\-cann\-910\-ops\_9.0.0\_linux\-x86\_64.run bash ./Ascend\-cann\-910\-ops\_9.0.0\_linux\-x86\_64.run \-\-install | 1 2 | wget https://ascend\-repo.obs.cn\-east\-2.myhuaweicloud.com/CANN/CANN%209.0.0/Ascend\-cann\-910\-ops\_9.0.0\_linux\-x86\_64.run bash ./Ascend\-cann\-910\-ops\_9.0.0\_linux\-x86\_64.run \-\-install | | | 1 2 | wget https://ascend\-repo.obs.cn\-east\-2.myhuaweicloud.com/CANN/CANN%209.0.0/Ascend\-cann\-910\-ops\_9.0.0\_linux\-x86\_64.run bash ./Ascend\-cann\-910\-ops\_9.0.0\_linux\-x86\_64.run \-\-install | | | | | Atlas 推理系列产品 | aarch | 1 2 wget https://ascend\-repo.obs.cn\-east\-2.myhuaweicloud.com/CANN/CANN%209.0.0/Ascend\-cann\-310p\-ops\_9.0.0\_linux\-aarch64.run bash ./Ascend\-cann\-310p\-ops\_9.0.0\_linux\-aarch64.run \-\-install | 1 2 | wget https://ascend\-repo.obs.cn\-east\-2.myhuaweicloud.com/CANN/CANN%209.0.0/Ascend\-cann\-310p\-ops\_9.0.0\_linux\-aarch64.run bash ./Ascend\-cann\-310p\-ops\_9.0.0\_linux\-aarch64.run \-\-install | | Atlas 推理系列产品 | 1 2 | wget https://ascend\-repo.obs.cn\-east\-2.myhuaweicloud.com/CANN/CANN%209.0.0/Ascend\-cann\-310p\-ops\_9.0.0\_linux\-aarch64.run bash ./Ascend\-cann\-310p\-ops\_9.0.0\_linux\-aarch64.run \-\-install | | | | x86\_64 | 1 2 wget https://ascend\-repo.obs.cn\-east\-2.myhuaweicloud.com/CANN/CANN%209.0.0/Ascend\-cann\-310p\-ops\_9.0.0\_linux\-x86\_64.run bash ./Ascend\-cann\-310p\-ops\_9.0.0\_linux\-x86\_64.run \-\-install | 1 2 | wget https://ascend\-repo.obs.cn\-east\-2.myhuaweicloud.com/CANN/CANN%209.0.0/Ascend\-cann\-310p\-ops\_9.0.0\_linux\-x86\_64.run bash ./Ascend\-cann\-310p\-ops\_9.0.0\_linux\-x86\_64.run \-\-install | | | 1 2 | wget https://ascend\-repo.obs.cn\-east\-2.myhuaweicloud.com/CANN/CANN%209.0.0/Ascend\-cann\-310p\-ops\_9.0.0\_linux\-x86\_64.run bash ./Ascend\-cann\-310p\-ops\_9.0.0\_linux\-x86\_64.run \-\-install | | | | | Atlas 200I/500 A2 推理产品 | aarch | 1 2 wget https://ascend\-repo.obs.cn\-east\-2.myhuaweicloud.com/CANN/CANN%209.0.0/Ascend\-cann\-310b\-ops\_9.0.0\_linux\-aarch64.run bash ./Ascend\-cann\-310b\-ops\_9.0.0\_linux\-aarch64.run \-\-install | 1 2 | wget https://ascend\-repo.obs.cn\-east\-2.myhuaweicloud.com/CANN/CANN%209.0.0/Ascend\-cann\-310b\-ops\_9.0.0\_linux\-aarch64.run bash ./Ascend\-cann\-310b\-ops\_9.0.0\_linux\-aarch64.run \-\-install | | Atlas 200I/500 A2 推理产品 | 1 2 | wget https://ascend\-repo.obs.cn\-east\-2.myhuaweicloud.com/CANN/CANN%209.0.0/Ascend\-cann\-310b\-ops\_9.0.0\_linux\-aarch64.run bash ./Ascend\-cann\-310b\-ops\_9.0.0\_linux\-aarch64.run \-\-install | | | | x86\_64 | 1 2 wget https://ascend\-repo.obs.cn\-east\-2.myhuaweicloud.com/CANN/CANN%209.0.0/Ascend\-cann\-310b\-ops\_9.0.0\_linux\-x86\_64.run bash ./Ascend\-cann\-310b\-ops\_9.0.0\_linux\-x86\_64.run \-\-install | 1 2 | wget https://ascend\-repo.obs.cn\-east\-2.myhuaweicloud.com/CANN/CANN%209.0.0/Ascend\-cann\-310b\-ops\_9.0.0\_linux\-x86\_64.run bash ./Ascend\-cann\-310b\-ops\_9.0.0\_linux\-x86\_64.run \-\-install | | | 1 2 | wget https://ascend\-repo.obs.cn\-east\-2.myhuaweicloud.com/CANN/CANN%209.0.0/Ascend\-cann\-310b\-ops\_9.0.0\_linux\-x86\_64.run bash ./Ascend\-cann\-310b\-ops\_9.0.0\_linux\-x86\_64.run \-\-install | | | | #### 安装NNAL神经网络加速库（可选） NNAL神经网络加速库中提供了ATB（Ascend Transformer Boost）加速库和SiP（AscendSiPBoost）信号处理加速库。 加速库安装之前，需已安装同一版本的Toolkit并配置环境变量。 | 架构 | 安装命令 | | | | --- | --- | --- | --- | | aarch | 1 2 wget https://ascend\-repo.obs.cn\-east\-2.myhuaweicloud.com/CANN/CANN%209.0.0/Ascend\-cann\-nnal\_9.0.0\_linux\-aarch64.run bash ./Ascend\-cann\-nnal\_9.0.0\_linux\-aarch64.run \-\-install | 1 2 | wget https://ascend\-repo.obs.cn\-east\-2.myhuaweicloud.com/CANN/CANN%209.0.0/Ascend\-cann\-nnal\_9.0.0\_linux\-aarch64.run bash ./Ascend\-cann\-nnal\_9.0.0\_linux\-aarch64.run \-\-install | | 1 2 | wget https://ascend\-repo.obs.cn\-east\-2.myhuaweicloud.com/CANN/CANN%209.0.0/Ascend\-cann\-nnal\_9.0.0\_linux\-aarch64.run bash ./Ascend\-cann\-nnal\_9.0.0\_linux\-aarch64.run \-\-install | | | | x86\_64 | 1 2 wget https://ascend\-repo.obs.cn\-east\-2.myhuaweicloud.com/CANN/CANN%209.0.0/Ascend\-cann\-nnal\_9.0.0\_linux\-x86\_64.run bash ./Ascend\-cann\-nnal\_9.0.0\_linux\-x86\_64.run \-\-install | 1 2 | wget https://ascend\-repo.obs.cn\-east\-2.myhuaweicloud.com/CANN/CANN%209.0.0/Ascend\-cann\-nnal\_9.0.0\_linux\-x86\_64.run bash ./Ascend\-cann\-nnal\_9.0.0\_linux\-x86\_64.run \-\-install | | 1 2 | wget https://ascend\-repo.obs.cn\-east\-2.myhuaweicloud.com/CANN/CANN%209.0.0/Ascend\-cann\-nnal\_9.0.0\_linux\-x86\_64.run bash ./Ascend\-cann\-nnal\_9.0.0\_linux\-x86\_64.run \-\-install | | | 安装命令支持--install-path=等参数，具体使用方式请参见参数说明。如果用户未指定安装路径，则软件会安装到默认路径下，默认安装路径如下。root用户：“/usr/local/Ascend”，非root用户：“${HOME}/Ascend”，${HOME}为当前用户目录。 配置环境变量，当前以非root用户安装后的默认路径为例，请用户根据加速库对应的set_env.sh的实际路径进行替换。- ATB加速库： 1 source ${HOME}/Ascend/nnal/atb/set_env.sh - SiP加速库： 1 source ${HOME}/Ascend/nnal/asdsip/set_env.sh 上述环境变量配置只在当前窗口生效，用户可以按需将以上命令写入环境变量配置文件（如.bashrc文件）。