（可选）本地安装ModelArts SDK

本地安装ModelArts SDK步骤

在本地安装ModelArts SDK，具体的配置步骤如下：

• 步骤一：下载ModelArts SDK
• 步骤二：配置运行环境
• 步骤三：安装ModelArts SDK

ModelArts SDK支持安装在Windows和Linux操作系统中。

若在Windows上安装ModelArts SDK时出现报错，可参见FAQ：Windows上安装ModelArts SDK报错处理报错。

步骤一：下载ModelArts SDK

1. 下载ModelArts SDK软件包，获取最新版本的ModelArts SDK软件包。
2. （可选）完成软件包签名校验。
   1. 下载软件包签名校验文件。
   2. 安装openssl并进行软件一致性验证，具体验签命令如下：

      openssl cms -verify -binary -in D:\modelarts-latest-py2.py3-none-any.whl.cms -inform DER -content D:\modelarts-latest-py2.py3-none-any.whl  -noverify > ./test

      

      本示例以软件包在D:\举例，请根据软件包实际路径修改。

      

步骤二：配置运行环境

1. 检查本地环境是否已安装Python。如果环境中没有安装Python，可从Python官网下载并安装合适的Python版本。Python版本需大于3.7.x版本且小于3.10.x版本，推荐使用3.7.x版本。
   在本地环境执行命令python --version，显示如下内容说明Python已安装。

   C:\Users\xxx>python --version
   Python *.*.*

2. 检查是否已安装Python通用包管理工具pip。若Python安装过程中没有安装通用包管理工具pip，则参见pip官网完成pip安装。
   在本地环境执行命令pip --version，显示如下内容说明pip已安装。

   C:\Users\xxx>pip --version
   pip **.*.* from c:\users\xxx\appdata\local\programs\python\python**\lib\site-packages\pip (python *.*)

   

   在Windows环境中，如果提示“不是内部或外部命令”，请您在“环境变量”中设置“Path”，增加Python和pip的安装路径，具体步骤如下。pip的安装路径一般为Python所在目录的Scripts文件夹。

   1. 快捷键“win+R”，在“运行”窗口中输入“sysdm.cpl”，单击“确定”。
   2. 在“系统属性”中切换到“高级”页签，单击“环境变量”。
   3. 在“环境变量”的“用户变量”中鼠标左键双击“Path”，在“编辑环境变量”窗口单击“新增”，新增Python和pip的安装路径。安装路径需定位到Scripts文件夹，例如“c:\python\python**\Scripts”。
3. 配置pip源。以Windows环境为例，配置pip源方法如下：
   1. 新建pip文件夹。启动cmd，输入set命令，查看APPDATA路径。并在APPDATA对应路径下创建pip文件夹。文件内容示例如下：

      C:\Users\xxx>set
      ALLUSERSPROFILE=C:\ProgramData
      APPDATA=C:\Users\xxx\AppData\Roaming

      如上所示，即需要在C:\Users\xxx\AppData\Roaming路径下创建pip文件夹。

   2. 在pip文件夹中创建一个名为pip的文本文件，并将后缀名由“.txt”改为“.ini”。文件内容示例如下：
      其中，index-url为pip源ip地址，使用时需自行替换。本示例以华为源为例，具体如下：

      [global]
      index-url = https://mirrors.huaweicloud.com/repository/pypi/simple  
      trusted-host = mirrors.huaweicloud.com  
      disable-pip-version-check = true
      timeout = 120
      [install] 
      ignore-installed = true
      no-dependencies = yes

4. 启动cmd，执行如下命令下载需要的pip源中的包。

   C:\Users\xxx>pip install numpy       #numpy可替换为您需要下载的包

步骤三：安装ModelArts SDK

启动cmd，执行如下命令安装ModelArts SDK。

pip install {SDK软件包路径}\modelarts-latest-py2.py3-none-any.whl

C:\Users\xxx>pip install C:\Users\xxx\Downloads\modelarts-latest-py2.py3-none-any.whl
......
Successfully installed Pillow-*.*.0 ... modelarts-*.*.* ...

在安装SDK时会默认同时安装所需的依赖包。当显示“Successfully installed”时，表示ModelArts SDK安装完成。

如果在安装过程中报错提示缺少相应的依赖包，请根据报错提示执行如下命令进行依赖包安装。

pip install xxxx

其中，xxxx为依赖包的名称。

后续操作

本地安装ModelArts SDK后，需完成Session鉴权。Session鉴权完成后，您可直接调用ModelArts的SDK接口。

FAQ：Windows上安装ModelArts SDK报错

在Windows上安装ModelArts SDK，Python版本需≤3.10.x版本，推荐使用3.7.x版本。

如果本地安装SDK时，出现如下图中的报错，需要先安装3.1.1版本的futures依赖包，然后再重新安装SDK。

pip install futures==3.1.1

图1 安装ModelArts SDK报错信息