# AI Rumtime 설정

관리자 모드로 PowerShell을 열고 다음 명령어를 실행하여 종속 요소를 설치하세요. 이 설정은 튜토리얼에 필요하며 약 20-30분 정도 소요됩니다. 설정에 대한 자세한 내용은 [qnn_setup.ps1](https://raw.githubusercontent.com/quic/wos-ai/refs/heads/main/Scripts/qnn_setup.ps1) 을 참조하세요.

1. $DIR\_PATH(기본값: `C:\\WoS_AI`)를 설정하면 사용자가 원하는 경로로 변경할 수 있습니다.

$DIR_PATH  = "C:\WoS_AI"
        Copy to clipboard
2. 다음 명령어를 실행하여 설정 스크립트를 다운로드합니다. 이미 다운로드한 경우 이 단계를 건너뛸 수 있습니다.

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. 다음 명령어를 실행하여 AI Rumtime(QNN)에 필요한 요구 조건을 설치합니다.

    QNN 설정:

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

    다음과 같은 종속요소가 다운로드되고 설치됩니다.

> 
> 
> - Python amd64 버전 3.10.4
>     - 모델 아티팩트에는 mobilenet\_v2.onnx 모델과 전처리/후처리를 위한 io\_utils.py가 있습니다.
>     - AI Rumtime SDK 버전 2.34.0.250424
>     - Visual Studio Enterprise 버전 17.10.3
>     - CMake 버전 3.30.4
>     - AI Rumtime(QNN)에 필요한 라이브러리로 가상 환경(QAIRT\_VENV)을 생성합니다.

참고

시스템에서 스크립트 실행이 비활성화되어 있다면, 아래와 같이 명령어를 실행한 후 ‘A’(모든 항목에 대해 예)를 입력합니다.

Set-ExecutionPolicy RemoteSigned
        Copy to clipboard
4. 설정이 완료되면 $DIR\_PATH의 폴더 구조는 다음과 같이 구성됩니다.

![../../_images/folders_structure_qnn.png](data:image/png;base64,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)
    - Downloads: 이 폴더에는 Python 설치 프로그램, 설정 스크립트 등 설정을 완료하는 데 필요한 모든 파일이 저장됩니다.
    - Python\_Env: 이 디렉토리에는 EP용으로 생성한 가상 환경(QAIRT\_VENV)이 있습니다.
    - Debug\_Logs: 이 디렉토리에는 설정에 해당하는 로그가 있습니다.
    - Models: 이 디렉토리에는 모델 하위 디렉토리와 해당 아티팩트(예: Mobilenet\_v2) 및 라이브러리, skel 파일과 같은 QNN 종속요소(예: QNN\_Dependencies)이 함께 보관됩니다.

## 다음 단계

설정을 완료한 후 다음 섹션의 AI Rumtime 도구를 사용한 [모델 변환](https://docs.qualcomm.com/doc/80-62010-1KO/topic/model-convert-quantize.html#model-convert-quantize) 단계를 진행하시기 바랍니다.

Last Published: Jan 13, 2026

[Previous Topic
QNN 워크플로우](https://docs.qualcomm.com/bundle/publicresource/80-62010-1KO/topics/qnn-workflow.md) [Next Topic
모델 변환](https://docs.qualcomm.com/bundle/publicresource/80-62010-1KO/topics/model-convert-quantize.md)