forge-neo-region-detailer

Forge Neo Region Detailer / Forge Neo リージョン・ディテイラー

Forge Neo Region Detailer is an experimental region detection and sequential inpainting extension for Stable Diffusion WebUI Forge Neo. It is being developed toward an Impact Pack-style workflow adapted to Forge Neo's UI and processing system.

Forge Neo Region Detailerは、Stable Diffusion WebUI Forge Neo向けの、 領域検出と順次インペイントを行う実験的なExtensionです。ComfyUI Impact Packの ような領域処理を、Forge NeoのUIと処理方式に合わせて実現することを目指しています。

The primary target is anime and illustration generation with Anima, but the detector and inpainting pipeline may also work with other model families supported by Forge Neo.

主な対象はAnimaを使用したアニメ・イラスト生成ですが、Forge Neoが 対応するほかのモデルでも、検出およびインペイント処理を利用できる可能性があります。

Status / 状態: v0.1.0 Early Preview
This release passed unit and syntax tests, but still requires integration testing on real Forge Neo installations. Back up important settings and images before testing.
単体テストと構文テストには合格していますが、実際のForge Neo環境での 統合テストが必要です。テスト前に重要な設定と画像をバックアップしてください。

Download / ダウンロード

Download the current preview package below. 現在のプレビュー版は、以下からダウンロードできます。

Download / ダウンロード: forge-neo-region-detailer-v0.1.0.zip

No third-party detector weights are redistributed in this repository. このリポジトリでは、第三者が制作した検出モデルの重みを再配布していません。

Features in v0.1.0 / v0.1.0の機能

• Forge Neo-native inpainting / Forge Neoネイティブのインペイント
  Uses Forge Neo's post-generation img2img/inpaint pipeline.
  Forge Neoの生成後img2img／inpaint処理を使用します。

• YOLO and MediaPipe detectors / YOLO・MediaPipe検出
  Supports the detector system inherited from ADetailer Neo.
  ADetailer Neoから継承した検出システムに対応します。

• Face, hand and person regions / 顔・手・人物の領域
  Supports compatible face, hand and person detection or segmentation models.
  対応する顔・手・人物の検出・セグメンテーションモデルを使用できます。

• Detection filtering / 検出結果のフィルタリング
  Filter by confidence, area ratio, top-N area or top-N confidence.
  信頼度、面積比、面積上位N件、信頼度上位N件で絞り込めます。

• Region sorting / 領域の並べ替え
  Sort left-to-right, center-to-edge, or large-to-small.
  左から右、中央から外側、面積の大きい順に並べ替えられます。

• Explicit region selection / 領域番号の指定
  Select regions with one-based values such as 1,3-5.
  1,3-5のような1始まりの番号で処理対象を指定できます。

• Custom processing order / 処理順の指定
  Values such as 4-2 and 3,1 control the inpainting order.
  4-2や3,1のような指定で、インペイントの順番を変更できます。

• Per-region prompts / 領域別プロンプト
  Use [SEP] to assign different positive and negative prompts.
  [SEP]で領域ごとに異なるポジティブ・ネガティブプロンプトを指定できます。

• Separate generation settings / 個別の生成設定
  Optionally use separate sampler, scheduler, steps, CFG, checkpoint, VAE and inpaint resolution.
  必要に応じて、Sampler、Scheduler、Steps、CFG、Checkpoint、VAE、 インペイント解像度を個別に指定できます。

• Mask controls / マスク調整
  Configure padding, blur, dilation, erosion, offset and denoise strength.
  余白、ぼかし、膨張、収縮、位置補正、Denoise強度を調整できます。

Installation / インストール

Install from the ZIP / ZIPからインストール

1. Download forge-neo-region-detailer-v0.1.0.zip.
   forge-neo-region-detailer-v0.1.0.zipをダウンロードします。

2. Stop Forge Neo completely, including its terminal window.
   ターミナル画面を含め、Forge Neoを完全に終了します。

3. Open the Forge Neo installation folder and then its extensions folder.
   Forge Neoのインストールフォルダを開き、その中のextensions フォルダを開きます。

4. Extract the ZIP into extensions.
   ZIPをextensionsフォルダ内へ展開します。

5. Confirm the folder structure below.
   以下のフォルダ構成になっていることを確認します。

sd-webui-forge-neo/
└── extensions/
    └── forge-neo-region-detailer/
        ├── install.py
        ├── preload.py
        ├── lib_adetailer/
        └── scripts/

1. Start Forge Neo and expand Region Detailer under txt2img or img2img.
   Forge Neoを起動し、txt2imgまたはimg2imgにある Region Detailerを開きます。

The first launch may install Python dependencies and download supported detector files. Check the terminal for errors.

初回起動時にはPython依存パッケージや対応検出モデルがダウンロード される場合があります。エラーがないかターミナルを確認してください。

Important / 重要
Do not install ADetailer Neo and Region Detailer at the same time in v0.1.0. They share internal module names and may conflict.
v0.1.0では、ADetailer NeoとRegion Detailerを同時にインストール しないでください。内部モジュール名が共通しているため、競合する可能性があります。

Basic usage / 基本的な使い方

1. Configure normal image generation in Forge Neo.
   Forge Neoで通常の画像生成設定を行います。

2. Enable Region Detailer.
   Region Detailerを有効にします。

3. Select an anime-face, hand or person detector.
   アニメ顔、手、人物などのDetectorを選択します。

4. Enter a detail prompt, or leave it blank to reuse the main prompt.
   Detailer用プロンプトを入力します。空欄の場合は元のプロンプトを 使用します。

5. Adjust confidence, denoise strength, padding and mask blur.
   Confidence、Denoise強度、Padding、Mask Blurを調整します。

6. Leave Regions to process blank to process every detected region.
   すべての検出領域を処理する場合、Regions to processは空欄にします。

7. Generate the image.
   画像を生成します。

After the initial image is generated, the extension detects the regions and runs an inpainting pass for each selected region. 最初の画像生成後に領域を検出し、選択された各領域へ順番に インペイントを実行します。

Region selection / 領域選択

Selection is applied after detection, filtering and sorting. Region numbers start at 1. 領域指定は、検出・フィルタリング・並べ替えの後に適用されます。 領域番号は1から始まります。

Out-of-range numbers are ignored. Use the detection preview and sorting setting to identify the intended region order.

検出数を超える番号は無視されます。検出プレビューと並べ替え設定で、 意図した領域順になっているか確認してください。

Per-region prompts / 領域別プロンプト

Separate prompt entries with [SEP]. Entries follow the final processing order.

プロンプトを[SEP]で分割します。各プロンプトは最終的な処理順に 対応します。

detailed blue eyes, gentle smile
[SEP]
detailed green eyes, serious expression

[PROMPT], detailed face, blue eyes
[SEP]
[SKIP]
[SEP]
[PROMPT], detailed face, green eyes

Suggested starting values for Anima / Anima向け推奨初期値

These are starting points, not guaranteed settings for every image or Anima revision.

以下は調整の出発点です。 すべての画像やAnimaバージョンで結果を保証するものではありません。

Region Detailer reuses Forge Neo's img2img/inpaint path and the currently loaded Anima diffusion model, text encoder and VAE.

Region Detailerは、Forge Neoのimg2img／inpaint処理と、現在ロード されているAnimaのDiffusion Model、Text Encoder、VAEを再利用します。

Validation status / テスト状況

Completed / 実施済み

• Python syntax compilation / Python構文コンパイル
• Ten unit tests / 10件の単体テスト
• One-based selection / 1始まりの領域選択
• Normal and reverse ranges / 通常範囲と逆順範囲
• Duplicate removal with order preservation / 順序を保った重複除去
• Out-of-range handling / 範囲外番号の処理
• Invalid-selector rejection / 不正指定の拒否

10 passed

Not completed / 未実施

• Full startup test on the publisher's Forge Neo installation
  公開者のForge Neo環境での完全な起動テスト

• End-to-end Anima generation test
  Animaを使った画像生成のE2Eテスト

• Compatibility testing across Forge Neo and Python versions
  Forge NeoおよびPythonの各バージョンでの互換性テスト

• VRAM and performance benchmarks
  VRAM使用量および速度のベンチマーク

• API testing on a running Forge Neo server
  起動中のForge Neoサーバーを使ったAPIテスト

Please treat v0.1.0 as a community testing release. v0.1.0は、コミュニティによるテストを目的としたリリースとしてご利用ください。

Known limitations / 既知の制限

• This is not a direct port of ComfyUI Impact Pack.
  ComfyUI Impact Packの直接移植ではありません。

• ComfyUI's SEGS runtime and node graph are not included.
  ComfyUIのSEGSランタイムとノードグラフは含まれません。

• Region selection is text-based in v0.1.0.
  v0.1.0の領域選択はテキスト入力方式です。

• SAM/SAM2 mask refinement is not included yet.
  SAM／SAM2によるマスク精密化は未実装です。

• ADetailer Neo may conflict if installed at the same time.
  ADetailer Neoとの同時インストールは競合する可能性があります。

• Accuracy depends on the detector and illustration style.
  検出精度はDetectorとイラストのスタイルに依存します。

Troubleshooting and feedback / 不具合報告・フィードバック

Include the following information in a Community post. Communityへ投稿する際は、以下の情報を記載してください。

• Forge Neo version or commit / Forge Neoのバージョンまたはコミット
• Region Detailer version / Region Detailerのバージョン
• Operating system / OS
• Python and PyTorch versions / Python・PyTorchバージョン
• GPU and VRAM / GPU・VRAM容量
• Detector filename / Detectorのファイル名
• Generation model and exact Anima revision / 生成モデル・Animaの正確な版
• Reproducible settings / 再現可能な設定
• Full console traceback / コンソールの完全なエラー表示
• Safe example image, if applicable / 必要に応じて安全な作例画像

Privacy / プライバシー
Remove tokens, private prompts, personal paths and identifying metadata before posting.
投稿前に、Token、非公開プロンプト、個人名を含むパス、個人を特定 できるメタデータを削除してください。

Roadmap / ロードマップ

v0.2 — Interactive regions / 対話型の領域選択

• Numbered region preview gallery / 番号付き領域プレビュー
• Interactive enable/disable selection / 領域の有効・無効切り替え
• JSON region manifest / JSON形式の領域情報
• Stable region IDs and labels / 安定した領域IDとラベル

v0.3 — SAM2 refinement / SAM2による精密化

• SAM2 contour masks / SAM2による輪郭マスク
• CPU offload and VRAM cleanup / CPUオフロードとVRAM解放
• Mask union, intersection, dilation and feathering
  マスクの結合、交差、膨張、境界ぼかし

v0.4 — Advanced pipelines / 高度な処理

• Per-region presets / 領域別プリセット
• Per-region denoise, seed and checkpoint / 領域別Denoise・Seed・Checkpoint
• Multiple-detector rules / 複数Detectorのルール
• Repeatable batch API / 再現可能なバッチAPI

v1.0 — Stable release / 安定版

• Saved-setting compatibility / 保存設定の互換性
• Forge Neo compatibility matrix / Forge Neo互換性一覧
• Third-party detector adapter API / 外部Detector用アダプターAPI

Source availability / ソースコードの公開

The canonical source code and issue tracker are planned for GitHub. This Hugging Face repository currently provides the v0.1.0 Early Preview package. Source will remain available under AGPL-3.0.

正式なソースコードとIssue管理はGitHubで公開予定です。 現在、このHugging Faceリポジトリではv0.1.0 Early Previewを配布しています。 ソースコードはAGPL-3.0の条件で公開を継続します。

License and attribution / ライセンスとクレジット

Region Detailer is licensed under the GNU Affero General Public License v3.0.

Region DetailerはGNU Affero General Public License v3.0でライセンスされています。

Derived from / 派生元:

• Bing-su/adetailer
• Haoming02/ADetailer-Neo

ComfyUI Impact Pack is a design inspiration. Its node runtime is not bundled or represented as part of this extension.

ComfyUI Impact Pack は設計上の参考です。そのノードランタイムは本Extensionに同梱されておらず、 本Extensionの一部として扱っていません。

Disclaimer / 免責事項

This is an independent community extension and is not an official Forge Neo, Anima, ADetailer or ComfyUI Impact Pack release. Use it at your own risk and keep backups while testing early versions.

本Extensionは独立したコミュニティ開発物であり、Forge Neo、Anima、 ADetailer、ComfyUI Impact Packの公式リリースではありません。 初期バージョンのテスト中はバックアップを取り、自己責任でご利用ください。