>> ImageMagick 오류 해결: MoneyPrinterTurbo를 uv sync --frozen으로 설치 (Windows 원클릭 vs Mac/Linux uv)
MoneyPrinterTurbo를 clone했는데 창이 바로 닫히거나 Streamlit traceback, ImageMagick is not installed 자막 오류가 나면 v1.2.7 이후 권장 경로인 uv와 uv sync --frozen을 따르세요.
소개
소스는 있지만 Python 환경이 없는 초보자를 위한 7단계 가이드입니다. Python 3.11, 잠긴 의존성, ImageMagick 경로, Streamlit UI까지 다룹니다.
Windows 원클릭은 해당 OS에서 가장 빠른 체험입니다. macOS/Linux에서는 uv sync --frozen이 1순위입니다.
Evals·Agent 등 넓은 AI 역량은 2026 개발자 AI 스킬 참고(설치와 별개).
설치 경로 선택
| 경로 | 대상 | 시간 | 도구 |
|---|---|---|---|
| Windows 원클릭 | Windows 빠른 데모 | ~10분 | 번들 바이너리 |
uv sync --frozen | macOS/Linux/수동 Windows | ~15–25분 | uv + uv.lock |
| Docker | 격리 환경 | ~15분 | docker compose |
아키텍처
| 구성요소 | 역할 | 포트 |
|---|---|---|
| Streamlit Web UI | 브라우저 패널 | 8501 |
| FastAPI | API(선택) | 8080 |
| ImageMagick | 자막 렌더 | CLI |
| FFmpeg | 영상 합성 | CLI |
config.toml의 imagemagick_path 오류 시 첫 자막 작업에서 즉시 실패합니다.
사전 요구
- Git, uv, ImageMagick 7, FFmpeg
- Python 3.11
- Windows 경로에 비 ASCII(중국어 폴더 등) 금지
7단계 런북
1단계 — clone
git clone https://github.com/harry0703/MoneyPrinterTurbo.git && cd MoneyPrinterTurbo
2단계 — Python 3.11
uv python install 3.11 && uv python list
3단계 — uv sync --frozen
lockfile 정확 버전 설치. 캐시 시 40–90초.
4단계 — ImageMagick
macOS
brew install imagemagick → /opt/homebrew/bin/magick
Linux
sudo apt-get install -y imagemagick ffmpeg
Windows
ImageMagick Q16-x64-static 기본 경로 설치.
5단계 — policy.xml
not authorized 시 policy에서 @* read|write 허용.
6단계 — Streamlit
uv run streamlit run ./webui/Main.py --browser.gatherUsageStats=False --server.port 8501
7단계 — 스모크 테스트
10–15초 클립으로 자막 확인.
문제 해결
오류 A — 창이 바로 닫힘
터미널에서 streamlit 명령 실행.
오류 B — ImageMagick 없음
| 확인 | 명령 |
|---|---|
| 바이너리 | magick -version |
| Windows 경로 | config.toml 이중 백슬래시 |
오류 C — UI 지연
첫 컴파일, FFmpeg, RAM 8GB+, 포트 8502 시도.
의존성 갱신
git pull 후 uv sync --frozen. lock 변경 시만 uv sync.
FAQ
uv sync --frozen?uv.lock 고정 버전으로 .venv 재현.
Windows static 빌드?
MoviePy/자막 호환을 위해 upstream이 Q16-x64-static 요구.
pip 가능?
레거시 가능, v1.2.7+ 주 경로는 uv.
포트?
Streamlit 8501, API 8080.
클라우드 Mac 필수?
아니요. 로컬로 충분.
원클릭 vs uv?
체험은 원클릭, 최신 코드·macOS/Linux는 uv.