Extensions/comfyui-prompt-library-nodes
ComfyUI Extension

comfyui-prompt-library-nodes

Structured prompt-library and LoRA workflow nodes for ComfyUI that keep reusable prompt material outside workflow graphs.

By 2223290690z-hue·Created 3 months ago·Updated 2 months ago· 1
2223290690z-hue/comfyui-prompt-library-nodes
Nodes—
On cloudLocal install
Stars1
Updated2 months ago
Readme

ComfyUI Prompt Library Nodes

Structured prompt-library and LoRA workflow nodes for ComfyUI.

This project helps ComfyUI users keep reusable prompt material outside a single workflow graph. It provides nodes for selecting roles, outfits, poses, scenes, camera directions, props, lighting notes, negative prompts, and LoRA metadata from a JSON prompt library.

Documentation

What It Solves

Large ComfyUI workflows often become hard to share because prompts, LoRA choices, local file paths, and private notes are mixed into the graph. These nodes move reusable prompt material into a portable JSON library so workflows can be cleaner, easier to remix, and easier to package.

Included Nodes

  • Unified T2I Prompt Source v2: builds a positive prompt from a structured library.
  • LoRA Switchboard: applies up to twelve LoRAs from one compact node and emits LoRA metadata tags.
  • Negative Prompt Source: emits reusable negative prompt presets.
  • Prompt Aspect Latent Router: reads aspect tags such as [portrait] or [landscape], creates a matching latent, and removes the aspect tag from the prompt.

Installation

Clone this repository into your ComfyUI custom nodes folder:

cd ComfyUI\custom_nodes
git clone https://github.com/2223290690z-hue/comfyui-prompt-library-nodes.git

Restart ComfyUI.

The bundled demo library is used by default:

examples/sample-library.json

To use your own library, put exported JSON files in:

exports/

Files named prompts-backup-*.json are picked up automatically, newest first.

For a full walkthrough, see docs/user-guide.md.

Library Format

The library is a JSON array. Each item can include:

  • id
  • title
  • content
  • folder
  • pinned
  • tags
  • outfits

See examples/sample-library.json and docs/library-schema.md.

Basic Workflow Shape

Unified T2I Prompt Source v2 -> CLIPTextEncode positive
Negative Prompt Source       -> CLIPTextEncode negative
CheckpointLoaderSimple       -> sampler model / CLIP / VAE
Prompt Aspect Latent Router  -> sampler latent_image
LoRA Switchboard             -> optional model and CLIP patching

See docs/example-workflow.md.

For documentation screenshots, import examples/workflows/beginner-screenshot-workflow.json. It is arranged as a teaching diagram, so it is better for screenshots and labels than for production rendering.

Privacy And Redistribution Notes

This repository intentionally does not include:

  • model files
  • LoRA files
  • Civitai caches or SQLite databases
  • private prompt libraries
  • generated outputs
  • copyrighted character packs or private reference material

Use the demo library as a safe template, then keep your personal production library private unless you have verified that every entry is suitable for public release.

Status

Early public extraction from a personal ComfyUI workflow. The current focus is making prompt libraries portable, documented, and easier to test across machines.

License

MIT