# 设置 Qualcomm AI Runtime SDK

前提条件：

- 主机操作系统：**Ubuntu22.04 LTS**

Note

如果主机使用的是 Windows 或 Mac OS，则需[安装虚拟机](https://docs.qualcomm.com/bundle/publicresource/topics/80-70022-41)。

后续步骤必须在运行 Ubuntu 22.04 LTS 的虚拟机中执行。

1. 在 Permissive 模式下启用 SSH，以便安全地登录到主机设备。相关说明，请参见 [SSH 使用指南](https://docs.qualcomm.com/bundle/publicresource/topics/80-70022-254/how_to.html#use-ssh)。
2. 在本文的其他部分，`QAIRT_ROOT` 环境变量代表 Qualcomm AI Runtime SDK 根目录的完整路径。

    - 如果使用直接下载方法安装，`${QAIRT_ROOT}` 是解压 SDK 的路径。

unzip v2.38.0.250901.zip
            Copy to clipboard

cd qairt/2.38.0.250901
            Copy to clipboard

export QAIRT_ROOT=`pwd`
            Copy to clipboard
    - 如果使用 QPM 安装，则 SDK 安装在 `/opt/qcom/aistack/qairt/<version>` 下

export QAIRT_ROOT=/opt/qcom/aistack/qairt/2.38.0.250901/
            Copy to clipboard
3. Python：**v3.10**

    如果已安装 Python，确保环境路径已更新为 Python 3.10 的路径。如果您的系统上未安装 Python 3.10，您可以使用以下命令进行安装：

sudo apt-get update
        Copy to clipboard

sudo apt-get install python3.10 python3-distutils libpython3.10
        Copy to clipboard
4. 系统依赖项：

Note

以 administrator/root 身份运行以下命令，安装系统库。该命令需要一些时间才能完全完成。

sudo bash ${QAIRT_ROOT}/bin/check-linux-dependency.sh
        Copy to clipboard
5. 虚拟环境 (VENV)

Note

`<venv_path>` 是新建虚拟环境的路径。

sudo apt-get install python3.10-venv
        Copy to clipboard

python3.10 -m venv "<venv_path>"
        Copy to clipboard

source <venv_path>/bin/activate
        Copy to clipboard
6. 运行以下脚本检查并安装缺少的依赖项：

python3 -m pip install --upgrade pip
        Copy to clipboard

${QAIRT_ROOT}/bin/check-python-dependency
        Copy to clipboard

Summary:
        
        Package              Recommended    Installed
        ~~~~~~~              ~~~~~~~~~~~    ~~~~~~~~~
        absl-py              2.1.0          2.1.0
        attrs                23.2.0         23.2.0
        dash                 2.12.1         2.12.1
        decorator            4.4.2          4.4.2
        invoke               1.7.3          1.7.3
        joblib               1.4.0          1.4.0
        jsonschema           4.19.0         4.19.0
        Ixml                 5.2.1          5.2.1
        mako                 1.1.0          1.1.0
        matplotlib           3.3.4          3.3.4
        mock                 3.0.5          3.0.5
        numpy                1.26.4         1.26.4
        opencv-python        4.5.4.58       4.5.4.58
        optuna               3.3.0          3.3.0
        packaging            24.0           24.0
        pandas               2.0.1          2.0.1
        paramiko             3.4.0          3.4.0
        pathlib2             2.3.6          2.3.6
        pillow               10.2.0         10.2.0
        plotly               5.20.0         5.20.0
        protobuf             3.19.6         3.19.6
        psutil               5.6.4          5.6.4
        pytest               8.1.1          8.1.1
        pyyaml               5.3            5.3
        scikit-optimize      0.9.0          0.9.0
        scipy                1.10.1         1.10.1
        six                  1.16.0         1.16.0
        tabulate             0.9.0          0.9.0
        typing-extensions    4.10.0         4.10.0
        xlsxwriter           1.2.2          1.2.2
        Copy to clipboard

## 设置 ML 框架

您可能需要在主机上下载并安装相应的框架，以便将在不同框架上训练的机器学习模型转换为 Qualcomm AI Runtime SDK 可使用的中间表示。

此 Qualcomm AI Runtime SDK 版本经验证可与以下版本的 ML 训练框架配合使用：

|  | **版本** |
| --- | --- |
| **TensorFlow** | 2.10.1 |
| **TFLite** | 2.3.0 |
| **PyTorch** | 1.13.1 |
| **ONNX** | 1.16.1 |

- 安装 TensorFlow

pip install tensorflow==2.10.1
        Copy to clipboard
- 安装 TFLite

pip install tflite==2.3.0
        Copy to clipboard
- 安装 PyTorch

pip install torch==1.13.1+cpu torchvision==0.14.1+cpu torchaudio==0.13.1 --extra-index-url https://download.pytorch.org/whl/cpu
        Copy to clipboard
- 安装 ONNX

pip install onnx==1.16.1 onnxruntime==1.18.0 onnxsim==0.4.36
        Copy to clipboard

## 设置 Qualcomm AI Runtime SDK 环境

获取 Qualcomm AI Runtime SDK 提供的环境设置脚本，以确保 `$PATH` 中所有必要的工具和库都可用于工作流。

source ${QAIRT_ROOT}/bin/envsetup.sh
    Copy to clipboard

Last Published: Nov 05, 2025

[Previous Topic
安装 Qualcomm AI Runtime SDK](https://docs.qualcomm.com/bundle/publicresource/80-70022-15BY/topics/qairt-install.md) [Next Topic
移植模型](https://docs.qualcomm.com/bundle/publicresource/80-70022-15BY/topics/port-models.md)