Have a ComfyUI workflow? Get a readable Workflow Doc in your browser.Make a workflow readable.Try it now ↗
ComfyUI custom node that includes ethnicity and hairstyle selectors with random capability
Package profile
README
This ComfyUI custom node enhances the standard CLIP text encoding functionality by integrating ethnicity, hairstyle, and expression selection into the positive prompt. Designed to work seamlessly with ComfyUI, this node allows you to influence the conditioning process by dynamically appending descriptive modifiers. Users can choose a specific ethnicity, hairstyle, or expression, or opt for a "random" selection that picks an option from a predefined CSV list.
Example Interface
Sources
3 sourcesVerified Sep 11
Source excerpts
1 excerptSource context: Repo ajbergh/comfyui-ethnicity_hairstyle_clip_encoder
Dynamic CSV Loading:
The node reads options from CSV files (ethnicity.csv, hairstyle.csv, and expression.csv).
Random Capability:
If the "random" option is selected, the node picks a random ethnicity, hairstyle, or expression (excluding duplicates in the CSV) at runtime, adding variety to the prompt.
Toggle Functionality:
Ethnicity, hairstyle, and expression modifications can be enabled or disabled independently using toggle inputs (ethnicity_toggle, hairstyle_toggle, and expression_toggle).
Customized Prompt Modification:
The node preprocesses the positive text prompt by prepending the chosen ethnicity (e.g., "Asian person,"), hairstyle (e.g., "curly hair,"), and expression (e.g., "happy,") descriptors before encoding. This modification directly influences the conditioning outputs generated by the CLIP model.
Backend Integration:
The node wraps CLIP's tokenize and encode methods:
Required Inputs:
text_positive: Primary prompt text (supports multiline input).text_negative: Negative prompt text (supports multiline input).clip: The CLIP model instance used for encoding.ethnicity_toggle: ("on" or "off") to enable ethnicity inclusion.hairstyle_toggle: ("on" or "off") to enable hairstyle inclusion.expression_toggle: ("on" or "off") to enable expression inclusion.Optional Inputs:
ethnicity: Dropdown selector populated with sorted ethnicity options; default is "random".hairstyle: Dropdown selector populated with sorted hairstyle options; default is "random".expression: Dropdown selector populated with sorted expression options; default is "random".CSV Reading Mechanism:
The node defines helper functions to read CSV files from its local directory and extracts options, ensuring that the "random" entry is only added once.
Prompt Modification:
When enabled, the node modifies the positive prompt by appending the selected ethnicity, hairstyle, and/or expression descriptors. For example, if toggled on and ethnicity is set to "random", a random ethnicity is chosen from the CSV (excluding "random") and prepended to the prompt.
Tokenization and Encoding:
The updated prompt is tokenized and encoded using the provided CLIP model, generating conditioning outputs used later in the UI pipeline.
A companion JavaScript extension modifies the UI behavior of this node in ComfyUI:
This comprehensive integration guarantees that prompt modifications are dynamically processed, providing an enhanced and flexible conditioning experience within the ComfyUI framework.
Example
Nodes in this pack
1 nodeVerified Aug 6
Verified Sep 11