（可选）本地服务器安装modelarts sdk-九游平台

modelarts sdk使用限制

本地modelarts sdk不支持进行、模型调试和，当前仅支持在开发环境notebook中调试。

本地安装modelarts sdk步骤

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

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

modelarts sdk支持安装在windows和linux操作系统中。

如果在windows上安装modelarts sdk时出现报错，可参见faq：安装modelarts sdk报错处理报错。

步骤一：下载modelarts sdk

1. ，获取最新版本的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版本需大于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版本小于24.0。
   在本地环境执行命令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安装完成。如果安装失败，可参见faq：安装modelarts sdk报错处理报错。

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

pip install xxxx

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

后续操作

本地安装modelarts sdk后，需完成session鉴权。session鉴权完成后，您可直接调用modelarts的sdk接口。

faq：安装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报错信息
  
• 当pip版本>=24.1版本时，会对安装包的名称进行校验，可能会出现如下报错：

  error: invalid requirement: 'modelarts==latest': expected end or semicolon (after name and no valid version specifier)
  modelarts==latest

  针对以上报错，可重新安装更低版本的pip，或将离线包名modelarts-latest-py2.py3-none-any.whl中的latest修改为任意版本号，例如modelarts-1.0.0-py2.py3-none-any.whl，修改后不影响实际安装sdk的真实版本号。