Extensions/Kemmy Prompt Library

ComfyUI Extension

Kemmy Prompt Library

Thumbnail-backed reusable prompt library node for ComfyUI

By kemmy2302·Created 6 days ago·Updated a day ago· 3

kemmy2302/cn_01_kemmy_ComfyUI-Prompt-Library

Nodes—

On cloudLocal install

Stars3

Updateda day ago

Readme

cn_01_kemmy_ComfyUI-Prompt-Library

Save frequently used prompts as named presets, find them quickly, and combine multiple presets in a deliberate order inside ComfyUI.

This node is useful when you repeatedly reuse character descriptions, outfits, poses, items, styles, quality prompts, or other prompt fragments. Presets can include optional thumbnails and categories, so you do not have to keep copying text from external notes.

The node has no Python package dependencies.

What it does

Stores reusable prompt presets with a name, category, prompt text, and optional thumbnail.
Includes category tabs such as Character, Outfit, Pose, and Style by default.
Lets you create, rename, hide, and delete unused categories.
Searches preset names, categories, and prompt contents.
Filters the list to all, selected, or unselected presets.
Selects multiple presets and lets you control their output order.
Keeps multiple characters separate with Character 1, Character 2, and Shared assignments.
Assigns outfits, poses, items, and other presets to a specific character.
Combines the selected presets into one standard ComfyUI STRING output.
Keeps the selected area visible while the main library scrolls separately.
Saves a snapshot of selected prompt text in the workflow for portability.

Installation

Git

Open a terminal in ComfyUI/custom_nodes and run:

git clone https://github.com/kemmy2302/cn_01_kemmy_ComfyUI-Prompt-Library.git

Restart ComfyUI after cloning.

ZIP

Download this repository with Code > Download ZIP.
Extract it into ComfyUI/custom_nodes.

Make sure the final path is similar to:

ComfyUI/custom_nodes/cn_01_kemmy_ComfyUI-Prompt-Library/__init__.py

Restart ComfyUI.

Finding the node

In ComfyUI, add:

Ordered Prompt Tools
└── cn_01_kemmy_Prompt Library Selector

If the node does not appear, restart the ComfyUI backend, not only the browser page. After restarting, refresh the browser with Ctrl+F5.

Quick start

Add cn_01_kemmy_Prompt Library Selector to your workflow.
Click + Add preset.
Enter a preset name.
Choose a category.
Enter the reusable prompt text.
Optionally choose a PNG, JPG, JPEG, or WebP thumbnail.
Click Save preset.
Select one or more preset cards.
For multiple characters, assign each selected preset to Character 1, Character 2, or Shared.
Connect the prompt output to any node that accepts STRING.

Selecting and ordering prompts

Click a preset card or its checkbox to select it. Selected presets appear in Selected prompts (output order).

The order shown in this area is the exact order used in the combined output. Use the up and down buttons to change it. Use Remove to remove one selection or Clear all to clear the selection without deleting presets.

For example, selecting these presets:

1. Character - Alice
2. Outfit - School uniform
3. Style - Watercolor

can produce:

1girl, Alice, long blonde hair,
school uniform, pleated skirt,
watercolor painting, soft colors

The exact separator is controlled by the separator widget.

| Separator | Result between presets | |---|---| | comma + newline | comma followed by a line break | | newline | line break only | | comma | comma and space | | BREAK | BREAK on its own line |

Multiple characters and assignments

By default, character grouping is active. Leave simple_combine unchecked when a prompt contains more than one character.

Every selected preset has an assignment selector in Selected prompts (output order):

Character 1, Character 2, and so on place that preset inside a specific character block;
Shared places it under instructions that apply to the whole image.

Presets in the Character, Characters, キャラ, キャラクター, or 人物 categories are automatically assigned to separate character numbers when selected. You can also enable Treat as character while editing any preset. The assignment can always be changed manually afterward.

For example:

Alice character preset       -> Character 1
Red dress outfit             -> Character 1
Bob character preset         -> Character 2
School uniform outfit        -> Character 2
Standing side by side pose   -> Shared
Classroom background         -> Shared

produces:

Character 1:
Alice character description,
red dress

Character 2:
Bob character description,
school uniform

Shared instructions:
standing side by side,
classroom background

This structured text is particularly useful before an Ollama or other LLM node because the model can tell which appearance, outfit, item, or pose belongs to which person. It also gives Anima's text encoder clearer character boundaries than one undifferentiated tag list.

Check simple_combine when you want all selected prompts joined into one unlabelled string in selection order. While it is checked, the Character 1 / Character 2 / Shared assignment selectors are disabled because those assignments are not used.

Enable anima_character_clauses to generate Anima-oriented character clauses from the same assignments:

(chara1 is a girl, black hair, red eyes, black kimono.),
(chara2 is a boy, white hair, blue eyes, school uniform.),
classroom, standing side by side

Everything assigned to a character, including outfits, poses, and items, stays inside that character's parentheses. Shared background, composition, lighting, and style prompts remain outside the character clauses. The node adds the final period, closing parenthesis, and comma automatically; write a girl, a boy, or another identity phrase in the character preset itself.

anima_character_clauses takes priority if both flags are true. In the normal GUI, enabling either simple_combine or anima_character_clauses automatically disables the other flag.

For an Ollama workflow, pass these clauses through the LLM only when its system prompt explicitly instructs it to preserve every (charaN is ... .), block and keep character-specific traits inside the matching block.

Assignments and the Treat as character flag are stored in workflow snapshots. Older presets remain compatible; recognized character categories are detected automatically.

Screenshot placeholder: selected presets assigned to Character 1, Character 2, and Shared.

Categories and tabs

Click Categories to manage category names.

+ Add category registers a reusable category name.
The Tab checkbox controls whether that category is always shown as a tab.
Renaming a category also updates presets that use it.
A category currently used by a preset cannot be deleted.
Category tabs scroll horizontally when the node is narrow.

The default categories are:

Character
Outfit
Pose
Style

Categories are selected from a list when editing presets, which helps avoid spelling differences and duplicate category names.

Search and filters

The search box matches:

preset name;
category name;
prompt text.

The selection filter supports:

All presets;
Selected only;
Unselected only.

Selected cards are highlighted, and the selected count remains visible above the independently scrolling library.

Editing presets and thumbnails

Each preset provides:

Edit: change its name, category, prompt, or thumbnail;
Duplicate: copy the preset under a new ID;
Delete: permanently delete the preset after confirmation.

Supported thumbnail formats are PNG, JPG, JPEG, and WebP. The maximum upload size is 10 MB.

Connecting the output

The node outputs a normal ComfyUI STRING, so it is not limited to a specific workflow or model.

Common connections include:

Prompt Library -> CLIP Text Encode (text)
Prompt Library -> Sequential Prompt List (prefix_prompt or suffix_prompt)
Prompt Library -> Ollama / LLM prompt input
Prompt Library -> another text-combining node

It can be used for positive prompts, negative prompts, characters, styles, or any other text. The output name is intentionally the generic name prompt.

Workflow snapshots

The node stores a snapshot of the currently selected presets inside the ComfyUI workflow. This allows the selected prompt text to survive when a workflow is opened on another installation that does not yet have those presets in its local library.

The complete library and thumbnail collection are not embedded in every workflow. Back up the data directory below if you want to move the whole library to another computer.

Data storage and backup

Runtime data is stored outside the plugin directory:

ComfyUI/user/ordered_prompt_tools/
├── library.json
└── thumbnails/

This means updating or replacing the custom-node repository does not normally delete your presets.

To back up the library, copy both library.json and the thumbnails directory. The exact ComfyUI/user location can differ if ComfyUI was launched with a custom user directory.

Existing data created by the earlier combined Ordered Prompt Tools package remains compatible.

Updating

From the repository directory:

git pull

Restart ComfyUI and refresh the browser with Ctrl+F5 after updating frontend files.

Troubleshooting

The node is missing

Confirm the repository is directly inside ComfyUI/custom_nodes.
Confirm __init__.py is not nested inside an extra ZIP folder.
Restart the ComfyUI backend and check its startup log for import errors.

The editor does not update or looks incorrect

Refresh the browser with Ctrl+F5 to clear cached JavaScript.
Make sure only one copy of this custom node is installed.

A preset exists but is hard to find

Switch to the All tab.
Set the filter to All presets.
Clear the search field.
Click Reload library if the file was edited outside ComfyUI.

The workflow works but the thumbnail is missing on another computer

Prompt snapshots preserve selected text, but thumbnail files remain in the local data directory. Copy the thumbnails directory when moving the full library.

License

MIT