<div align="center">

ComfyUI-TinyBreaker

<!-- Main Image -->

<!-- Badges -->

|

</div>

ComfyUI-TinyBreaker is a collection of custom nodes specifically designed to generate images using the TinyBreaker model. It's actively developed with ongoing improvements. Although still in progress, these nodes are functional and allow you to explore the potential of the model.

TinyBreaker model
While still in the prototype stage, the TinyBreaker model stands out for its unique features. To learn more about its strengths and discover upcoming improvements, check out "What is TinyBreaker?"

Table of Contents

1. Required Files
2. Node Installation
   • Installation via ComfyUI Manager (Recommended)
   • Manual Installation
3. Workflow Example
4. Features
   • Unified Prompt
   • Special Ctrl Keys
   • Predefined Styles
   • CivitAI/A1111 Image Compatibility
5. Acknowledgments
6. License

Required Files

You need to have these two models copied into your ComfyUI application:

• tinybreaker_prototype0.safetensors (3.0 GB):
  • place the file in the 'ComfyUI/models/checkpoints' folder.
• t5xxl_fp8_e4m3fn.safetensors (4.9 GB):
  • place the file in the 'ComfyUI/models/clip' folder (or 'ComfyUI/models/text_encoders').
  • this model is a versatile text encoder used by FLUX and SD3.5 as well.

Node Installation

Ensure you have the latest version of ComfyUi.

Installation via ComfyUI Manager (Recommended)

The easiest way to install the nodes is through ComfyUI Manager:

1. Open ComfyUI and click on the "Manager" button to launch the "ComfyUI Manager Menu".
2. Within the ComfyUI Manager, locate and click on the "Custom Nodes Manager" button.
3. In the search bar, type "tinybreaker".
4. Select the "ComfyUI-TinyBreaker" node from the search results and click the "Install" button.
5. Restart ComfyUI to ensure the changes take effect.

Manual Installation

To manually install the nodes:

1. Open your preferred terminal application.
2. Navigate to your ComfyUI directory:

   cd <your_comfyui_directory>
   

3. Move into the custom_nodes folder and clone the repository:

   cd custom_nodes
   git clone https://github.com/martin-rizzo/ComfyUI-TinyBreaker
   

Windows Portable

For those using the standalone ComfyUI release on Windows:

1. Go to where you unpacked ComfyUI_windows_portable,
   you'll find your run_nvidia_gpu.bat file here, confirming the correct location.
2. Press CTRL + SHIFT + RightClick in an empty space and select "Open PowerShell window here".
3. Clone the repository into your custom nodes folder using:

   git clone https://github.com/martin-rizzo/ComfyUI-TinyBreaker .\ComfyUI\custom_nodes\ComfyUI-TinyBreaker
   

Workflow Example

This image contains a simple workflow for testing the TinyBreaker model. To load this workflow, simply drag and drop the image into ComfyUI.

<img src="workflows/ximg/tinybreaker_example.png" width="100px">

For further information and additional workflow examples, please consult the workflows folder.

Features : Unified Prompt

The 'Unified Prompt' node allows you to input both your prompt and parameters within a single text area, streamlining your workflow. This eliminates the need for separate input fields.

When using the Unified Prompt node:

• Begin by typing your desired prompt text as usual.
• Then write any necessary parameters, each preceded by a double hyphen (--).
• Utilize the special keys CTRL+UP and CTRL+DOWN to modify the values of each parameter.

Parameters Supported by the Unified Prompt

| Minor image adjustments | Description | |:-----------------------------------------------|----------------------------------------------------------------------------| | --no <text> | Specifies elements that should not appear in the image. (negative prompt) | | --refine <text> | Provides a textual description of what elements should be refined. | | --img-shift <number> | Specifies variants of the refinement without changing composition. | | --cfg-shift <number> | Adjusts the value of the Classifier-Free Guidance (CFG). | | --detail-level <level> | Sets the intensity level for detail refinement. |

| Major changes | Description | |:-----------------------------------------------|----------------------------------------------------------------------------| | --seed <number> | Defines a number for initializing the random generator. | | --aspect <ratio> | Specifies the aspect ratio of the image. | | --landscape , --portrait | Specifies orientation of the image (horizontal or vertical). | | --small , --medium , --large | Controls generated image size. | | --batch-size <number> | Specifies number of images to generate in a batch. | | --style <style> | Defines the artistic style of the image. |

Examples

--no trees, clouds --refine cats ears --img_shift 2 --cfg-shift 1 --detail-level normal
--seed 42 --aspect 16:9 --portrait --medium --batch-size 4 --style PIXEL_ART

For more details on these parameters, see docs/prompt_parameters.md.

Features : Special Ctrl Keys

The 'Unified Prompt' node offers special control keys for simplifying parameter input and modification:

• CTRL+RIGHT (autocomplete): Initiate a parameter name by typing -- followed by its beginning (e.g., --d). Pressing CTRL+RIGHT will automatically complete the full parameter name (e.g., --detail-level).
• CTRL+UP/DOWN (over parameter value): Increment or decrement the value associated with a parameter. For instance, if your cursor is positioned over --seed 20 and you press CTRL+UP, the text will change to --seed 21.

Features : Predefined Styles

The 'Select Style' node allows you to select an image style. This node injects text into the prompt and modifies sampler parameters to influence the image generation. Please note that these styles are still in development, as I am experimenting with different parameter combinations to refine them over time. Therefore, they might not always function perfectly or reflect exactly what is described here.

Available Styles

| Style Name | Description | |:---------------------|--------------------------------------------------------------------| | PHOTO | Fast photorealistic images with beautiful design. | | ULTRAPHOTO | Realistic images with exceptional detail and clarity. | | DARKFAN80 | Dark fantasy images with 80s cinematic style. | | LITTLE_TOY | Minimalist images in the style of small toys. | | COMIC_ART | Dynamic illustrations in comic book art style. | | PIXEL_ART | Pixel art images with retro and blocky details. | | COLOR_INK | Beautiful drawings in vibrant colorful ink style. | | REALISTIC_WAIFU_X | Realistic images where a woman is the main subject. | | REALISTIC_WAIFU_Y | Realistic images where a woman is the main subject (alternative1). | | REALISTIC_WAIFU_Z | Realistic images where a woman is the main subject (alternative2). |

Features : CivitAI/A1111 Image Compatibility

The 'Save Image' node embeds workflow information into the generated image. Additionally, it embeds prompt and parameter information in a format compatible with CivitAI/A1111, this enables:

• CivitAI can read the prompt used to generate the image when uploaded.
• A wide range of applications can access the prompt and parameters used for image generation.

Acknowledgments

I would like to express my sincere gratitude to the developers of PixArt-Σ for their outstanding model. Their contributions have been instrumental in shaping this project and pushing the boundaries of high-quality image generation with minimal resources.

• PixArt-Σ GitHub Repository
• PixArt-Σ Hugging Face Model
• PixArt-Σ arXiv Report

Additional thanks to Ollin Boer Bohan for the Tiny AutoEncoder models. These models have proven invaluable for their efficient latent image encoding, decoding and transcoding capabilities.

• Tiny AutoEncoder GitHub Repository

License

Copyright (c) 2024-2025 Martin Rizzo
This project is licensed under the MIT license.
See the "LICENSE" file for details.