English · 公式サイト · 最新版 · 不具合を報告
Mozarieは、画像のモザイク範囲をローカルで検出・編集するWindowsアプリです。
主な機能
- PNG、JPEG、WebPの画像・フォルダーを読み込み、現在または全画像を自動検出
- 候補の確認、除外、削除、モザイク／除外ブラシ・消しゴム・境界ツールによる修正
- 手の領域の除外と、モザイクより優先する強制除外
- 現在画像、モザイクあり、確認済みのコピー保存または元画像への上書き
- 非表示にした画像は一覧の通常表示、全画像自動検出、保存・マスク出力の対象から除外。元画像と編集データは保持し、再表示すると作業を続けられます
インストール
動作環境
- Windows
- 64-bit Python（Python Launcher
py）
- NVIDIA/CUDA: Python 3.11〜3.14
- AMD/DirectML: Python 3.11 または3.12
- CPU: Python 3.11 または3.12
セットアップ
.\setup.bat
setup.batはGPUを検出し、NVIDIA/CUDA、AMD/DirectML、CPUの順に選択します。手動で選ぶ場合は、実行前にMOZARIE_RUNTIMEを指定します。
| 値 | バックエンド |
|---|
cuda | NVIDIA/CUDA |
directml | AMD/DirectML |
cpu | CPU |
AMD/DirectMLを指定する例:
$env:MOZARIE_RUNTIME = "directml"
.\setup.bat
CUDA版とDirectML版のONNX Runtimeは同じ.venvへ混在させないでください。既存環境と選択したバックエンドが異なる場合、setup.batはパッケージを変更せず停止します。バックエンドを切り替える場合は、必要に応じて.venvをバックアップして削除し、setup.batを再実行します。
run.batは.venvのセットアップ情報がない場合、起動せずsetup.batを案内します。
起動
.\run.bat
初回起動後、設定 > 検出で基本モデルを指定します。
モデル
アプリからダウンロード
設定 > 検出で使うモデルのダウンロードを選びます。SAMは選択中の種類だけを取得します。
自分で用意するモデル
NTD11は成人向けモデルです。Civitai.comへログインして年齢確認を済ませ、ZIPを取得・展開します。匿名アクセスでの取得は保証されません。
モデルは設定 > 検出の参照から指定します。
| 用途 | 用意するもの | 配布元 |
|---|
| 基本の性器検出 | 配布元のONNX（変換不要） | 配布元 |
| NTD11補助検出 | NTD11 ZIP内の.ptをONNXに変換 | NTD11 ZIPを取得 |
| Sensitive補助検出 | Sensitiveの.ptをONNXに変換 | 配布元 |
.pt ファイルの注意: NTDを含むPyTorchの.ptは読み込み時にpickle経由でコードを実行し得るため、記載した配布元以外の.ptは使用しないでください。
setup.bat実行後、MozarieフォルダーでPowerShellを開き、変換コマンドを実行します。
NTD11の変換:
& ".\.venv\Scripts\yolo.exe" export model="ダウンロードしたNTD11の.ptファイルのパス" format=onnx imgsz=1024 batch=1 dynamic=False simplify=False opset=17 nms=False end2end=False device=cpu
Sensitiveの変換:
& ".\.venv\Scripts\yolo.exe" export model="ダウンロードしたSensitiveの.ptファイルのパス" format=onnx imgsz=1024 batch=1 dynamic=False simplify=False opset=17 nms=False end2end=False device=cpu
変換したONNXは元の.ptと同じフォルダーに同名で保存されます。設定でそのONNXを指定し、モデルの状態が有効なことを確認して検出を実行します。
モデルの配布条件・ライセンスは、各配布元と第三者ライセンス・モデル配布元を確認してください。
使い方
自動検出の同時処理数は、GPU・CPUともに1以上で指定できます。実効上限は対象画像数です。DirectMLでは実効並列数は1になります。
- 画像またはフォルダーを読み込みます。
- 現在の画像または全画像に自動検出を実行します。
- 右側の候補を確認し、必要に応じてブラシ、消しゴム、境界ツールで修正します。
- 保存対象を選び、コピー保存または元画像へ上書きします。
非表示は元画像を削除せず、候補、手描き、確認状態も保持します。非表示中の画像は全画像自動検出、保存、マスク出力を開始できません。再表示してから編集または出力してください。
GPUを使う場合は、設定 > 検出で選択します。GPUが対応しない演算はCPUが補助します。GPUの初期化・実行に失敗してもCPUで自動再試行しません。GPUメモリが不足した場合は、ほかのGPUアプリを閉じるかCPUへ切り替えてください。
更新
設定の更新を確認、またはupdate.batを使います。適用前にMozarieを終了します。設定、モデル、作業中の画像は更新後も保持されます。依存関係の更新後に失敗した場合は、同じReleaseのupdate.batをもう一度実行して更新を再開します。
困ったとき
- モデルを読み込めない: ファイル形式と、SAMの種類・ファイルの組み合わせを確認してください。
- GPU、CUDA、DirectMLのエラー: ほかのGPUアプリを閉じる、別のGPUを選ぶ、またはCPUへ切り替えてください。
- 解決しない: エラー文を添えてIssuesへ報告してください。
テスト
依存関係を準備して、バックエンドとフロントエンドのテストを実行します。
py -3.12 -m venv .venv-test
& ".\.venv-test\Scripts\python.exe" -m pip install -r requirements-test.txt
npm ci
node scripts/test-quiet.cjs all
自動テストはHTTP、SQLite、実ファイル、ブラウザーUIの契約を確認します。frontendとallはcoverage完了後に、coverageを付けない20,000件カタログ性能試験も1回実行します。確認範囲と検証対象外の扱いは自動テストとの対応に記載しています。
ライセンス
MozarieはMIT Licenseで公開しています。第三者コンポーネントとモデルの情報はTHIRD_PARTY_NOTICES.mdを参照してください。
