Nodes/Shima/Shima Styler (Selector)
ComfyUI Node

Shima Styler (Selector)

The single style picker that's also the pack's simplest

By KDB-USJP·Created 6 months ago·Updated 6 months ago· 2
Shima Styler (Selector)
  • clip
  • conditioning_positive
  • conditioning_negative
  • positive
  • negative
  • style_name
  • positive_conditioning
  • negative_conditioning
activetrue
base_prompt
negative_prompt
modeSingle
connector,
style_strength1.00
selected_styles
base_string
negative_string

If you only want one style from the Shima library applied to one prompt, this is the node. StyleSelector is the plainest member of the Styler family - a list-based style browser with a base prompt, a negative prompt, and a strength slider. It's the Selector that the Gallery, Favorites, and Iterator variants all build on, and for the "every run, the same style, tuned" use case it's the one you reach for.

The style browser lives in the frontend: an HTML panel renders the library with search/filtering, you click a style, and your selection lands in a hidden selected_styles field. The backend resolves it, applies weighting, and returns both the final strings and the encoded conditioning.

The inputs

  • active - labeled "Active/Bypass" in the UI. Off, and the node passes your base prompt and any wired conditioning straight through with style_name = "None". This is the clean way to disable styling without rewiring.
  • base_prompt and negative_prompt - your prompt and its negative, styled versions of which come out the other end.
  • mode - Single or Stack; Stack lets you mix multiple styles from the browser, joined by the connector.
  • connector - ", " (default), " and ", " mixed with ", " + ".
  • style_strength - −10 to 10, default 1. Weights only the style tokens, leaving your base prompt untouched.
  • clip, conditioning_positive, conditioning_negative - optional; if clip is provided the node encodes the final strings into fresh conditioning, appended to any wired-in conditioning.
  • selected_styles - the hidden selection field driven by the browser.
  • base_string / negative_string - string overrides that outrank the widget prompts when connected.

Outputs: positive, negative (strings), style_name, positive_conditioning, negative_conditioning. Note the ordering difference from the rest of the family - this node puts strings first and conditioning last.

The one hard rule

The node raises a ValueError if it's active with no selection: "You must make at least one selection or turn off the styler." That's deliberate - it refuses to silently produce an unstyled prompt and pretend nothing happened. It's the clearest error message in the whole pack, and the fix is either pick a style or flip active off.

Installing it

Part of KDB-USJP/shima_wf:

cd ComfyUI/custom_nodes
git clone https://github.com/KDB-USJP/shima_wf

Restart ComfyUI. Style data ships with the repo (read from the bundled XLSX via auto-installed openpyxl); no downloads.

The honest advice

If you're not using the Shima style library at all, the community-standard alternative (Style Selector Plus-style text lists, or just hand-writing style tokens) may be all you need. Where this wins is integration: one node that browses the library, merges your prompt, weights the style, and emits conditioning - no CLIP-encode dance. The one thing that trips people is the hard error on empty selection, which usually means the browser's selection didn't sync (hard-refresh the page) or you genuinely never picked a style. Choose one, and it just works.

CategoryShima/Styler

Inputs (12)

NameTypeDefaultDescription
activeBOOLEANtrue
base_promptSTRING
negative_promptSTRING
modeCOMBOSingle2 options: Single, Stack
connectorCOMBO, 4 options: and , mixed with , + , ,
style_strengthFLOAT1.00-10–10
clipoptCLIP
conditioning_positiveoptCONDITIONING
conditioning_negativeoptCONDITIONING
selected_stylesoptSTRING
base_stringoptSTRING
negative_stringoptSTRING

Outputs (5)

NameTypeDescription
positiveSTRING
negativeSTRING
style_nameSTRING
positive_conditioningCONDITIONING
negative_conditioningCONDITIONING