ComfyUI Text Processor

An advanced automation toolkit for ComfyUI, bridging the gap between raw data and generative AI. Features Batch Text Cleaning (for Img2Text), LLM Output Parsing, Dynamic Wildcards, and Logic Evaluation to streamline complex prompt engineering workflows.

---

01/2026 update: Add Text to Image node now supports intelligent text adaptation with auto_adapt toggle - automatically wraps long text and adjusts font size to fit image dimensions, plus truncation mode with ellipsis for fixed-size rendering. Height constraints are now enforced alongside width checks.

06/2026 compatibility update: Host-facing node metadata has been added for current ComfyUI search/help surfaces. Advanced Image Saver now omits previews for explicitly allowed absolute output paths outside ComfyUI output while still returning saved paths in files. Load Image Batch and Load Mask expose validation hooks where ComfyUI supports them, and Text Storage prefers the ComfyUI user directory while keeping legacy plugin-local entries readable.

---

1. Advanced Text Filter Node (Core)

This is a powerful and flexible text processing node for ComfyUI, designed to automate and simplify your dynamic prompt workflows.

Whether you need to precisely extract sections from a large text block, batch replace keywords, or clean up messy text, this node provides robust support. Its dual-output design allows you to create complex node chaining, passing the remaining text from one node to the next for further processing.

Core Features

• Dual Outputs (Node Chaining): Provides processed_text (Target) and remaining_text outputs. You can chain the remaining_text to another AdvancedTextFilter node for multi-step text parsing.
• 17+ Operation Modes:
  • Global Find/Replace/Extract
  • First-Match Split/Between
  • Format Cleanup
  • [New] LLM Output Parsing (JSON, Code blocks)
• Robust Error Handling (v1.1.5): The new if_not_found option allows you to choose the fallback behavior (return original, return empty, or trigger error) when a pattern isn't found, preventing batch workflow failures.
• Powerful Regex Support: A use_regex toggle switches all find and split operations to use Regular Expressions. Now supports DOTALL mode for multi-line matching.
  • Regex extract with one capture group returns the captured text; multiple capture groups are joined as group1 | group2.
• Multi-Keyword Handling: Find/Replace operations support multiple, comma-separated (,) targets in the optional_text_input field.
• Input Flexibility: An optional external_text input allows you to concatenate two text sources (like B-box data and a prompt) before processing.
• Pre-processing: Built-in to UPPERCASE / to lowercase functions to normalize case before any operation.

Operation modes

The node's operations are split into three main categories:

A. Find / Replace / Extract (Global Operations)

This group finds and processes all matching instances. It uses the optional_text_input field as the target.

• find and remove: Removes all specified keywords.
• find and replace: Replaces all keywords with replace_with_text.
• find all (extract): Extracts all matched keywords; returns original text with matches removed as "remaining".

B. Split & Between (First Match Only)

This group targets only the first matched instance. It uses the start_text and end_text fields.

• extract between / remove between
• extract before start text / remove after start text
• extract after start text / remove before start text

C. Text Cleanup

• remove empty lines, remove newlines, strip lines (trim), remove all whitespace.

D. LLM Utilities (New in v1.1.5)

Specialized tools for processing raw outputs from Large Language Models (LLMs).

• LLM: extract code block (```): Extracts code content strictly within triple backticks.
• LLM: extract JSON object ({...}): Locates and extracts the first valid JSON object structure, useful for chaining with JSON parsers.
• LLM: clean markdown formatting: Removes bold (**), italics (*), headers (#), and links to return clean, plain text.

E. Batch Operations (New in v1.2.0)

Designed for Img2Text workflows or bulk cleaning.

• batch replace (use replacement_rules): Performs multiple find-and-replace operations in a single pass.

  • Uses the replacement_rules input box.

  • Syntax: find_text -> replace_text (one rule per line).

  • Example:

    ugly -> beautiful
    bad hands -> detailed hands
    error_tag -> 
    

  • Supports Regex if use_regex is enabled.

---

2. Text Utilities

Text Input Node

A smart text combiner that merges up to 7 text sources into a single string.

• Flexible Inputs: Mix of 3 input slots (for chaining) and 4 text widgets (for manual input).
• Auto-Cleaning: Automatically filters out empty inputs to prevent double separators.
• Fun Fallback: If no input is provided, it returns a cute placeholder prompt.

Text Scraper Node

Fetches and formats headlines from public HTTP/HTTPS URLs. Ideal for injecting real-time context into LLMs.

• Simple Interface: Just input a URL string.
• Smart Parsing: Uses heuristics to identify headlines from h1-h3, headline-like class names, and matching links.
• Safe: Allows only HTTP/HTTPS public targets by default, blocks local/private network addresses, and includes timeouts to prevent workflow freezing.

Text Storage Nodes (Reader & Writer)

A persistent "clipboard" for ComfyUI. These nodes allow you to save and retrieve text data across different workflows or sessions. Current ComfyUI installs store new entries under the ComfyUI user directory when available, while legacy entries in this node's text_storage/ folder remain readable.

Text Storage (Writer)

Saves text content to a file or internal database.

• Inputs:
  • text_input: The text content to save.
  • filename_prefix: Optional prefix for categorization (e.g., ProjectA_).
  • save_name: The main filename or key. Supports Time Formatting (e.g., %Y-%m-%d) and Wildcards (e.g., *** for auto-incrementing 001, 002...).
  • mode:
    • Add New (Auto Rename): Automatically avoids conflicts by renaming (e.g., Log_2024-11-26_001.txt).
    • Overwrite Existing: Replaces content if the name exists.
    • Delete: Removes the specified file/key from both the current user-directory storage and legacy plugin-local storage when both exist.
  • storage_format (New!):
    • json: Saves as a key inside the internal text_storage.json database.
    • txt: Saves as a standalone .txt file for easy external editing.

Text Storage (Reader)

Retrieves saved text content.

• Unified List: Automatically scans and lists both JSON keys and .txt files from the storage folder.
• Passthrough: Outputs the selected text content string.
• > Important Note: The dropdown list is generated when the node loads. If you have just saved a NEW file using the Writer node, you must Refresh the ComfyUI Page (F5) to see the new file appear in the Reader's list.

Wildcards Processor (Dynamic Prompt Mixer)

Generate rich, dynamic prompts using wildcard syntax (e.g., __style__) and random choices (e.g., {cat|dog}). This node has been evolved into a powerful 7-slot mixer.

• Unified & Powerful (7-Slot Mixer): Replaces the previous Basic/Advanced split with a single, robust node. It features 7 input slots, allowing you to combine manual text and wildcard files in complex layers.
• Hybrid Inputs: Each of the 7 slots offers both a Text Box (for manual prompt or {choice} syntax) and a Dropdown Menu (to select a wildcard file). They work together—you can use one, the other, or both simultaneously.
• Smart "Random" Mode: The dropdown menu includes a special "Random" option. When selected, it picks a random wildcard file from your collection for that specific slot, adding an extra layer of surprise.
• Recursive Generation: Fully supports nested wildcards (e.g., a wildcard file containing other __wildcards__).
• Independent Seeds: Each input slot uses a unique internal seed offset. This ensures that even if you use the same {A|B} syntax in multiple slots, they won't rigidly output the same result.
• Cross-Platform: Fully supports nested subdirectories and handles Windows/Linux/macOS file paths correctly.
• Wildcard Sources: Looks in ComfyUI/wildcards/ first, then this plugin's wildcards/; duplicate names are resolved from the ComfyUI root folder first.

---

3. Logic & Math Nodes (Simple Eval)

Safely evaluate Python expressions for dynamic calculations and logic flow. Powered by simpleeval.

Simple Eval (Integers / Floats / Strings)

Perform mathematical calculations or string manipulations without writing complex code.

• 3 Variants: Dedicated nodes for Integers, Floats, and Strings.
• Variables: Supports inputs a, b, and c. You can use them in your expression (e.g., (a + b) * 2 or a + " " + b).
• Safe execution: Restricted environment prevents unsafe code execution while allowing powerful logic.
• Console Logging: Optional toggle to print results to the console for debugging.

---

4. Image Utilities

Advanced Image Saver

A professional-grade image export node with advanced quality control and aesthetic filtering.

• Aesthetic Score Filtering:
  • Optional support for the Aesthetic Predictor V2.5 model; install it with pip install aesthetic-predictor-v2-5.
  • calculate_aesthetic_score enables built-in scoring for each image.
  • Built-in scoring uses a loader that requires trusted remote code, so allow_aesthetic_remote_code is disabled by default and must be explicitly enabled before the model will load.
  • aesthetic_precision supports auto, bf16, fp16, fp32, and cpu_fp32; auto uses the best supported device/precision and falls back when needed.
  • keep_aesthetic_model_loaded controls whether the scorer remains cached after a run.
  • The optional aesthetic_score input lets you supply external scores without loading the built-in predictor.
  • Images scoring below aesthetic_threshold are filtered from the outputs.
• Flexible Output Path:
  • Dynamic path parsing with time formatting (e.g., [time(%Y-%m-%d)] → 2025-12-25).
  • Relative paths are kept under ComfyUI output; absolute paths require the explicit allow_absolute_output_path opt-in.
  • Auto-create directories if they don't exist.
• Smart Filename Generation:
  • Customizable filename_prefix, filename_delimiter, and filename_number_padding.
  • Auto-increment counter with conflict detection.
  • filename_number_start switches between number-first and number-last formats (0001_prefix vs prefix_0001).
  • overwrite_mode = prefix_as_filename uses the prefix as a static filename.
• Multi-Format Support:
  • PNG: Stores node-controlled metadata through PngInfo.
  • JPEG/JPG: Quality control (1-100) with DPI settings.
  • WebP: Lossless mode support with EXIF metadata storage.
  • BMP/TIFF: Additional fallback formats.
• Metadata Management:
  • metadata_mode controls full / minimal / none.
  • embed_workflow controls whether ComfyUI-restorable prompt / workflow graph data is written where supported.
  • When workflow embedding is disabled, saved metadata will not include ComfyUI-restorable prompt or workflow graph entries.
  • minimal mode preserves the current parameters summary for downstream metadata readers.
  • JPEG/JPG metadata support is intentionally limited; use PNG or WebP when metadata must be read back.
  • WebP: Stores metadata in EXIF tags (Make/ImageDescription).
• Output Control:
  • Three Outputs: filtered_images (IMAGE), files (paths), scores (aesthetic scores).
  • Optional preview toggle for headless workflows. When saving to an absolute path outside ComfyUI output, the file is still returned in files, but ComfyUI previews are omitted because /view only serves host-managed output paths.
  • Returns only images that pass aesthetic threshold for downstream nodes.

Image Cropper

A handy utility to crop images directly within your workflow.

• Targeted Cropping: Crop by fixed side length, aspect ratio, alignment, and XY offsets.
• Mask-guided Centering: Can use an optional mask to bias the crop center toward the masked subject.
• Optional Rescaling: Can rescale the cropped result by longest side, shortest side, width, or height.
• Batch Processing: Supports cropping for image batches.

Resize Image Advanced

Resize image batches with direct size controls, aspect-ratio target calculation, and optional mask alignment.

• Node ID: Registered as ResizeImageAdvanced with display name Resize Image Advanced.
• Resize Modes: Use explicit width/height or automatic aspect-ratio sizing with original, custom, and common presets.
• Scale Targets: scale_to_side supports longest side, shortest side, width, height, and total kilo-pixel targets.
• Fit Modes: Supports fill, stretch, resize, letterbox, pad, pad_edge, pad_edge_pixel, pillarbox_blur, crop, and total_pixels.
• Methods and Device: Preserves KJ-style nearest-exact, bilinear, area, bicubic, lanczos, and optional nvidia_rtx_vsr methods, plus CPU/GPU device selection. RTX VSR requires a compatible NVIDIA VFX runtime and GPU.
• Background Fill: background_color controls letterbox/pad canvas fill.
• Multiple Alignment: round_to_multiple keeps the final size divisible by a selected integer, covering the original KJ divisible_by behavior.
• Mask Alignment: Optional MASK input is resized, cropped, or padded with the image and returned as an aligned mask.
• Workflow Helpers: Returns IMAGE, final width, final height, and aligned MASK outputs.

Image and Mask IO

Image and mask IO utilities for workflows that need to load batch images or persist mask data.

• Load Image Batch: Loads one static IMAGE from a directory by path + relative pattern, with single, incremental, or seeded-random selection. When ComfyUI validation hooks are available, invalid folders, empty matches, unsafe patterns, and out-of-range fixed indexes are reported before execution. Registered as LoadImageBatch.
• Save Mask: Writes masks to the ComfyUI output directory as PNG files.
• Load Mask: Loads supported image files from the ComfyUI input directory and converts them to MASK.
• ComfyUI Integration: Uses ComfyUI input/output path helpers when available.

Image Concat Advanced

Concatenate images from a batch (or list) into a directional grid.

• Direction: left_to_right / right_to_left / top_to_bottom / bottom_to_top.
• Wrap Limit: max_images_per_line controls when the layout wraps to the next row or column.
• Resize: Each cell uses the first image size; other images are resized to fit while keeping aspect ratio.
• Blank Fill: Incomplete final rows or columns are filled with blank cells.
• Output Channels: Force rgb (default), rgba, or auto.

Add Text to Image

Renders text onto images with advanced formatting options.

• Adaptive Text Layout: auto_adapt wraps and shrinks text to fit both width and height; the non-adaptive path truncates with ellipsis.
• Flexible Placement: Supports center/corner anchors, margins, text-box or full-width-strip backgrounds, and per-line spacing.
• Batch Support: Can process image batches; text labels loop automatically if fewer than images.
• Font Fallbacks: Handles missing stored font names by resolving compatible fonts from the current environment when possible.
• Compatibility: Always outputs standard RGB images for downstream image/video nodes.

---

Installation

Method 1: Via ComfyUI Manager (Recommended)

This is the easiest way to install the node pack.

1. Open ComfyUI Manager within your ComfyUI interface.
2. Click on "Custom Nodes Manager".
3. Search for ComfyUI Text Processor.
4. Click Install and wait for the process to complete.
5. Restart ComfyUI.

Method 2: Manual Installation

If you prefer terminal commands or don't use the Manager:

1. Navigate to your custom nodes directory:

   cd ComfyUI/custom_nodes/
   

2. Clone this repository:

   git clone https://github.com/rookiestar28/ComfyUI_Text_Processor.git
   

3. Install dependencies:

   pip install -r requirements.txt
   

   Optional built-in aesthetic scoring support:

   pip install aesthetic-predictor-v2-5
   

4. Restart ComfyUI.

---

Asset Setup (Optional)

• Fonts: Place your .ttf or .otf files in ComfyUI/custom_nodes/ComfyUI_Text_Processor/fonts/ for the Add Text to Image node.
• Wildcards: Place your wildcard text files in ComfyUI/wildcards/ or ComfyUI/custom_nodes/ComfyUI_Text_Processor/wildcards/.

---

License

This project is licensed under the MIT License. See LICENSE for details.

<details> <summary><strong>Click to see handy Regex Patterns (Cheat Sheet)</strong></summary>

🧹 Basic Cleaning

| Goal | Regex Pattern | Description | | :--- | :--- | :--- | | Remove Extra Spaces | \s+ | Replaces multiple spaces with a single space. | | Remove Non-English | [^a-zA-Z0-9,\.\s] | Removes everything except English letters, numbers, commas, and dots. | | Remove Digits/Numbers | \d+ | Removes all numbers (e.g., weights or unintended seeds). | | Clean Line Breaks | [\r\n]+ | Replaces new lines with commas (useful for flattening lists). |

🔍 Advanced Extraction & Filtering

| Goal | Regex Pattern | Description | | :--- | :--- | :--- | | Remove HTML Tags | <[^>]*> | Cleans up text scraped from websites (removes div, br tags, etc.). | | Remove Weight Brackets | \(([^)]*:\d+(?:\.\d+)?)\) | Removes standard prompt weights like (word:1.2). | | Extract Email | [a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,} | Extracts email addresses from mixed text. | | Match Wildcards | __\w+__ | Matches typical wildcard syntax like __character__. |

</details>