# Smart Word Filter — ComfyUI Prompt / Tag ToolkitA small ComfyUI extension for organizing, filtering, and swapping prompt tags using reusable profiles. It ships with folder-based built-in tag lists (characters, clothing, pose, background, lighting, etc.) and lets you build your own positive / negative profiles once and reuse them in any workflow.---## What's insideThe extension adds two nodes:| Node | Purpose || :--- | :--- || Smart Word Filter | The profile authoring hub. Create and save your own tag lists as reusable pos / neg profiles. || Profile Tools (Split / Replace by Profile) | Uses saved profiles to split a prompt into two groups, or replace some tags with others. Has a live, interactive preview. |---## Core concepts* Profiles: A profile is just a named list of tags. Profiles are grouped into two kinds: * <code>pos</code>: Profiles you intend to use with your positive prompt. * <code>neg</code>: Profiles you intend to use with your negative prompt. * <code>pos</code> / <code>neg</code> is only a label to help you organize; both kinds work exactly the same way.* Built-in (★) profiles: Profiles whose name starts with a star, such as <code>★ Face</code>, <code>★ Clothing</code>, <code>★ Pose</code>, are built automatically from text files on disk — they are not hard-coded. Because they are generic, they appear under both <code>pos</code> and <code>neg</code> (e.g. <code>pos | ★ Clothing</code> and <code>neg | ★ Clothing</code> are the same list).* Live update: Edit a tag file (or add a new one) and the profiles refresh automatically — no need to restart ComfyUI.---## Node 1 — Smart Word Filter (profile authoring)Use this node to turn any set of tags into a saved profile:1. Type or paste your tags.2. Mark the ones you want to keep (positive) and the ones you don't (negative).3. Save the result as a named profile under <code>pos</code> or <code>neg</code>.Saved profiles live on disk (independent of the workflow), so they are available in every workflow and survive restarts.---## Node 2 — Profile Tools (Split / Replace by Profile)One node with an operation switch:### operation = split* output 1 (kept): The input tags that are inside the selected profile(s).* output 2 (rest): Everything else.In the node, every tag chip has two buttons: <code>+</code> = *want (force-keep):** Push this tag into output 1 even if it isn't in the profile. <code>-</code> = *don't want (force-remove):** Push this tag into output 2 even if it is in the profile.* Click again to reset. "don't want" wins over "want".### operation = replaceRemoves the profile tags from the input and inserts your replacement tags in their place.* output 1 (result): The resulting prompt.* output 2 (removed_tags): The tags that were removed.* <code>insert_at</code>: Controls where the replacement goes (at the first match, at the start, or at the end).* <code>if_no_match</code>: Controls what to do when none of the profile tags were found (append / prepend / skip).### mode (both operations)* <code>any_profile</code>: A tag matches if it is in at least one selected profile (union).* <code>all_profiles</code>: A tag matches only if it is in every selected profile (intersection).* You can select up to 4 profiles at once <code>profile</code>, <code>profile_2</code>, <code>profile_3</code>, <code>profile_4</code>).Live preview: The node previews the result instantly as you change anything — you don't have to run the whole workflow. If the text comes from another node, run the workflow once so the node knows the latest text, then the preview stays live.---## How to add / edit tags### A) Add tags to a built-in (★) list1. Open the extension's <code>tag_lists/</code> sub-folder (it is created automatically after the first run).2. Open the file for that category, e.g. <code>clothing.txt</code>.3. Add your tag on a new line (one tag per line, or several separated by commas; lines starting with <code>#</code> are comments).4. Save. The change applies live.### B) Create a brand-new built-in categoryDrop a new file like <code>animals.txt</code> into <code>tag_lists/</code> (or <code>tag_lists_default/</code>). A new <code>★ Animals</code> profile appears automatically.### C) Create your own profileUse the Smart Word Filter node, build your list, and save it under <code>pos</code> or <code>neg</code>. It will show up in the Profile Tools dropdown.---## Installation1. Copy the <code>smart_word_filter</code> folder into <code>ComfyUI/custom_nodes/</code>.2. Restart ComfyUI.3. Hard-refresh the browser page <code>Ctrl + F5</code>).---## Tips* Tag matching ignores case and treats spaces / underscores the same <code>blue_shirt</code> = <code>blue shirt</code>).* Weights and brackets are handled, e.g. <code>(green:1.2)</code> is matched as <code>green</code>.* Duplicate tags are removed automatically.------&lt;div dir="rtl"&gt;&lt;/div&gt;&lt;img width="1048" height="610" alt="Screenshot (1996)" src="<a target="_blank" rel="ugc" href="https://github.com/user-attachments/assets/a3dc6f72-47cc-41e8-9fb3-4870b7ac3a57">https://github.com/user-attachments/assets/a3dc6f72-47cc-41e8-9fb3-4870b7ac3a57</a>" /&gt;&lt;img width="1053" height="571" alt="Screenshot (1997)" src="<a target="_blank" rel="ugc" href="https://github.com/user-attachments/assets/056bf4fd-645b-4266-a80d-ce164074885a">https://github.com/user-attachments/assets/056bf4fd-645b-4266-a80d-ce164074885a</a>" /&gt;

Files with SHA256: 5f6f3686cf86d04f4f0f601c019faa125b67074a4c3571620ceed693f8b2f6d6