# Thiết lập Qualcomm AI Runtime SDK

Điều kiện tiên quyết:

- Hệ điều hành máy chủ: **Ubuntu22.04 LTS**

Ghi chú

Nếu máy chủ dùng Windows hoặc macOS, hãy [cài đặt máy ảo](https://docs.qualcomm.com/bundle/publicresource/topics/80-70018-41).

Các bước tiếp theo phải chạy trong máy ảo chạy Ubuntu 22.04 LTS.

1. Bật SSH ở chế độ Permissive (Không chặn) để đăng nhập an toàn vào máy host. Để biết hướng dẫn, hãy xem [Cách dùng SSH](https://docs.qualcomm.com/bundle/publicresource/topics/80-70018-254/how_to.html#use-ssh)
2. Đối với phần còn lại của tài liệu, biến môi trường `QAIRT_ROOT` biểu thị đường dẫn đầy đủ đến thư mục gốc Qualcomm AI Runtime SDK.

    - Nếu cài đặt bằng phương pháp tải xuống trực tiếp, `${QAIRT_ROOT}` là đường dẫn đến SDK đã giải nén.

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
    - Nếu cài đặt bằng QPM, SDK được cài đặt trong `/opt/qcom/aistack/qairt/<version>`

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

    Nếu Python đã được cài đặt, hãy đảm bảo rằng đường dẫn môi trường được cập nhật bằng đường dẫn Python 3.10. Nếu chưa cài đặt Python 3.10 trên hệ thống, bạn có thể cài đặt bằng các lệnh sau:

sudo apt-get update
        Copy to clipboard

sudo apt-get install python3.10 python3-distutils libpython3.10
        Copy to clipboard
4. Phần phụ thuộc hệ thống:

Ghi chú

Chạy lệnh sau với với quyền administrator/root để cài đặt các thư viện hệ thống. Lệnh này sẽ mất một thời gian để hoàn tất.

sudo bash ${QAIRT_ROOT}/bin/check-linux-dependency.sh
        Copy to clipboard
5. Môi trường ảo (VENV)

Ghi chú

`<venv_path>` là đường dẫn đến môi trường ảo mới.

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. Chạy tập lệnh sau để kiểm tra và cài đặt các phần phụ thuộc bị thiếu:

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

## Thiết lập ML Frameworks

Để chuyển đổi các mô hình ML được huấn luyện trên nhiều framework thành các dạng trung gian có thể sử dụng bởi Qualcomm AI Runtime SDK, bạn có thể cần tải xuống và cài đặt các framework tương ứng trên máy chủ của mình.

Bản phát hành Qualcomm AI Runtime SDK này đã được xác minh là hoạt động với các phiên bản sau của frameworks huấn luyện ML:

|  | **Phiên bản** |
| --- | --- |
| **TensorFlow** | 2.10.1 |
| **TFLite** | 2.3.0 |
| **PyTorch** | 1.13.1 |
| **ONNX** | 1.16.1 |

- Cài đặt TensorFlow

pip install tensorflow==2.10.1
        Copy to clipboard
- Cài đặt TFLite

pip install tflite==2.3.0
        Copy to clipboard
- Cài đặt 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
- Cài đặt ONNX

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

Chú ý

Các phiên bản TensorFlow và PyTorch được đề cập ở trên có các yêu cầu package khác nhau.

Tạo môi trường ảo riêng biệt cho hai framework.

## Thiết lập môi trường Qualcomm AI Runtime SDK

Dùng lệnh source chạy tập lệnh thiết lập môi trường do Qualcomm AI Runtime SDK cung cấp để đảm bảo mọi công cụ và thư viện cần thiết đều có sẵn trong `$PATH` dành cho quy trình làm việc.

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

Last Published: Oct 22, 2025

[Previous Topic
Cài đặt Qualcomm AI Runtime SDK](https://docs.qualcomm.com/bundle/publicresource/80-70018-15BV/topics/qairt-install.md) [Next Topic
Chuyển đổi mô hình](https://docs.qualcomm.com/bundle/publicresource/80-70018-15BV/topics/port-models.md)