昇腾社区首页
开发者
资源
支持
积分兑换 NEW

安装工具

本节介绍AMCT工具具体的安装命令。

AMCT（PyTorch）

  1. 在AMCT软件包所在目录下，执行如下命令进行源码安装（如果安装用户为root，请将安装命令中的--user删除）：
    pip3 install amct_pytorch-{version}-py3-none-linux_{arch}.tar.gz --user

    其中：{version}表示AMCT具体版本号，{arch}表示软件包支持的安装服务器具体架构形态。如果使用root用户安装AMCT，并且使用了--target参数，请确保--target参数指定的路径为当前用户的路径，避免指定到其他非root用户。

    • 安装AMCT（PyTorch）时，请确保pip版本<=25.2，否则可能出现如下“ModuleNotFoundError:No module named 'torch' ”错误信息；如果用户pip版本>25.2，且不想降低版本，则请将上述安装命令修改为：

      pip3 install amct_pytorch-{version}-py3-none-linux_{arch}.tar.gz --user --no-build-isolation

    • amct_pytorch和amct_tensorflow不能在Python同一个进程中导入，两个包共用同一个basic_info.proto，同时导入会引发proto重复定义问题。

      amct_tensorflow为TensorFlow框架AMCT的安装目录；basic_info.proto文件所在路径为：AMCT安装目录/proto。

  2. 若出现如下信息则说明工具安装成功。
    1
2
3
    Successfully build amct-pytorch
...
Successfully installed amct-pytorch-{version}

    用户可以在Python软件包所在路径下（例如：$HOME/.local/lib/python3.9/site-packages）查看已经安装的AMCT，例如：

    1
2
    drwxr-xr-x  5 amct amct   4096 Mar 17 11:50 amct_pytorch/
drwxr-xr-x  2 amct amct   4096 Mar 17 11:50 amct_pytorch-{version}.dist-info/

    其中amct_pytorch即为AMCT所在安装目录。

AMCT（ONNX）

  1. 安装AMCT。
    在AMCT软件包所在目录下，执行如下命令进行安装（如果安装用户为root，请将安装命令中的--user删除）：
    pip3 install amct_onnx-{version}-py3-none-linux_{arch}.whl --user

    其中：{version}表示AMCT具体版本号，{arch}表示软件包支持的安装服务器具体架构形态。如果使用root用户安装AMCT，并且使用了--target参数，请确保--target参数指定的路径为当前用户的路径，避免指定到其他非root用户。

  2. 若出现如下信息则说明工具安装成功。
    1
    Successfully installed amct-onnx-{version}

    用户可以在Python软件包所在路径下（例如：$HOME/.local/lib/python3.9/site-packages）查看已经安装的AMCT，例如：

    1
2
    drwxr-xr-x  5 amct amct   4096 Mar 17 11:50 amct_onnx/
drwxr-xr-x  2 amct amct   4096 Mar 17 11:50 amct_onnx-{version}.dist-info/

    其中amct_onnx即为AMCT所在安装目录。

AMCT（TensorFlow）

  1. 在AMCT软件包所在目录，执行如下命令进行安装（如果安装用户为root，请将安装命令中的--user删除）：

    该格式软件包以源码方式安装，安装过程中执行编译并安装的操作：

    pip3 install amct_tensorflow-{version}-py3-none-linux_{arch}.tar.gz --user

    其中：{version}表示AMCT具体版本号，{arch}表示软件包支持的安装服务器具体架构形态。如果使用root用户安装AMCT，并且使用了--target参数，请确保--target参数指定的路径为当前用户的路径，避免指定到其他非root用户。

    如果用户的安装服务器缺少某些编译依赖，无法采用源码包的方式安装AMCT，则可以参见源码包编译为whl包，以whl包形式安装AMCT将源码包编译为whl包进行安装。

  2. 若出现如下信息则说明工具安装成功。
    1
    Successfully installed amct-tensorflow-{version}

    用户可以在Python软件包所在路径下（例如：$HOME/.local/lib/python3.9/site-packages）查看已经安装的AMCT，例如：

    1
2
    drwxr-xr-x  5 amct amct   4096 Mar 17 11:50 amct_tensorflow/
drwxr-xr-x  2 amct amct   4096 Mar 17 11:50 amct_tensorflow-{version}.dist-info/

    其中amct_tensorflow即为AMCT所在安装目录。

    amct_tensorflow和amct_pytorch不能在Python同一个进程中导入，两个包共用同一个basic_info.proto，同时导入会引发proto重复定义问题。

    amct_pytorch为PyTorch框架AMCT的安装目录；basic_info.proto文件所在路径为：AMCT安装目录/proto。

AMCT（Caffe）

  1. 在AMCT软件包所在目录，执行如下命令进行安装（如果安装用户为root，请将安装命令中的--user删除）：
    pip3 install amct_caffe-{version}-py3-none-linux_{arch}.whl --user

    其中：{version}表示AMCT具体版本号，{arch}表示软件包支持的安装服务器具体架构形态。如果使用root用户安装AMCT，并且使用了--target参数，请确保--target参数指定的路径为当前用户的路径，避免指定到其他非root用户。

  2. 若出现如下信息则说明工具安装成功。
    1
    Successfully installed amct-caffe-{version}

    用户可以在Python3.9.2安装包所在路径下（例如：$HOME/.local/lib/python3.9/site-packages，该路径请以用户实际安装的为准）查看已经安装的AMCT，例如：

    1
2
    drwxr-xr-x  5 amct amct   4096 Mar 17 11:50 amct_caffe/
drwxr-xr-x  2 amct amct   4096 Mar 17 11:50 amct_caffe-{version}.dist-info/

    其中amct_caffe即为AMCT所在安装目录。

AMCT（TensorFlow,Ascend）

  1. 在AMCT软件包所在目录，执行如下命令进行安装（如果安装用户为root，请将安装命令中的--user删除）：

    该格式软件包以源码方式安装，安装过程中执行编译并安装的操作：

    pip3 install amct_tensorflow_ascend-{version}-py3-none-linux_{arch}.tar.gz --user

    其中：{version}表示AMCT具体版本号，{arch}表示软件包支持的安装服务器具体架构形态。如果使用root用户安装AMCT，并且使用了--target参数，请确保--target参数指定的路径为当前用户的路径，避免指定到其他非root用户。

    如果用户的安装服务器缺少某些编译依赖，无法采用编码包的方式安装AMCT，则可以参见源码包编译为whl包，以whl包形式安装AMCT将源码包编译为whl包进行安装。

  2. 若出现如下信息则说明工具安装成功。
    1
    Successfully installed amct-tensorflow-ascend-{version}

    用户可以在Python软件包所在路径下（例如：$HOME/.local/lib/python3.9/site-packages）查看已经安装的AMCT，例如：

    1
2
    drwxr-xr-x  5 amct amct   4096 Mar 17 11:50 amct_tensorflow/
drwxr-xr-x  2 amct amct   4096 Mar 17 11:50 amct_tensorflow_ascend-{version}.dist-info/

    其中amct_tensorflow即为AMCT所在安装目录。

AMCT（acl）

该软件包只在如下使用场景才需要安装，且需已安装同一版本的Toolkit，并和Toolkit安装在同一路径下，Toolkit安装方法请参见《CANN 软件安装》。

  • 使用《AOE调优工具》中的--compression_optimize_conf压缩参数。
  • 使用《图开发》中的“编程指南>更多特性>量化”压缩特性。

AMCT（acl）安装方法如下：

1
2
3
4
# 确保安装包具有可执行权限
chmod +x cann-amct_acl_${cann_version}_linux-${arch}.run
# 安装命令
./cann-amct_acl_${cann_version}_linux-${arch}.run --run --install-path=${install_path}

安装完成后，进行环境变量配置：

1
2
3
4
# 默认路径安装，以root用户为例（非root用户，将/usr/local替换为${HOME}） 
source /usr/local/Ascend/cann/set_env.sh
# 指定路径安装
source ${install_path}/cann/set_env.sh
父主题： 准备环境