93 lines
2.4 KiB
Markdown
93 lines
2.4 KiB
Markdown
# 🔧 의존성 관리 가이드
|
|
|
|
ONNX Runtime 호환성을 위한 의존성 버전 관리 도구입니다.
|
|
|
|
## 📋 고정 버전
|
|
|
|
| 패키지 | 버전 | 이유 |
|
|
|--------|------|------|
|
|
| numpy | 1.26.4 | ONNX Runtime 호환성 |
|
|
| scipy | 1.11.4 | 안정 버전 |
|
|
| onnxruntime | 1.18.1 | 최신 안정 버전 |
|
|
| opencv-python | 4.8.1.78 | 호환성 보장 |
|
|
|
|
## 🚀 사용 방법
|
|
|
|
### 1. 자동 체크 (setup.py 빌드 시)
|
|
```bash
|
|
python setup.py build_exe
|
|
```
|
|
빌드 전에 자동으로 의존성을 체크하고 필요시 수정합니다.
|
|
|
|
### 2. 수동 체크
|
|
```bash
|
|
python check_dependencies.py
|
|
```
|
|
또는
|
|
```bash
|
|
check_deps.bat
|
|
```
|
|
|
|
현재 설치된 버전을 확인하고 필요시 교체합니다.
|
|
|
|
### 3. 강제 수정 (관리자 권한)
|
|
권한 문제로 설치가 실패하는 경우:
|
|
|
|
```bash
|
|
python fix_dependencies.py
|
|
```
|
|
또는
|
|
```bash
|
|
fix_deps_admin.bat
|
|
```
|
|
|
|
관리자 권한으로 강제 재설치를 수행합니다.
|
|
|
|
## ⚠️ 주의사항
|
|
|
|
### ONNXRuntime 교체 시 주의
|
|
- 현재 Python 프로세스에서 ONNX Runtime을 사용 중인 경우 교체가 불가능합니다.
|
|
- 이 경우 다음 순서로 진행하세요:
|
|
1. 모든 Python 프로세스 종료
|
|
2. `fix_deps_admin.bat` 실행
|
|
3. 빌드 재시작
|
|
|
|
### 권한 문제 해결
|
|
Windows에서 "액세스가 거부되었습니다" 오류 발생 시:
|
|
1. 명령 프롬프트를 관리자 권한으로 실행
|
|
2. `fix_dependencies.py` 실행
|
|
3. 또는 `fix_deps_admin.bat` 더블클릭
|
|
|
|
## 🔍 문제 해결
|
|
|
|
### 일반적인 문제들
|
|
|
|
**Q: scipy 1.14.1이 없다고 나옵니다.**
|
|
A: scipy 1.14.1은 존재하지 않는 버전입니다. 스크립트가 자동으로 1.11.4로 수정합니다.
|
|
|
|
**Q: ONNX Runtime 설치가 실패합니다.**
|
|
A: 현재 프로세스에서 사용 중일 수 있습니다. 모든 Python 프로세스를 종료 후 관리자 권한으로 재시도하세요.
|
|
|
|
**Q: 빌드 시 numpy 오류가 발생합니다.**
|
|
A: numpy 1.26.4로 고정되어 있는지 확인하세요. `check_dependencies.py`로 확인 가능합니다.
|
|
|
|
## 📊 상태 확인
|
|
|
|
의존성 상태를 확인하려면:
|
|
```bash
|
|
python -c "
|
|
import numpy, scipy, onnxruntime, cv2
|
|
print(f'numpy: {numpy.__version__}')
|
|
print(f'scipy: {scipy.__version__}')
|
|
print(f'onnxruntime: {onnxruntime.__version__}')
|
|
print(f'opencv: {cv2.__version__}')
|
|
"
|
|
```
|
|
|
|
## 🎯 ONNX 모듈 전환 완료
|
|
|
|
- ✅ PaddlePaddle → ONNX Runtime 완전 전환
|
|
- ✅ 3.6배 빠른 CPU 성능
|
|
- ✅ 호환성 문제 해결
|
|
- ✅ 메모리 사용량 최적화
|