ComfyUI Auto Tagger is a plugin for Eagle that automatically extracts metadata (Workflow/Prompt JSON) from AI-generated images and saves them as Eagle Tags and Notes.
It supports ComfyUI, Stable Diffusion WebUI (including Automatic1111, Forge, and other variants; referred to as "A1111" below), and Civitai generated images in both PNG and WebP formats, and allows you to filter which information to import.
- Multi-Format Support: Supports ComfyUI workflows (including complex multi-sampler), A1111 (Stable Diffusion WebUI) parameters, and Civitai generation metadata.
- Metadata Extraction: Automatically detects Checkpoint, LoRA, Prompts (Positive/Negative), and Generation Parameters (Seed, Steps, CFG, Sampler).
- Flexible Output:
- Tags: Adds extracted info to Eagle tags (e.g.,
#checkpoint_name,#lora_name,seed:12345). - Notes (Annotation): Saves full prompts and parameters in the Note section for easy reference.
- Tags: Adds extracted info to Eagle tags (e.g.,
- Selective Import: Allows toggling specific items (e.g., "Import Checkpoint but ignore Seed") via checkboxes.
- Batch Processing: Efficiently processes multiple images with a progress bar.
- Advanced Workflow Analysis: Dynamically analyzes ComfyUI node graphs to trace the actual execution path, accurately extracting parameters even from complex multi-stage workflows (HiresFix, FaceDetailer, etc.).
- Suspicious Node Detection: Detects nodes with missing required inputs in ComfyUI workflows and allows users to decide whether to include or exclude them from metadata extraction.
- Force Delete Mode: Removes all tags and notes from selected items without analysis (Shift + Click on "Delete Info").
- Debug Mode: Detailed logs for troubleshooting (toggle via checkbox).
- No External Dependencies: Parses PNG/WebP chunks directly (tEXt, comf, Exif) without relying on heavy external libraries.
- Utility: Provides a dedicated button to safely remove only the tags/notes added by this plugin.
| Output Result | Main UI |
|---|---|
 |
 |
The plugin traces complex ComfyUI workflows to identify the actual generation pipeline:
- Traces through complex node connections to identify the actual generation pipeline
- Handles multi-stage workflows with multiple samplers and refinement stages
- Dynamically analyzes node graphs to extract parameters even from complex workflows (HiresFix, FaceDetailer, etc.)
ComfyUI metadata doesn't record the actual execution path. The plugin traces back from the final image save node to extract prompts and parameters. When workflows contain both txt2img and img2img paths, some nodes may not have been executed. To eliminate this noise, the plugin detects nodes with missing required inputs (e.g., latent) as "suspicious nodes (likely not executed)".
However, ComfyUI has many custom nodes, and some may work correctly even with seemingly missing inputs. To prevent automatic exclusion from causing information loss, the plugin displays a dialog when suspicious nodes are detected, allowing users to decide whether to include or exclude them from metadata extraction.
You can configure how to handle suspicious nodes in the settings (see Configuration section below).
The plugin provides several configuration options accessible via the settings dialog (gear icon):
- Process Items per Batch: Set the number of images to process at once (default: 5). Processing too many images simultaneously may consume excessive memory.
- Suspicious Node Handling: Configure how to handle suspicious nodes (nodes with missing required inputs):
- Exclude: Automatically exclude suspicious nodes from metadata extraction
- Ask: Show a dialog for each suspicious node (recommended)
- Include: Include all nodes regardless of missing inputs
- Fetch dictionary from online (Recommended): Fetches the latest custom node definitions from GitHub. If disabled, the bundled dictionary will be used. Changes take effect on next startup. The plugin uses a node definition dictionary to understand custom nodes' input/output requirements. The online dictionary is regularly updated with new custom nodes, ensuring better compatibility.
- Include parameters from all samplers in tags: When enabled, parameters from all samplers in the workflow are added to tags. When disabled (default), only parameters from the first executed sampler are added. Enable this if you want to record all parameters from complex workflows with multiple refinement stages (HiresFix, upscale, etc.).
- Enable debug mode: Outputs detailed debug logs to console. Useful for diagnosing issues or reporting bugs.
- Select one or more AI-generated images (ComfyUI/A1111/Civitai) in Eagle
- Right-click and select "Plugins" > "ComfyUI Auto Tagger"
- In the popup window:
- Output Settings: Choose to add to "Tags", "Notes", or both
- Target: Check the metadata items you want to extract (Checkpoint, LoRA, Prompts, etc.)
- Download the latest
.eaglepluginfile from Releases - Launch Eagle
- Drag and drop the
.eaglepluginfile into the Eagle window - Restart Eagle if necessary
- Disclaimer: ComfyUI workflows can be extremely complex. 100% compatibility is not guaranteed. This plugin operates on advanced trace logic to identify the most relevant generation parameters.
- Bug Reports: When reporting issues on GitHub, please always attach:
- Information about your generation environment (ComfyUI/A1111 version, custom nodes used, etc.).
- The original image (PNG/WebP) that retains its metadata.
This project is licensed under the MIT License.
ComfyUI Auto Tagger は、画像収集管理ソフト Eagle 用のプラグインです。 AI画像生成ツールで生成された画像に含まれるメタデータ（Workflow/Prompt）を解析し、モデル名やプロンプトなどを自動でEagleの「タグ」や「メモ」に追加します。
ComfyUI、Stable Diffusion WebUI（Automatic1111、Forge等の派生版を含む。以下「A1111」と表記）、Civitai で生成された PNG および WebP 形式の画像に対応しており、取り込む情報を選択できます。
- 複数フォーマット対応: ComfyUIワークフロー（複雑なマルチサンプラー対応）、A1111（Stable Diffusion WebUI）、Civitai生成画像に対応。
- メタデータ抽出: チェックポイント、LoRA、プロンプト（Positive/Negative）、生成パラメータ（Seed, Steps, CFG, Sampler）を自動検出。
- 柔軟な出力先:
- タグ: 抽出した情報をEagleのタグとして追加（例:
#checkpoint_name,seed:12345）。 - メモ（アノテーション）: プロンプトやパラメータの詳細をメモ欄に保存し、参照・コピーを容易に。
- タグ: 抽出した情報をEagleのタグとして追加（例:
- 選択的取り込み: チェックボックスで必要な情報のみ（例: チェックポイントのみ）を選択して取り込み可能。
- バッチ処理: 複数画像をまとめて効率的に処理し、進捗状況を表示。
- 高度なワークフロー解析: ComfyUIのノードグラフを動的に解析し、実際の実行ルートを特定。複雑なマルチステージワークフロー（HiresFix、FaceDetailer等）からも正確にパラメータを抽出。
- 複雑なノード接続を追跡して実際の生成パイプラインを特定
- 複数のサンプラーと改善ステージを持つマルチステージワークフローに対応
- 疑わしいノード検出: ComfyUIのメタデータには実際の実行経路が記録されないため、プラグインは入力の欠落などから「実行されなかった未使用ノード（ノイズ）」を推測します。しかし、未知のカスタムノードを誤って除外しないよう、検知時はダイアログを表示し、抽出情報に含めるか除外するかの判断をユーザーに委ねます。
- 強制削除モード: Shiftキーを押しながら削除ボタンをクリックすることで、解析を行わずにタグ・メモを一括削除。
- デバッグモード: 詳細なログを表示してトラブルシューティングを支援（チェックボックスで切替）。
- 外部依存なし: PNG/WebPの内部データ（tEXt, comf, Exif）を直接解析するため、重い外部ライブラリに依存せず動作。
- ユーティリティ: このプラグインが生成したタグやメモのみを安全に削除する機能を提供。
| 出力結果 | メイン画面 |
|---|---|
|
|
複雑なComfyUIワークフローを追跡して、実際の生成パイプラインを特定します：
- 複雑なノード接続を追跡して実際の生成パイプラインを特定
- 複数のサンプラーと改善ステージを持つマルチステージワークフローに対応
- ノードグラフを動的に解析し、複雑なワークフロー（HiresFix、FaceDetailer等）からもパラメータを正確に抽出
ComfyUIの画像に埋め込まれるメタデータには、「実際にどのノードを通って生成されたか」という実行経路の記録が存在しません。そのため、本プラグインは最終的な画像保存ノードから呼び出し元を逆算してプロンプトやパラメータを抽出します。
1つのワークフロー内にt2iとi2iが混在している場合など、実際には実行されていないノードが存在することがあります。これらの不要なノイズを排除するため、プラグインは必須入力（Latentなど）が欠落しているノードを「疑わしいノード（実行されていない可能性が高いノード）」として推測し、検出します。
ただし、ComfyUIには独自のカスタムノードが多数存在し、一見入力が不足していても正常に動作する場合があります。プラグインによる機械的な自動除外による情報の欠落を防ぐため、疑わしいノードを検出した際はダイアログを表示し、メタデータ抽出の対象に「含める」か「除外する」かの選択をユーザーに委ねる設計となっています。
プラグインは設定ダイアログ（歯車アイコン）からアクセスできる複数の設定オプションを提供します：
- 一度に処理する数: 一度に処理する画像の数を設定します（デフォルト: 5）。多すぎるとメモリを消費します。
- 疑わしいノードの扱い: 疑わしいノード（必須入力が欠落しているノード）の扱いを設定します：
- 除外する: 疑わしいノードを自動的にメタデータ抽出から除外
- 確認する: 各疑わしいノードについてダイアログを表示（推奨）
- 含める: 入力の欠落に関わらず全てのノードを含める
- オンラインから辞書を取得する（推奨）: GitHubから最新のカスタムノード定義を取得します。無効にするとバンドルされた辞書を使用します。変更は次回起動時に反映されます。プラグインはノード定義辞書を使用して、カスタムノードの入出力要件を理解します。オンライン辞書は新しいカスタムノードで定期的に更新されており、より良い互換性を保証します。
- 全てのサンプラーのパラメータをタグに含める: 有効にすると、ワークフロー内の全てのサンプラーのパラメータがタグに追加されます。無効（デフォルト）の場合、最初に実行されたサンプラーのパラメータのみが追加されます。複数の改善ステージ（HiresFix、アップスケールなど）を持つ複雑なワークフローの全てのパラメータを記録したい場合は有効にしてください。
- デバッグモードを有効にする: 詳細なデバッグログをコンソールに出力します。問題の診断やバグ報告に役立ちます。
- EagleでAI生成画像（ComfyUI/A1111/Civitai）を1つ以上選択
- 右クリックして 「プラグイン」 > 「ComfyUI Auto Tagger」 を選択
- ポップアップウィンドウで:
- 出力設定: 「タグ」、「メモ」、または両方への追加を選択
- 対象: 抽出したいメタデータ項目をチェック（チェックポイント、LoRA、プロンプトなど）
- Releasesページから最新の
.eaglepluginファイルをダウンロード - Eagleを起動
.eaglepluginファイルをEagleウィンドウにドラッグ&ドロップ- 必要に応じてEagleを再起動
- 免責事項: ComfyUIのWorkflowは非常に複雑なため、100%の動作は保証できません。本プラグインは、高度な解析ロジックに基づいて最も関連性の高い生成パラメータを特定します。
- 不具合報告: GitHubのIssueで報告する際は、以下の2点を必ず添付してください。
- 生成環境の情報（ComfyUI/A1111のバージョン、使用しているカスタムノード等）
- メタデータが保持された画像の実ファイル（PNG/WebP）
本プラグインは MIT License のもとで公開されています。商用・非商用を問わず、自由にご利用・改変いただけます。
