# 設置 Qualcomm AI Runtime SDK

先決條件：

- 主機操作系統：**Ubuntu22.04 LTS**

備註

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

後續步驟必須在運行 Ubuntu 22.04 LTS 的虛擬機中執行。

1. 在寬鬆模式下啟用 SSH 以安全地登錄到主機設備。 有關說明，請參閱 [如何 SSH](https://docs.qualcomm.com/bundle/publicresource/topics/80-70018-254/how_to.html#use-ssh)
2. 在文檔的其餘部分中，`QAIRT_ROOT` 環境變量表示 Qualcomm AI Runtime SDK 根目錄的完整路徑。

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

unzip 2.32.6.250402.zip
            Copy to clipboard

cd qairt/2.32.6.250402
            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.32.6.250402/
            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** | 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

注意

上述 TensorFlow 和 PyTorch 版本有不同的軟套件需求。

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

## 設置 Qualcomm AI Runtime SDK 環境

運行 Qualcomm AI Runtime SDK 提供的環境設置腳本，以確保工作流程中所有必要的工具和庫都可用於 `$PATH` 中。

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

Last Published: Oct 15, 2025

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