跳转至

Environment

离线推理环境准备

本教程仅涉及MindOCR在Atlas 300系列推理芯片离线推理环境准备。

1. 版本配套关系表

搭建推理环境请参考版本配套关系,推荐使用MindSpore 2.2.14版本进行推理。

不同芯片型号 Ascend Driver和 Firmware使用的版本不一定一样,请参考CANN 包 版本下载对应芯片使用的Driver和 Firmware

下面我们以 Atlas 300I 推理卡 (Model: 3010) X86 CPU架构为例介绍安装版本匹配关系,下面的安装章节也会以这个场景为例,其他芯片及CPU架构可参考这个过程进行安装。

MindSpore Driver Firmware CANN MindOCR
2.2.14 23.0.0 7.1.0.3.220 7.0.0.beta1 v0.4.0

其他MindSpore and Ascend 软件匹配关系请参考 MindSpore 安装

2. Ascend 环境安装

昇腾AI处理器配套软件包有两个版本,商用版和社区版。商用版仅供商业客户使用,下载受限;社区版本可自由下载,以下例子均使用社区版本。

本章使用MindSpore2.2.14配套的Ascend配套软件包,其他版本请参考安装昇腾AI处理器配套软件包 小节进行安装。

software version package name download
Driver 23.0.0 A300-3010-npu-driver_23.0.0_linux-x86_64.run link
Firmware 7.1.0.3.220 A300-3010-npu-firmware_7.1.0.3.220.run link
CANN nnae 7.0.0.beta1 Ascend-cann-nnae_7.0.0_linux-x86_64.run link
CANN kernels(可选) 7.0.0.beta1 Ascend-cann-kernels-310p_7.0.0_linux.run link

安装

# Note: When installing a new machine, install the driver first and then the firmware.
# When the scenario of upgrade, install the firmware first and then the driver.
bash A300-3010-npu-driver_23.0.0_linux-x86_64.run --full
bash A300-3010-npu-firmware_7.1.0.3.220.run --full
bash Ascend-cann-nnae_7.0.0_linux-x86_64.run --install
bash Ascend-cann-kernels-310p_7.0.0_linux.run --install

pip uninstall te topi hccl -y
pip install sympy
pip install /usr/local/Ascend/nnae/latest/lib64/te-*-py3-none-any.whl
pip install /usr/local/Ascend/nnae/latest/lib64/hccl-*-py3-none-any.whl
reboot

配置环境变量

source /usr/local/Ascend/nnae/set_env.sh

3. MindSpore 安装

pip install mindspore==2.2.14

# 查看版本号,离线推理MindSpore仅使用CPU
python -c "import mindspore;mindspore.set_context(device_target='CPU');mindspore.run_check()"

4. MindSpore Lite 安装

software version package name download
推理工具包 2.2.14 mindspore-lite-2.2.14-linux-{arch}.tar.gz link
Python 接口 Wheel安装包 2.2.14 mindspore_lite-2.2.14-{python_version}-linux_{arch}.whl link

推理工具包安装时直接解压即可,并注意设置环境变量:

tar -xvf mindspore-lite-2.2.14-linux-{arch}.tar.gz
cd mindspore-lite-2.2.14-linux-{arch}/
export LITE_HOME=${PWD}    # 推理工具tar包解压后实际路径
export LD_LIBRARY_PATH=$LITE_HOME/runtime/lib:$LITE_HOME/runtime/third_party/dnnl:$LITE_HOME/tools/converter/lib:$LD_LIBRARY_PATH
export PATH=$LITE_HOME/tools/converter/converter:$LITE_HOME/tools/benchmark:$PATH

如果使用python接口,使用pip安装所需的whl包

pip install mindspore_lite-2.2.14-{python_version}-linux_{arch}.whl

5. 安装 MindOCR

git clone https://github.com/mindspore-lab/mindocr.git
cd mindocr
pip install -e .

使用 -e 代表可编辑模式,可以帮助解决潜在的模块导入问题。