>> Ошибки ImageMagick и зависимостей: MoneyPrinterTurbo через uv sync --frozen (one-click на Windows, uv на Mac/Linux)
Вы клонировали MoneyPrinterTurbo — окно мигнуло и закрылось, Streamlit показал traceback или субтитры падают с ImageMagick is not installed. С v1.2.7 основной путь — uv и uv sync --frozen.
Введение
Для новичков с исходниками, но без рабочего Python: версия 3.11, зависимости по lockfile, путь ImageMagick, запуск Streamlit.
One-click на Windows — самый быстрый тест. На macOS/Linux в приоритете uv sync --frozen.
Шире про AI-навыки: навыки ИИ разработчика в 2026.
Выбор пути установки
| Путь | Кому | Время | Инструмент |
|---|---|---|---|
| One-click 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 |
Предварительные требования
- Git, uv, ImageMagick 7, FFmpeg
- Python 3.11
- На Windows путь без не-ASCII символов
Runbook из 7 шагов
Шаг 1 — Клонирование
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
Точные версии из uv.lock для v1.2.7.
Шаг 4 — ImageMagick
macOS
brew install imagemagick
Linux
sudo apt-get install -y imagemagick ffmpeg
Windows
Установщик Q16-x64-static с imagemagick.org.
Шаг 5 — policy.xml
При not authorized разрешить @* read|write.
Шаг 6 — Streamlit
uv run streamlit run ./webui/Main.py --browser.gatherUsageStats=False --server.port 8501
Шаг 7 — Дымовой тест
Клип 10–15 с с читаемыми субтитрами.
Устранение неполадок
Ошибка A — Окно сразу закрывается
Запускайте из терминала.
Ошибка B — ImageMagick не найден
| Проверка | Действие |
|---|---|
| Бинарник | magick -version |
| Windows | Двойные обратные слэши в config.toml |
Ошибка C — Тормозит UI
Первый запуск компилирует кэш; проверьте FFmpeg; 8 ГБ+ RAM; порт 8502.
Обновление зависимостей
После git pull: uv sync --frozen.
FAQ
Что делает uv sync --frozen?
Создаёт .venv по точным версиям uv.lock.
Зачем static ImageMagick на Windows?
Требование upstream Q16-x64-static для MoviePy/субтитров.
Можно pip?
Да, legacy; с v1.2.7 основной путь — uv.
Порты?
8501 Streamlit, 8080 API.
Нужен облачный Mac?
Нет — достаточно локальной машины.
One-click или uv?
Быстрый тест Windows vs. актуальный main на macOS/Linux.
Связанные материалы
Runbook не помог?
Сохраните полный traceback терминала и проверьте upstream GitHub Issues.