# Qualcomm AI 런타임 SDK 설정

전제 조건:

- 호스트 OS: **Ubuntu22.04 LTS**

참고

호스트 컴퓨터에서 Windows 또는 macOS를 사용하는 경우 [가상 머신 설치](https://docs.qualcomm.com/bundle/publicresource/topics/80-70018-41) 를 진행하세요.

이후 단계는 Ubuntu 22.04 LTS가 실행되는 가상 머신에서 실행해야 합니다.

1. SSH 를 Permissive 모드로 활성화하여 호스트 기기에 안전하게 로그인합니다. 지침은 [SSH 방법](https://docs.qualcomm.com/bundle/publicresource/topics/80-70018-254/how_to.html#use-ssh) 을 참조하세요.
2. 문서의 나머지 부분에서 `QAIRT_ROOT` 환경 변수는 Qualcomm AI 런타임 SDK 루트 디렉토리의 전체 경로를 나타냅니다.

    - 직접 다운로드 방법을 사용하여 설치한 경우 압축을 푼 SDK의 경로는 `${QAIRT_ROOT}` 입니다.

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 런타임 SDK에서 사용할 수 있는 중간 표현으로 변환하려면 해당 프레임워크를 다운로드하여 호스트 컴퓨터에 설치해야 할 수 있습니다.

이 Qualcomm AI 런타임 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 런타임 SDK 환경 설정

Qualcomm AI 런타임 SDK에서 제공하는 환경 설정 스크립트를 소싱하여 워크플로우에 필요한 모든 도구와 라이브러리를 `$PATH` 에서 사용할 수 있는지 확인하세요.

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

Last Published: Oct 15, 2025

[Previous Topic
Qualcomm AI 런타임 SDK 설치](https://docs.qualcomm.com/bundle/publicresource/80-70018-15BK/topics/qairt-install.md) [Next Topic
모델 포팅](https://docs.qualcomm.com/bundle/publicresource/80-70018-15BK/topics/port-models.md)