ComfyUI のテキスト入力欄で、タグ補完を行う拡張機能です。
タグ CSV に加えて、翻訳ファイル、Embedding、LoRA、Wildcard も候補に含められます。
この拡張機能は ComfyUI-Custom-Scripts を参考にしています。
- タグ CSV を使った補完
- 翻訳ファイルを使った検索補助と翻訳表示
- Embedding / LoRA / Wildcard の候補表示
- カテゴリ指定検索
- プレフィックス付き挿入
- Wiki リンクボタン表示
cd ComfyUI/custom_nodes
git clone https://github.com/jupo-ai/comfy-ex-tagcomplete.git追加の pip 依存関係はありません。
インストール後に ComfyUI を起動すると、対応した複数行テキスト入力でタグ補完が使えるようになります。
設定は ComfyUI の設定画面から変更できます。
| 項目 | 説明 |
|---|---|
Enable |
機能全体の ON / OFF を切り替えます。 |
Choose Main File |
メインで使うタグ CSV を選びます。tags フォルダ内の extra で始まらない CSV が対象です。 |
Choose Extra File |
追加タグ CSV を選びます。tags フォルダ内の extra で始まる CSV が対象です。 |
Choose Translate File |
翻訳 CSV を選びます。translate フォルダ内の CSV が対象です。None を選ぶと無効化されます。 |
Delimiter |
タグ挿入時の区切り文字を指定します。, . None から選べます。 |
Add 'Space' after delimiter |
区切り文字の後ろに半角スペースを自動で入れます。 |
Max Suggestions to Display |
候補の最大表示数です。0 にすると全件表示しますが、件数によっては重くなります。 |
Minimum Characters to Search |
検索を開始する最小文字数です。0 にすると --artist のようなカテゴリ指定だけでも候補を表示できます。 |
Add 🔍 Link button |
候補の左に Wiki / タグページを開くボタンを表示します。 |
Wiki Link Site |
🔍 ボタンで開くサイトを選びます。Auto はタグ元のサイトを優先します。 |
Replace '_' with 'Space' |
挿入時に _ をスペースへ置き換えます。 |
Escape Parentheses |
挿入時にタグ内の括弧を \( \) にエスケープします。 |
Artist Tag Prefix |
artist 系タグの前に付ける文字列です。例: @ |
Completion Delay (ms) |
入力後、候補を表示するまでの待ち時間です。 |
Enable Embeddings |
Embedding を候補に含めます。embedding:name 形式で表示されます。 |
Enable LoRAs |
LoRA を候補に含めます。挿入時は <lora:name:1> 形式になります。 |
Enable Wildcards |
Wildcard を候補に含めます。__name__ 形式で表示されます。 |
Restrict Alias |
Alias 候補を完全一致時のみ表示します。たとえば 1girls -> 1girl は 1girls まで入力したときだけ表示されます。 |
Search Method |
検索方法を切り替えます。smart は入力文字列を空白や _ で分割し、各語をすべて含むタグを検索します。legacy は入力文字列全体を 1 つのパターンとして扱い、%term% 形式の部分一致で検索します。 |
Sort Method |
候補の並び順を切り替えます。relevance は完全一致 → 前方一致 → 部分一致の順で優先し、その後に postCount とタグ長を見ます。legacy は一致位置や一致度を考慮せず、主に postCount の高い順で並べます。 |
--カテゴリ名 を入力すると、カテゴリを絞って検索できます。
利用可能なカテゴリは category_map.csv を参照してください。
例:
--character fate
fate の検索結果から、character カテゴリのものだけを表示します。
Minimum Characters to Search を 0 にすると、--artist のようにカテゴリ指定だけで候補を表示できます。
++文字列 を付けると、選択したタグの前にその文字列を付けて挿入できます。
プレフィックスは複数指定できます。
例:
++pink skirt
skirt を検索して pleated skirt を選ぶと、pink pleated skirt が挿入されます。
tags フォルダ内の以下の 3 ファイルは、a1111-sd-webui-tagcomplete からお借りしています。
danbooru.csvdanbooru_e621_merged.csvextra-quality-tags.csv
- 翻訳 CSV は
1列目: タグ名、最後の列: 翻訳文字列として読み込まれます。 - Wildcard 候補は ComfyUI 側で利用可能な Wildcard 定義を読み込みます。
- 一部の複数行入力欄では、互換性のため補完を無効化しています。