Справка / Установка и решение проблем
Установка, обновление и место на диске
Потянет ли мой Mac? Память, чип, диск и время рендера для каждого Mac на Apple Silicon на одной странице.
Phosphene работает на Mac с Apple Silicon (M1 или новее) через Pinokio. На этой странице описано, как его установить и обновить, сколько нужно места на диске и что делать, если какой-то шаг не удался.
Установка через Pinokio
- Установите Pinokio.
- В Pinokio откройте Discover, выберите Download from URL и вставьте
https://github.com/mrbizarro/phosphene. - Нажмите Install. Сначала установщик проверяет свободное место на диске. Если его недостаточно, он останавливается и показывает, сколько нужно и сколько есть.
- Когда установка закончится, нажмите Start, затем Open Panel. Панель открывается по адресу
http://127.0.0.1:8198.
Приложение открывается, когда готовы среда Python и пакеты движка, обычно через несколько минут. Модели не скачиваются ни до запуска Start, ни автоматически при первом открытии. Выберите, что хотите делать, и скачайте для этого модель.
Примечание Pinokio не может установить Phosphene на Mac с процессором Intel или на Windows. Поддержка Linux на Apple Silicon: отдельный проект сообщества, который Pinokio не устанавливает. См. Linux (сообщество).
Что скачивается и сколько нужно места
| Часть | Загрузка | Когда |
|---|---|---|
| Среда приложения: Python и пакеты движка | Около 0,5 ГБ; версии пакетов могут это изменить | До Start. Оставьте 18 ГБ свободными, включая 15 ГБ, которые всегда остаются свободными |
| Видеомодели LTX-2.5 Q4, включая кодировщик промптов | Около 27,5 ГБ | Нажмите Скачать модели для видео в приложении. Рекомендуется для первого видео |
| Дополнения к функциям: Gemma 3 для «Улучшить» и планировщика Storyboard, а также адаптеры для «Апскейл и Исправление лица», «Управление движением», Ingredients и Colorize | 10,7 ГБ, если выбрать все | Скачивайте только те, которыми пользуетесь, из самой функции или из Моделей |
| Модели изображений | Размер указан рядом с выбранной моделью | При первом нажатии «Создать». FLUX.2 [klein] 4B: компактный вариант для начала, около 4,3 ГБ |
| Веса LTX-2.5 Q8 для обученных персонажей и голосов | 30,02 ГБ | Необязательно, из Настройки → Модели или боковой панели Pinokio |
| Дополнение High для качества «Высокое», «Ключевых кадров» и «Продлить» в LTX | 29,50 ГБ | Необязательно, из окна «Модели» (нажмите индикатор состояния, затем Модели) |
| Hailuo H3, второй видеодвижок | около 75 ГБ | Необязательно, из боковой панели Pinokio. См. Hailuo H3 |
| Музыкальный движок (YuE2) | около 11 ГБ | Необязательно, со вкладки «Аудио» или из боковой панели Pinokio. См. Музыкальная студия |
| LTX-2.3, нужен только чтобы обучать персонажа | около 20 ГБ плюс около 21 ГБ для тренера | Предлагается, когда вы открываете Обучить персонажа |
При скорости соединения 100 Мбит/с видеомодели скачиваются примерно 37 минут. При 300 Мбит/с это около 12 минут, при 1 Гбит/с около 4 минут. Пока модели скачиваются, приложение можно не закрывать. На карточке модели показаны полученные байты, текущий файл и оставшиеся пакеты. Остановить загрузку останавливает всю загрузку видео; нажмите Скачать модели для видео снова, чтобы продолжить. Скачанные файлы остаются на диске. Загрузки из «Моделей» оставляют 15 ГБ свободными и ждут, если места становится мало.
Если функции нужно дополнение, которое ещё не докачалось, она показывает сообщение о загрузке или предлагает Скачать сейчас. Без сообщения она не завершается ошибкой.
Совет Можно добавить токен доступа Hugging Face в Настройках: загрузки станут примерно в десять раз быстрее. Единственное дополнение, которому этот токен обязателен, это HDR. Всё остальное работает без него.
Хранение моделей на внешнем диске
Модели занимают больше всего места. В приложении для Mac (5.0.20 или новее) их можно хранить на внешнем диске и освободить место на Mac.
- Выберите, где будут модели, при настройке: в строке Models go on … есть кнопка Change, затем Another drive or folder…. Это можно выбрать и позже в Настройки > Модели.
- Переместить позже. В Настройки > Модели кнопка Переместить на другой диск… копирует модели на диск и проверяет каждый файл. Только после этого копия на вашем Mac удаляется. Move back to this Mac копирует их обратно и оставляет копию на диске; удалите её в Finder, если нужно место. Во время перемещения виден ход выполнения и есть кнопка Стоп, а остановленное перемещение продолжится, когда вы запустите его снова. Пока модели переносятся, Studio закрывается, а когда они на месте, открывается снова.
- Перемещаются только модели. Приложение и его движок остаются на вашем Mac, поэтому Phosphene всегда открывается.
- Если диск отключён, приложение показывает “(the drive’s name) isn’t connected”. Подключите его и выберите Проверить снова, либо выберите Скачать вместо этого, чтобы скачать черновые модели (около 27,5 ГБ) на этот Mac, либо выберите Open without them.
- Формат диска. Диски APFS и exFAT подходят. FAT32 не вмещает файлы больше 4 ГБ, а некоторые файлы моделей больше, поэтому Phosphene отказывается работать с диском FAT32. Если часть ваших моделей общая с установкой Pinokio, используйте диск APFS или Mac OS Extended.
Пока работает Phosphene, диск должен быть подключён.
Проверьте память вашего Mac
От памяти Mac зависит, какие настройки качества и какие движки вам доступны. Phosphene проверяет это автоматически. Чтобы посмотреть, что может ваш Mac, нажмите индикатор состояния в шапке, затем Уровень.
| Функция | Нужная память |
|---|---|
| Видео LTX и «Изображения» | Любой Mac с Apple Silicon. При памяти меньше 48 ГБ доступны меньшие размеры видео. Качество «Высокое», «Начальный и конечный кадры» и «Продлить» в LTX скрыты. Mac с 24 ГБ или меньше автоматически используют путь для видео с малым расходом памяти: на Mac с 16 ГБ клип в пике занимает около 5,7 ГБ памяти, с LoRA около 6,7 ГБ. |
| Музыкальная студия | 16 ГБ или больше. Для длинных песен при открытых других приложениях рекомендуется 24 ГБ или больше |
| Обучение персонажа | 24 ГБ или больше |
| Hailuo H3 | 16 ГБ или больше («Черновик» и «Стандартное» с 16 ГБ, «Высокое» с 18 ГБ). С 60 ГБ и больше можно выбрать и полный движок |
| LTX «Высокое» · 720p | Mac с 64 ГБ; расход памяти в пике около 50 ГБ |
Перед долгим рендером закройте приложения, которые много расходуют память, например браузеры с большим числом вкладок, Slack или iOS Simulator. Рендер это процесс создания вашего видео или аудио. Если памяти Mac не хватает, он останавливает рендер. См. Устранение неполадок.
Боковая панель Pinokio
Выберите Phosphene в Pinokio, и в левой боковой панели появятся эти действия. Какие действия доступны, зависит от того, что установлено и запущена ли панель.
- Install / Resume Install: установить необходимые файлы. Resume Install появляется, если прошлая попытка не завершилась. Файлы, которые уже скачались, сохраняются.
- Start, Open Panel, Terminal: нажмите Start, чтобы запустить Phosphene, затем Open Panel, чтобы им пользоваться. Terminal показывает его журнал работы.
- Update: см. Обновление.
- Outputs, Models, Uploads: открывают эти папки в Finder.
- Install Hailuo H3 (second video engine, ~75 GB): после установки превращается в Repair Hailuo H3 или Update Hailuo H3 runner. Оба сохраняют скачанные файлы модели.
- Build Hailuo H3 compact engine: появляется на Mac с 16-59 ГБ, когда файлы модели скачаны, а компактный движок ещё не готов. Занимает около 5 минут и ничего не скачивает.
- Install the music engine (YuE2, ~11 GB): после установки превращается в Repair the music engine, который сохраняет скачанные файлы модели.
- Reset engine (keeps models & outputs): пересобрать движок LTX и нужное ему ПО. Ваши модели и готовые работы сохраняются. На Hailuo H3 это не влияет; чтобы починить H3, используйте Repair Hailuo H3.
Обновление Phosphene
- Индикатор версии в шапке показывает Up to date либо Update to и более новую версию. Когда обновление доступно, нажмите Обновить сейчас в баннере, чтобы установить его, или Позже, чтобы подождать.
- Нажмите Update в боковой панели Pinokio, чтобы обновить всё, включая вспомогательное ПО. Очередь, настройки, модели и готовые работы сохраняются.
- После обновления из приложения баннер сообщает “Updated to … - restart to finish”. Нажмите Stop, затем Start в Pinokio.
- Если вы обновляетесь с очень старой версии и меняется, кажется, только панель, нажмите Update ещё раз. Первое обновление заменяет сам обновлятор.
- Если Update в Pinokio останавливается в первую секунду (версии 4.19.6 и старше могут так делать), нажмите Обновить сейчас в собственном баннере Phosphene или в индикаторе версии, затем перезапустите. См. Обновление сразу останавливается.
- Если панель всё ещё ведёт себя как старая версия, её нужно перезапустить. Тогда индикатор версии показывает Restart Phosphene. Нажмите его либо нажмите Stop, а затем Start в Pinokio.
- У Hailuo H3 и музыкального движка своё вспомогательное ПО. Если панель сообщает, что одному из них нужно обновление, нажмите пункт Update или Repair этого движка в боковой панели Pinokio. Скачанные файлы модели сохраняются.
Обновление вручную (если обновление не приходит)
Phosphene сам проверяет обновления, но медленное или заблокированное соединение может помешать обновлению дойти. Новейшую версию всегда можно установить самому. Ваши модели, готовые работы, настройки и лицензия Pro сохраняются.
Приложение для Mac
- Закройте Phosphene (Phosphene → Quit, либо Cmd+Q).
- Скачайте новейший установщик со страницы phosphene.video/download (тот же файл приложен к каждому релизу на GitHub).
- Откройте скачанный
.dmgи перетащите Phosphene в Applications. Когда Mac спросит, выберите Replace. - Откройте Phosphene из Applications. Индикатор версии в шапке покажет новую версию.
Оставьте одну копию, ту, что в Applications. Старые копии, оставшиеся в «Загрузках» или на диске установщика, могут открываться вместо новой: перенесите их в Корзину и извлеките любой диск Phosphene в боковой панели Finder. Ваши работы лежат в ~/Library/Application Support/Phosphene, а не внутри приложения, так что замена или удаление приложения ничего из них не удаляет.
Pinokio
- Нажмите Stop в боковой панели Pinokio для Phosphene.
- Откройте приложение «Терминал», перейдите в папку Phosphene (
cd ~/pinokio/api/<your Phosphene folder>) и выполнитеgit pull. - Нажмите Update в боковой панели, затем Start.
Если git pull сообщает о локальных изменениях, сначала выполните git stash, затем снова git pull.
Если установка или обновление остановились с ошибкой
Если обязательный шаг не удаётся, Pinokio останавливается и показывает строку, начинающуюся с FATAL error:. Прокрутите вверх журнал, который Pinokio показывает для этой установки или обновления, чтобы её найти. Строка объясняет проблему и что нажать дальше. Почти всегда ничего не удалено. Исправив проблему, нажмите Install или Update снова, чтобы продолжить.
По таблице ниже найдите текст после FATAL error::
| В строке сказано | Что делать |
|---|---|
| not enough disk space to install Phosphene | Освободите указанное место, затем снова нажмите Install |
| could not download the video engine version Phosphene needs … (a VPN, proxy or blocked GitHub is the usual cause) | Проверьте соединение, отключите VPN или прокси, затем снова нажмите Install или Update |
| the engine environment did not install after 3 attempts | Проверьте подключение к интернету и свободное место на диске, затем снова нажмите Install или Update. Если это повторяется, сообщите об этой строке по инструкции ниже |
| the video engine is on the wrong version | Снова нажмите Install или Update. Если это повторяется, сообщите об этой строке |
| Hailuo H3 needs a Mac with at least 16 GB of memory | Ваш Mac не может запускать H3. Продолжайте пользоваться LTX, в нём есть все режимы, кроме «Добавить звук» |
| Hailuo H3 needs about N GB of free disk space | Для новой установки нужно около 97 ГБ (75 ГБ загрузки плюс 22 ГБ компактного движка) или около 25 ГБ, если файлы модели уже скачаны. Освободите место, затем снова нажмите Install Hailuo H3 |
| the compact Hailuo H3 engine could not be built | Обычно это значит, что диск заполнен (для сборки нужно около 22 ГБ). Освободите место, затем снова нажмите пункт H3 в боковой панели Pinokio. Он пересоберётся из скачанных файлов модели |
| a Phosphene render has been running for over 60 minutes, so the compact Hailuo H3 engine was not built | Подождите, пока Phosphene закончит текущий рендер, затем снова нажмите пункт H3 в боковой панели Pinokio |
| the H3 venv has no working Python | Нажмите Repair Hailuo H3 в боковой панели Pinokio. Скачанные файлы модели сохраняются |
| YuE2 (the music engine) needs a Mac with at least 16 GB of memory | Этот Mac не может запускать музыкальный движок. На остальную часть Phosphene это не влияет |
| YuE2 (the music engine) needs at least 14 GB free | Освободите место, затем снова нажмите Install the music engine |
| could not download the YuE2 music engine | Проверьте подключение к интернету и не блокирует ли GitHub VPN или прокси, затем снова нажмите Install the music engine |
| untracked/ignored paths obstruct Update. Move them; nothing deleted. | Файлы, которые вы добавили внутрь папки приложения, мешают обновлению. Строки чуть выше их перечисляют. Перенесите их из папки Phosphene, затем снова нажмите Update |
| fetch failed (offline?) - nothing changed, re-run Update | Восстановите соединение, затем снова нажмите Update |
| the Update safety check did not pass - not updating | Ничего не изменено. Снова нажмите Update. Если это повторяется, сообщите об этой строке |
Если вашей ошибки в списке нет, следуйте инструкциям в её строке FATAL error:. Чтобы сообщить об ошибке, скопируйте эту строку и несколько строк над ней в отчёт об ошибке. См. Как сообщить о проблеме.
Начать заново, не потеряв свои работы
- Нажмите Reset engine в Pinokio, чтобы пересобрать движок LTX. Ваши модели, готовые работы и настройки сохраняются.
- Чтобы найти готовые работы, нажмите Outputs в боковой панели Pinokio. Откроется
mlx_outputsвнутри папки Phosphene. - Чтобы найти скачанные модели, нажмите Models в боковой панели. Откроется
mlx_models. Не удаляйте эту папку, если не хотите заново скачивать всё.
Если Phosphene открывается, но задача не выполняется, моделей не хватает или очередь встаёт на паузу, см. Устранение неполадок.
Источник: webapp/docs/install.md в открытом репозитории. Проверено для этого сайта перед публикацией. Переведено с английского оригинала. Предложить правку.