ヘルプ / インストールとトラブルシューティング
インストール、更新、ディスク容量
お使いのMacで動きますか? すべてのApple Silicon Macのメモリ、チップ、ディスク容量、レンダリング時間を1ページにまとめました。
PhospheneはPinokio経由で、Apple SiliconのMac(M1以降)で動作します。このページでは、インストールとアップデートの方法、必要なディスク容量、途中でつまずいたときの対処を説明します。
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からIntel MacやWindowsにPhospheneをインストールすることはできません。Apple SiliconでのLinux対応は別のコミュニティプロジェクトで、Pinokioではインストールされません。Linux(コミュニティ)を参照してください。
ダウンロードされるもの、必要な容量
| 内容 | ダウンロード量 | タイミング |
|---|---|---|
| アプリのランタイム:Pythonとエンジンのパッケージ | 約0.5 GB。パッケージのバージョンによって変わることがあります | Startの前。18 GBの空きを確保してください(空きとして残す15 GBを含みます) |
| LTX-2.5 Q4の動画モデル(プロンプトエンコーダーを含む) | 約27.5 GB | アプリ内で動画モデルをダウンロードをクリック。最初の動画づくりにおすすめ |
| 機能の追加分:強化と絵コンテのプランナー用のGemma 3、アップスケール&フェイス修正、モーションコントロール、Ingredients、カラー化用のアダプター | すべて選ぶと10.7 GB | 使うものだけ、各機能またはモデルからダウンロードしてください |
| 画像モデル | 選択したモデルの横に表示 | 最初の生成時。FLUX.2 [klein] 4Bはコンパクトなので始めやすく、約4.3 GB |
| LTX-2.5 Q8のウェイト(学習したキャラクターと声用) | 30.02 GB | 任意。設定 → モデルまたはPinokioのサイドバーから |
| ハイのアドオン(LTXのハイ画質、キーフレーム、延長用) | 29.50 GB | 任意。モデルのウィンドウから(ヘルスチップをクリックしてモデルを選択) |
| Hailuo H3(2つ目の動画エンジン) | 約75 GB | 任意。Pinokioのサイドバーから。Hailuo H3を参照 |
| 音楽エンジン(YuE2) | 約11 GB | 任意。オーディオタブまたはPinokioのサイドバーから。Music Studioを参照 |
| LTX-2.3(キャラクターを学習するときのみ必要) | 約20 GB、さらにトレーナーに約21 GB | キャラクターを学習を開くと案内されます |
回線速度が100 Mbpsなら、動画モデルのダウンロードには約37分かかります。300 Mbpsなら約12分、1 Gbpsなら約4分です。モデルのダウンロード中もアプリを開いたままにできます。モデルカードには、受信済みのバイト数、現在のファイル、残りのパックが表示されます。ダウンロードを停止は動画のダウンロード全体を止めます。動画モデルをダウンロードをもう一度クリックすると再開します。ダウンロード済みのファイルはディスクに残ります。モデルからのダウンロードは15 GBの空きを保ち、容量が足りなくなると待機します。
機能に必要な追加分のダウンロードが完了していない場合は、ダウンロードを促すメッセージが表示されるか、今すぐダウンロードが提示されます。何も表示せずに失敗することはありません。
ヒント 設定でHugging Faceのアクセストークンを追加すると、ダウンロードが約10倍速くなります。このトークンが必須なのはHDRのアドオンだけで、それ以外はトークンなしで使えます。
モデルを外付けドライブに置く
容量の大部分はモデルが占めます。Macアプリ(5.0.20以降)では、モデルを外付けドライブに置いて、Macの空きを増やせます。
- モデルの置き場所を選ぶのはセットアップ時です。*「Models go on …」*の行に変更ボタンがあり、別のドライブまたはフォルダ… を選びます。あとから設定 > モデルで選ぶこともできます。
- あとから移動する。設定 > モデルの別のドライブに移動… を選ぶと、モデルをドライブにコピーし、すべてのファイルを確認します。その後で初めて、Mac上のコピーを削除します。このMacに戻すは、モデルをMacに戻し、ドライブ上のコピーはそのまま残します。容量が必要なら、Finderで削除してください。移動中は進捗が表示され、停止ボタンもあります。停止した移動は、もう一度始めると再開します。モデルの移動中はStudioが閉じ、配置が終わると再び開きます。
- 移動するのはモデルだけです。アプリとエンジンはMacに残るので、Phospheneは常に開きます。
- ドライブが外れているとき、アプリには*「(ドライブ名)isn’t connected」*と表示されます。ドライブを接続して再確認を選ぶか、代わりにダウンロードを選んでドラフト用のモデル(約27.5 GB)をこのMacに入れるか、モデルなしで開くを選んでください。
- ドライブのフォーマット。APFSとexFATのドライブが使えます。FAT32は4 GBを超えるファイルを扱えず、モデルファイルには4 GBを超えるものがあるため、PhospheneはFAT32のドライブを受け付けません。モデルの一部をPinokioのインストールと共有している場合は、APFSまたはMac OS拡張のドライブを使ってください。
Phospheneを実行している間は、ドライブを接続したままにしてください。
Macのメモリを確認する
Macのメモリによって、使える画質設定とエンジンが決まります。Phospheneは自動で確認します。Macで何が動くかを見るには、ヘッダーのヘルスチップをクリックしてティアを選びます。
| 機能 | 必要なメモリ |
|---|---|
| LTX動画と画像 | Apple SiliconのMacならどれでも。48 GB未満では、動画のサイズが小さくなります。LTXのハイ画質、開始・終了フレーム、延長は非表示です。24 GB以下のMacは、自動で低メモリの動画パスを使います。16 GBのMacではクリップ1本のピークが約5.7 GB、LoRA使用時は約6.7 GBです。 |
| Music Studio | 16 GB以上。ほかのアプリを開いたまま長い曲を作るなら、24 GB以上を推奨 |
| キャラクターの学習 | 24 GB以上 |
| Hailuo H3 | 16 GB以上(ドラフトと標準は16 GBから、ハイは18 GBから)。60 GB以上なら、フルエンジンも選べます |
| LTXのハイ · 720p | 64 GBのMac。メモリ使用量は約50 GBでピークになります |
長いレンダリングの前に、タブを多く開いたブラウザ、Slack、iOSシミュレータなど、メモリを大量に使うアプリを閉じてください。レンダリングとは、動画や音声を作る処理のことです。Macのメモリが足りなくなると、レンダリングは停止します。トラブルシューティングを参照してください。
Pinokioのサイドバー
PinokioでPhospheneを選ぶと、左のサイドバーに次の操作が表示されます。表示される操作は、インストール済みのものと、パネルが動作中かどうかによって変わります。
- 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:16〜59 GBのMacで、モデルファイルはダウンロード済みなのにコンパクトエンジンの準備ができていないときに表示されます。約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をアップデートする
- ヘッダーのバージョン表示には、最新、またはアップデートに続けて新しいバージョンが表示されます。アップデートがあるときは、バナーの今すぐアップデートでインストールするか、あとでで見送ります。
- PinokioのサイドバーでUpdateをクリックすると、補助ソフトウェアを含めてすべてを更新します。キュー、設定、モデル、完成した作品は保持されます。
- アプリ内でアップデートしたあとは、バナーに*「Updated to …(アップデート完了、再起動してください)」*と表示されます。PinokioでStop、続けてStartをクリックしてください。
- とても古いバージョンからアップデートして、パネルだけが変わったように見える場合は、もう一度Updateをクリックしてください。最初のアップデートでは、アップデーター自体が置き換えられます。
- PinokioのUpdateが最初の1秒で止まる場合(バージョン4.19.6以前で起こることがあります)は、代わりにPhospheneのバナーまたはバージョン表示から今すぐアップデートをクリックして、再起動してください。アップデートがすぐ止まるを参照してください。
- パネルがまだ古いバージョンのように動く場合は、再起動が必要です。バージョン表示はPhospheneを再起動に変わります。それをクリックするか、PinokioでStop、続けてStartをクリックしてください。
- Hailuo H3と音楽エンジンの補助ソフトウェアは別々です。どちらかの更新が必要だとパネルに表示されたら、PinokioのサイドバーでそのエンジンのUpdateまたはRepairの項目をクリックしてください。ダウンロード済みのモデルファイルは保持されます。
手動でアップデートする(アップデートが届かないとき)
Phospheneは自動でアップデートを確認しますが、回線が遅い、またはブロックされていると、届かないことがあります。いつでも最新版を自分でインストールできます。モデル、完成した作品、設定、Proライセンスは保持されます。
Macアプリ
- Phospheneを終了します(Phosphene → 終了、またはCmd+Q)。
- phosphene.video/downloadから最新のインストーラーをダウンロードします(同じファイルは各GitHubリリースにも添付されています)。
- ダウンロードした
.dmgを開き、Phospheneをアプリケーションにドラッグします。Macから確認されたら置き換えるを選びます。 - アプリケーションからPhospheneを開きます。ヘッダーのバージョン表示に新しいバージョンが表示されます。
コピーは、アプリケーションにある1つだけにしてください。ダウンロードフォルダやインストーラーディスクに古いコピーが残っていると、新しいほうではなくそちらが開くことがあります。古いコピーはゴミ箱に入れ、FinderのサイドバーにあるPhospheneディスクがあれば取り出してください。作品は、アプリの中ではなく ~/Library/Application Support/Phosphene にあるので、アプリを置き換えたり削除したりしても、作品は消えません。
Pinokio
- PhospheneのPinokioサイドバーでStopをクリックします。
- ターミナルアプリを開き、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を使ってください。LTXには、音を追加以外のすべてのモードがあります |
| Hailuo H3 needs about N GB of free disk space | 新規インストールには約97 GB(75 GBのダウンロードと22 GBのコンパクトエンジン)が必要で、モデルファイルがダウンロード済みなら約25 GBです。容量を空けて、もう一度Install Hailuo H3をクリックします |
| the compact Hailuo H3 engine could not be built | たいていはディスクがいっぱいです(ビルドに約22 GB必要)。容量を空けて、Pinokioのサイドバーでもう一度H3の項目をクリックします。ダウンロード済みのモデルファイルから作り直します |
| a Phosphene render has been running for over 60 minutes, so the compact Hailuo H3 engine was not built | Phospheneが現在のレンダリングを終えるのを待ってから、Pinokioのサイドバーでもう一度H3の項目をクリックします |
| the H3 venv has no working Python | PinokioのサイドバーでRepair Hailuo H3をクリックします。ダウンロード済みのモデルファイルは保持されます |
| 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 | インターネット接続を確認し、VPNやプロキシがGitHubをブロックしていないか調べてから、もう一度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: の行の指示に従ってください。エラーを報告するには、その行と、その上の数行をバグレポートにコピーしてください。問題を報告するを参照してください。
作品を失わずにやり直す
- PinokioでLTXエンジンを作り直すには、Reset engineをクリックします。モデル、完成した作品、設定は保持されます。
- 完成した作品を探すには、PinokioのサイドバーでOutputsをクリックします。Phospheneのフォルダ内の
mlx_outputsが開きます。 - ダウンロードしたモデルを探すには、サイドバーでModelsをクリックします。
mlx_modelsが開きます。すべてをダウンロードし直したい場合以外は、このフォルダを削除しないでください。
Phospheneは開くのにタスクが失敗する、モデルがない、キューが一時停止する、といった場合は、トラブルシューティングを参照してください。
出典:webapp/docs/install.md(公開リポジトリ)。公開前にこのウェブサイト向けに確認済みです。英語の原文から翻訳しています。編集を提案する。