Danbooru Tag JP Assist

Danbooru Tag JP Assist

Danbooru Tag JP Assist は、ComfyUI ノードの複数行テキスト入力欄でタグ候補を表示する補完ノードです。

日本語で検索しながら、英語タグや英語の自然言語ワードをプロンプトへ入力できます。

English README

インストール

ComfyUI を停止してから、custom_nodes に clone します。

cd D:\Codex\ComfyUI\custom_nodes
git clone https://github.com/ukr8b3g-cmyk/Danbooru-Tag-JP-Assist.git Danbooru-Tag-JP-Assist

すでにフォルダーがある場合は更新します。

cd D:\Codex\ComfyUI\custom_nodes\Danbooru-Tag-JP-Assist
git pull

その後、ComfyUI を再起動し、古いUIが残る場合はブラウザを Ctrl + F5 でハード更新してください。

できること

• ComfyUI ノードの複数行テキスト欄でタグ候補を表示します。
• 日本語の別名や翻訳から英語タグを検索できます。
• 英語タグをプロンプトへ挿入します。
• _ を空白に置き換えて、Krea系の自然言語プロンプト風に入力できます。
• カンマを自動で追加できます。
• 一致順、優先度/count順、A-Z順で並び替えできます。
• Danbooruタグ、自然言語辞書、自分のCSVを併用できます。
• Hugging Face の Danbooru CSV を起動時に確認し、更新があればローカルの danbooru_tags.csv を更新できます。
• 検索はサーバー側で行い、必要な候補だけをブラウザへ返します。

最大の特徴は All モードです。複数のタグファイルや翻訳ファイルを、基本的に重複を抑えながらまとめて読み込み、ひとつの候補リストとして使えます。現在はベータ機能として扱ってください。

Hugging Face がオフライン、または元ファイルが消えている場合は、既存のローカルCSVをそのまま使います。

基本的な使い方

1. ComfyUI の Settings を開きます。
2. Danbooru Tag JP Assist を有効にします。
3. まずは Tag file: All、Translation file: All のまま使います。
4. ノードの複数行プロンプト欄に英語または日本語を入力します。
5. 候補をキーボードまたはマウスで選択します。

初期設定では以下の動作になります。

• Tag file: All は tags/tag_files/ 内の同梱CSVと、ローカルにある Danbooru CSV を読みます。
• Translation file: All は同梱の翻訳CSVをまとめて読みます。
• Tag source: Both はローカルファイルと Hugging Face 由来の Danbooru CSV を併用します。
• 同じタグが複数ファイルにある場合は、Danbooru CSV 側を優先します。
• natural_language_tags.csv は軽量な英語辞書・プロンプト語彙です。Danbooruタグの代替ではありません。
• merged_translations_dedup.csv は Danbooru タグ用の日本語別名です。
• natural_language_ja.csv は自然言語辞書用の日本語別名です。
• CSVはサーバー側でキャッシュされます。大きな All 構成では最初の検索だけ読み込みに時間がかかる場合があります。

ファイル構成

タグファイルと翻訳ファイルは別フォルダーに置きます。

• tags/tag_files/: 英語タグ・英語辞書CSVを置くフォルダー
• tags/translation_files/: 日本語翻訳・別名CSVを置くフォルダー

現在の同梱タグファイル:

• tags/tag_files/anima_artists.csv
• tags/tag_files/anima_characters.csv
• tags/tag_files/danbooru_2025.csv
• tags/tag_files/e621.csv
• tags/tag_files/natural_language_tags.csv: 軽量な英語辞書・プロンプト語彙

同梱翻訳ファイル:

• tags/translation_files/natural_language_ja.csv: 自然言語辞書の一部に対応した日本語別名
• tags/translation_files/merged_translations_dedup.csv: Danbooruタグ用の日本語別名

同梱しないファイル:

• tags/tag_files/danbooru_tags.csv: Hugging Face から実行時に取得します。Gitには含めません。

CSV形式

タグファイル:

tag,category,count
1girl,0,4974288
long_hair,0,3608339

• tag: プロンプトへ挿入される英語タグ
• category: Danbooru互換のカテゴリ番号
• count: 優先度や人気順ソートに使う数値

翻訳ファイル:

tag,ja,aliases
1girl,"少女,女の子,おんなのこ","少女,女の子,若い女性,girl"
long_hair,"長髪,ロングヘア","長髪,ロングヘア,髪が長い"

• tag: 対応する英語タグ
• ja: 日本語表示用テキスト
• aliases: 検索用の日本語別名。複数ある場合はカンマ区切り

主な設定

• Tag file: tags/tag_files/ 内の1ファイル、または All。初期値は All です。
• Translation file: tags/translation_files/ 内の1ファイル、または All。
• Update Danbooru CSV from Hugging Face: Hugging Face 側を確認し、変更があれば danbooru_tags.csv を更新します。
• List every match: 候補を多めに表示します。上限は500件です。
• Suggestion count: List every match がOFFの時の表示数です。
• Sort mode: Match first、Priority / count、Tag A-Z。
• Popup color: 候補ポップアップの色です。
• Use spaces for underscores: long_hair を long hair として挿入します。
• Append comma: 候補挿入後にカンマを追加します。

CSVを追加・削除したあと、Settings のリストが更新されない場合は ComfyUI を再起動してください。

注意

• 補完対象は ComfyUI ノードに属する複数行テキスト欄です。Settings や一般的なモーダル内の textarea には取り付けません。
• GitHubリポジトリには danbooru_tags.csv を含めません。
• ダウンロード済みの danbooru_tags.csv は、元のファイル名と内容を維持します。
• Hugging Face からの更新は一時ファイルへストリーミング保存し、CSVヘッダーを確認してから置き換えます。
• Hugging Face から自動取得するCSVには128 MiBの上限を設けています。
• 自分のタグファイルは tags/tag_files/ に置いてください。
• 自分の翻訳・別名ファイルは tags/translation_files/ に置いてください。
• All で大きなCSVを複数読む場合、初回検索時は単一CSVより読み込みに時間がかかる場合があります。
• タグファイルがない場合、候補ポップアップは表示されません。

ライセンス

ソースコードは MIT License で公開しています。

同梱するタグ・翻訳データには、改変した第三者データが含まれる場合があります。出典と利用条件は THIRD_PARTY_NOTICES.md を参照してください。

---

English README

Danbooru Tag JP Assist adds tag suggestions to multiline text areas that belong to ComfyUI nodes.

It is intended for users who want to search English Danbooru tags and English prompt vocabulary with optional Japanese aliases.

Installation

Stop ComfyUI, then install into custom_nodes:

cd D:\Codex\ComfyUI\custom_nodes
git clone https://github.com/ukr8b3g-cmyk/Danbooru-Tag-JP-Assist.git Danbooru-Tag-JP-Assist

If the folder already exists:

cd D:\Codex\ComfyUI\custom_nodes\Danbooru-Tag-JP-Assist
git pull

Restart ComfyUI and hard refresh the browser with Ctrl + F5.

What It Does

• Shows suggestions while typing in multiline text boxes that belong to ComfyUI nodes.
• Inserts English tags into the prompt.
• Can display Japanese aliases next to suggestions.
• Can insert spaces instead of underscores for Krea-style natural prompts.
• Supports sorting by match, priority/count, or tag name.
• Supports local tag files, Hugging Face tag files, or both.
• Can check the Hugging Face source at startup and download/update the local danbooru_tags.csv when the remote file changes.
• Performs matching on the server and sends only the requested suggestions to the browser.

The main feature is All mode. It can load multiple tag files and translation files together, generally suppress duplicate entries, and use them as one combined suggestion list. Treat this as a beta feature for now.

If Hugging Face is offline or the source file disappears, the node keeps using the local saved CSV.

Basic Use

1. Open ComfyUI Settings.
2. Enable Danbooru Tag JP Assist.
3. Use the default Tag file: All and Translation file: All first.
4. Type English or Japanese text in a multiline prompt box on a node.
5. Select a suggestion with the keyboard or mouse.

Default behavior:

• Tag file: All loads bundled CSV files under tags/tag_files/ plus the local Danbooru CSV when available.
• Translation file: All loads the bundled translation CSV files together.
• Tag source: Both uses local files and the Hugging Face Danbooru CSV together.
• If the same tag exists in multiple files, the Danbooru CSV wins.
• natural_language_tags.csv is a lightweight English dictionary and prompt vocabulary, not a Danbooru tag replacement.
• merged_translations_dedup.csv is for Danbooru tag Japanese aliases.
• natural_language_ja.csv is only for the natural language dictionary.
• CSV data is cached on the server. A large All configuration may take longer on the first search while the cache is built.

Tag Files

Use two separate folders:

• tags/tag_files/: English tag files.
• tags/translation_files/: Japanese translation or alias files.

Currently bundled tag files:

• tags/tag_files/anima_artists.csv
• tags/tag_files/anima_characters.csv
• tags/tag_files/danbooru_2025.csv
• tags/tag_files/e621.csv
• tags/tag_files/natural_language_tags.csv: lightweight English dictionary and prompt vocabulary

Bundled translation files:

• tags/translation_files/natural_language_ja.csv: Japanese aliases for part of the natural language dictionary.
• tags/translation_files/merged_translations_dedup.csv: Japanese aliases for Danbooru tags.

Not bundled:

• tags/tag_files/danbooru_tags.csv: downloaded from Hugging Face at runtime.

CSV Format

Tag file:

tag,category,count
1girl,0,4974288
long_hair,0,3608339

Translation file:

tag,ja,aliases
1girl,"少女,女の子,おんなのこ","少女,女の子,若い女性,girl"
long_hair,"長髪,ロングヘア","長髪,ロングヘア,髪が長い"

Settings

• Tag file: one file in tags/tag_files/ or All. The default is All.
• Translation file: one file in tags/translation_files/ or All.
• Update Danbooru CSV from Hugging Face: checks and updates danbooru_tags.csv.
• List every match: shows a larger result list, capped at 500 suggestions.
• Suggestion count: limits displayed suggestions when List every match is off.
• Sort mode: Match first, Priority / count, or Tag A-Z.
• Popup color: changes the suggestion popup color.
• Use spaces for underscores: inserts long hair instead of long_hair.
• Append comma: adds a comma after inserted suggestions.

Notes

• Autocomplete is attached to multiline text areas owned by ComfyUI nodes, not general Settings or modal text areas.
• The GitHub repository does not include danbooru_tags.csv.
• The downloaded danbooru_tags.csv keeps the original filename and original content.
• Hugging Face updates are streamed into a temporary file and the CSV header is validated before replacement.
• Automatically downloaded CSV files are limited to 128 MiB.
• User tag files should be placed under tags/tag_files/.
• Japanese translation or alias files should be placed under tags/translation_files/.
• Large All combinations may take longer on the first search than choosing a single CSV.
• If no tag file is available, no suggestion popup is shown.

License

The source code is released under the MIT License.

Bundled tag and translation data may include modified third-party data. See THIRD_PARTY_NOTICES.md for source attribution and usage terms.