# Thiết lập AI Runtime

Mở PowerShell ở chế độ quản trị viên và chạy các lệnh sau để cài đặt phần phụ thuộc. Thiết lập này là bắt buộc đối với hướng dẫn này và mất khoảng 20-30 phút. Để biết thêm thông tin về việc thiết lập, hãy xem [qnn_setup.ps1](https://raw.githubusercontent.com/quic/wos-ai/refs/heads/main/Scripts/qnn_setup.ps1).

1. Thiết lập $DIR\_PATH (mặc định là `C:\WoS_AI`), người dùng có thể thay đổi đường dẫn mong muốn.

$DIR_PATH  = "C:\WoS_AI"
        Copy to clipboard
2. Chạy lệnh sau để tải xuống tập tin mã lệnh thiết lập. Nếu đã tải xuống, bạn có thể bỏ qua bước này.

if (!(Test-Path $DIR_PATH\Downloads\Setup_Scripts)) {mkdir $DIR_PATH\Downloads\Setup_Scripts}
        Invoke-WebRequest -O qnn_setup.ps1 https://raw.githubusercontent.com/quic/wos-ai/refs/heads/main/Scripts/qnn_setup.ps1
        Move-Item -Path ".\qnn_setup.ps1" -Destination $DIR_PATH\Downloads\Setup_Scripts -Force
        Copy to clipboard
3. Chạy lệnh sau để cài đặt các điều kiện tiên quyết cho AI Runtime (QNN).

    Thiết lập QNN:

cd $DIR_PATH
        powershell  -command "&{. .\Downloads\Setup_Scripts\qnn_setup.ps1; QNN_Setup -rootDirPath $DIR_PATH}"
        Copy to clipboard

    Các phần phụ thuộc sau được tải xuống và cài đặt:

> 
> 
> - Python amd64 phiên bản 3.10.4
>     - Các cấu phần phần mềm của mô hình bao gồm mô hình mobilenet\_v2.onnx và io\_utils.py cho quy trình tiền/hậu xử lý.
>     - AI Runtime SDK phiên bản 2.34.0.250424
>     - Visual Studio Enterprise phiên bản 17.10.3
>     - CMake phiên bản 3.30.4
>     - Tạo môi trường ảo (QAIRT\_VENV) với các thư viện cần thiết cho AI Runtime (QNN).

Ghi chú

Nếu tính năng chạy tập lệnh bị vô hiệu hóa trên hệ thống, hãy chạy lệnh sau như bên dưới và nhập "A" (Có cho tất cả).

Set-ExecutionPolicy RemoteSigned
        Copy to clipboard
4. Khi thiết lập hoàn tất, $DIR\_PATH có cấu trúc thư mục như sau:

![../../_images/folders_structure_qnn.png](data:image/png;base64,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)
    - Downloads: Thư mục này lưu trữ tất cả các tệp cần thiết để hoàn tất thiết lập, chẳng hạn như trình cài đặt Python, tập lệnh thiết lập, v.v.
    - Python\_Env: Thư mục này có môi trường ảo (QAIRT\_VENV) được tạo cho các EP.
    - Debug\_Logs: Thư mục này chứa các log tương ứng với thiết lập.
    - Models: Thư mục này chứa các thư mục con của mô hình và các cấu phần phần mềm tương ứng (ví dụ: Mobilenet\_v2) cùng với phần phụ thuộc QNN như thư viện và tệp bộ khung (skel) (ví dụ: QNN\_Dependencies).

## Các bước tiếp theo

Sau khi hoàn tất thiết lập, hãy tiếp tục đến bước [Chuyển đổi định dạng mô hình](https://docs.qualcomm.com/doc/80-62010-1VI/topic/model-convert-quantize.html#model-convert-quantize) bằng cách dùng công cụ AI Runtime trong phần tiếp theo.

Last Published: Dec 16, 2025

[Previous Topic
Quy trình làm việc QNN](https://docs.qualcomm.com/bundle/publicresource/80-62010-1VI/topics/qnn-workflow.md) [Next Topic
Chuyển đổi định dạng mô hình](https://docs.qualcomm.com/bundle/publicresource/80-62010-1VI/topics/model-convert-quantize.md)