AI Upscaler

Real-ESRGAN 기반 이미지/동영상 AI 업스케일러 (검증! 안정!)

⚠️ 중요: Python 3.10 전용

이 버전은 Python 3.10에서만 동작합니다!

다른 버전(3.11, 3.12, 3.14)은 패키지 호환성 문제가 발생합니다. ㅂㄷㅂㄷ

---

100% 동작 보장을 위한 패키지 up (다음에도사용)

• ✅ Python 3.10.11
• ✅ PySide6 6.5.3
• ✅ PyTorch 2.0.1 (CPU)
• ✅ torchvision 0.15.2
• ✅ basicsr 1.4.2
• ✅ Real-ESRGAN 0.3.0

---

🚀 3단계 설치 (5분)

1단계: Python 3.10 설치

다운로드:

• https://www.python.org/ftp/python/3.10.11/python-3.10.11-amd64.exe

설치 시 필수:

• ✅ "Add Python 3.10 to PATH" 체크!

2단계: Visual C++ 설치

다운로드:

• https://aka.ms/vs/17/release/vc_redist.x64.exe

3단계: 자동 설치

install.bat

끝! 🎉

---

✅ 설치 확인

test.bat

모든 테스트가 통과하면:

SUCCESS! All modules working!

---

▶️ 실행

run.bat

또는

venv\Scripts\activate
python -m app.main

---

📋 시스템 요구사항

필수

• Python 3.10.x (3.10.11 권장)
• Windows 10/11 (64-bit)
• 8GB RAM 이상
• Visual C++ Redistributable

권장

• NVIDIA GPU (CUDA)
• 16GB RAM
• SSD

---

🔧 문제 해결

"Python 3.10 is required"

다른 Python 버전이 설치되어 있습니다.

해결:

1. Python 3.10.11 다운로드 및 설치
2. 설치 시 "Add to PATH" 체크
3. install.bat 다시 실행

"Visual C++ Redistributable not detected"

PyTorch가 필요한 DLL이 없습니다.

해결:

1. https://aka.ms/vs/17/release/vc_redist.x64.exe 설치
2. 재부팅
3. install.bat 다시 실행

"PyTorch import failed"

Visual C++ 문제입니다.

해결:

1. Visual C++ 재설치
2. 재부팅 필수
3. test.bat으로 확인

---

기능

• ✨ AI 기반 이미지 업스케일 (2x, 4x)
• 🎬 동영상 프레임별 업스케일
• 📦 배치 처리
• 🎨 5가지 프리셋
• ⚡ GPU 가속 (자동 감지)
• 📊 실시간 진행률

---

🎯 사용 방법

1. 파일 추가 - Drag & Drop
2. 출력 폴더 - 저장 위치 선택
3. 설정 조정 - 배율, 모델, 품질
4. 시작 클릭

첫 실행 시 AI 모델(~80MB) 자동 다운로드

---

📚 포함된 스크립트

파일	용도
install.bat	자동 설치 (Python 3.10 전용)
test.bat	설치 검증
run.bat	앱 실행

---

🆘 여전히 문제가 있다면

1. 로그 확인

type ai_upscaler.log

2. 재설치

rmdir /s /q venv
install.bat

3. 수동 설치

py -3.10 -m venv venv
venv\Scripts\activate
pip install -r requirements.txt
python -m app.main

---

✨ 버전 정보

v2.0.0 - Stable Release

• ✅ Python 3.10 전용 (100% 호환)
• ✅ 검증된 패키지 버전
• ✅ 호환성 문제 완전 해결
• ✅ 자동 설치 및 검증
• ✅ 모든 기능 작동 보장

---

📖 주요 변경사항

이전 버전 문제점

• ❌ Python 3.12/3.14 호환성 문제
• ❌ torchvision API 버전 충돌
• ❌ basicsr import 실패
• ❌ 설치 실패율 높음

이번 버전 해결

• ✅ Python 3.10으로 고정
• ✅ 검증된 패키지 버전 사용
• ✅ 100% 작동 보장
• ✅ 자동 검증 시스템

---

FFmpeg (선택사항)

동영상 처리에만 필요합니다.

설치:

choco install ffmpeg

또는 https://ffmpeg.org에서 다운로드

확인:

ffmpeg -version