# 設置 Qualcomm AI Runtime SDK

前置條件：

- 主機 OS： **Ubuntu22.04 LTS**

備註

如果主機電腦使用 Windows 或 Mac OS，[請安裝虛擬機器](https://docs.qualcomm.com/bundle/publicresource/topics/80-70020-41)。

接下來的步驟必須在運行 Ubuntu 22.04 LTS 的虛擬機器中執行。

1. 在許可模式中啟用 SSH，以安全登入主機裝置。如需說明，請參閱 [如何進行 SSH](https://docs.qualcomm.com/bundle/publicresource/topics/80-70020-254/how_to.html#use-ssh)
2. 在文件的其餘部分中，`QAIRT_ROOT` 環境變數表示 Qualcomm AI Runtime SDK 根目錄的完整路徑。

    - 如果使用直接下載方法安裝，`${QAIRT_ROOT}` 是解壓縮後的 SDK 的路徑。

unzip 2.35.0.250530.zip
            Copy to clipboard

cd qairt/2.35.0.250530
            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.35.0.250530/
            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. 系統相依：

備註

以管理員/根權限執行以下命令以安裝系統函式庫。命令需要時間才能完全完成。

sudo bash ${QAIRT_ROOT}/bin/check-linux-dependency.sh
        Copy to clipboard
5. 虛擬環境 (VENV)

備註

`<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 框架

要將在不同框架上訓練的 ML 模型轉換為 Qualcomm AI Runtime SDK 可使用的中間表示，您可能需要在主機電腦上下載並安裝相應的框架。

此 Qualcomm AI Runtime SDK 發行版本已驗證可與以下版本的 ML 訓練框架兼容：

注意

上面提到的 TensorFlow 和 PyTorch 版本具有不同的套件需求。

為這兩個框架創建單獨的虛擬環境。

|  | **版本** |
| --- | --- |
| **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: Dec 23, 2025

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