トラブルシュート
token 周りの失敗
HF_TOKEN が見つからないと言われたら:
.env.exampleを.envにコピーHF_TOKENを設定- Hugging Face 側でモデルアクセスが承認されているか確認
6GB GPU のメモリ圧迫
保存済み実験は RTX 3060 6GB 環境で取得しています。実務上の目安は次の通りです。
max-side 256が最も安全balanced / 320 / 4 stepsは重い入力で失敗することがあるhardはメモリ改善ではなく、境界の二値化寄り挙動を変えるだけ
CPU offload の注意
この Windows 環境では --cpu-offload が安定しません。デコード時にバックエンド/カーネル系の失敗を確認しています。
docs のローカルビルド
powershell
Set-Location .\docs
npm install
npm run docs:build