Save 4 hours! We auto-setup your workflow! Free!

Drop your workflow.json — we handle every dependency, custom node, and model. Just open the link and run.

Auto-Setup Workflow Json (Free) Now!
ComfyUI > Nodes > ComfyUI-Krea2-Projector-Tuner > Krea2 Projector Tuner (BSS)

ComfyUI Node: Krea2 Projector Tuner (BSS)

Class Name

Krea2ProjectorTuner

Category
BSS/Krea2
Author
BlackSnowSkill (Account age: 775days)
Extension
ComfyUI-Krea2-Projector-Tuner
Latest Updated
2026-07-07
Github Stars
0.03K

How to Install ComfyUI-Krea2-Projector-Tuner

Install this extension via the ComfyUI Manager by searching for ComfyUI-Krea2-Projector-Tuner
  • 1. Click the Manager button in the main menu
  • 2. Select Custom Nodes Manager button
  • 3. Enter ComfyUI-Krea2-Projector-Tuner in the search bar
After installation, click the Restart button to restart ComfyUI. Then, manually refresh your browser to clear the cache and access the updated list of nodes.

Visit ComfyUI Online for ready-to-use ComfyUI environment

  • Free trial available
  • 16GB VRAM to 80GB VRAM GPU machines
  • 400+ preloaded models/nodes
  • Freedom to upload custom models/nodes
  • 200+ ready-to-run workflows
  • 100% private workspace with up to 200GB storage
  • Dedicated Support

Run ComfyUI Online

Krea2 Projector Tuner (BSS) Description

Applies 12 preset or custom values to a cloned Krea2 model's text-fusion projector in memory.

Krea2 Projector Tuner (BSS):

Krea2ProjectorTuner adjusts a Krea2 model’s text-fusion projector by applying a set of twelve tuning values as an in-memory model patch. This lets you try preset or manual adjustments without editing model files on disk. The node clones the model patcher before applying the patch, so it does not directly modify the incoming model patcher. It looks for a projector parameter in the model and applies the patch to the first matching parameter it finds; it does not tune every projector parameter.

Krea2 Projector Tuner (BSS) Input Parameters:

model

The MODEL to tune. Connect a model whose parameters include a name containing txtfusion.projector; the node needs that match to place its patch. There is no default model or numeric range. If it finds no matching parameter, it logs an error and returns a clone without the requested patch.

preset

Selects the source of the twelve tuning values. Choose custom to use knob_0 through knob_11; any other available option uses that preset’s values, so the manual knobs do not affect the patch. The options come from built-in presets and valid preset files found when the node’s input list is created; the supplied source does not list every built-in option. The default is Strongx3_wl7 if it is available, otherwise custom. Presets are loaded again when the node runs, so a preset file changed after the menu was created may supply updated values.

multiplier

Scales all twelve selected values—whether they come from a preset or the manual knobs—before the patch is applied. Its default is 1.0, minimum is -10.0, maximum is 10.0, and slider step is 0.01. Use 1.0 for the values as selected, 0.0 to make every patch value zero, or a negative value to reverse their signs. Zero values are still submitted as a patch; this setting is not a bypass switch.

knob_0

The first of twelve manual tuning values. It contributes to the patch only when preset is custom; otherwise, the chosen preset supplies this value. Its default is 0.0, minimum is -5.0, maximum is 5.0, and slider step is 0.01. The source does not assign a separate artistic meaning to this position, so judge its effect by comparing results.

knob_1

The second manual tuning value, used only when preset is custom. Its default is 0.0, minimum is -5.0, maximum is 5.0, and slider step is 0.01. The node multiplies it by multiplier before including it in the twelve-value patch; no specific visual effect is documented for this position.

knob_2

The third manual tuning value, used only when preset is custom. Its default is 0.0, minimum is -5.0, maximum is 5.0, and slider step is 0.01. It supplies one position in the projector patch after scaling by multiplier; its individual artistic role is not specified.

knob_3

The fourth manual tuning value, used only when preset is custom. Its default is 0.0, minimum is -5.0, maximum is 5.0, and slider step is 0.01. It is scaled with the other knobs before patching, but the source does not identify a distinct visual characteristic that it controls.

knob_4

The fifth manual tuning value, used only when preset is custom. Its default is 0.0, minimum is -5.0, maximum is 5.0, and slider step is 0.01. It occupies one position in the twelve-value patch and is multiplied by multiplier; its individual effect must be assessed from your results.

knob_5

The sixth manual tuning value, used only when preset is custom. Its default is 0.0, minimum is -5.0, maximum is 5.0, and slider step is 0.01. Like the other knobs, it supplies a patch value rather than a named artistic control; the source does not document a position-specific effect.

knob_6

The seventh manual tuning value, used only when preset is custom. Its default is 0.0, minimum is -5.0, maximum is 5.0, and slider step is 0.01. The node scales it by multiplier and places it in the patch’s ordered set of twelve values; no particular visual outcome is guaranteed.

knob_7

The eighth manual tuning value, used only when preset is custom. Its default is 0.0, minimum is -5.0, maximum is 5.0, and slider step is 0.01. It affects the submitted patch value for this position after scaling, but the source does not define an independent artistic function for it.

knob_8

The ninth manual tuning value, used only when preset is custom. Its default is 0.0, minimum is -5.0, maximum is 5.0, and slider step is 0.01. It is one of the twelve values prepared for the projector patch; the node source does not map it to a specific visual feature.

knob_9

The tenth manual tuning value, used only when preset is custom. Its default is 0.0, minimum is -5.0, maximum is 5.0, and slider step is 0.01. It is scaled by multiplier with the other values before patching, and its individual effect is not documented.

knob_10

The eleventh manual tuning value, used only when preset is custom. Its default is 0.0, minimum is -5.0, maximum is 5.0, and slider step is 0.01. It supplies the eleventh position of the ordered patch values after scaling; no separate artistic interpretation is provided in the source.

knob_11

The twelfth manual tuning value, used only when preset is custom. Its default is 0.0, minimum is -5.0, maximum is 5.0, and slider step is 0.01. It completes the twelve-value patch after scaling by multiplier; its position-specific visual effect is not documented.

Krea2 Projector Tuner (BSS) Output Parameters:

model

The resulting MODEL is a clone of the incoming model patcher. When the node finds a parameter containing txtfusion.projector and can shape the twelve tuning values to match it, the clone carries an in-memory patch for the first such parameter. Connect this output to the next node that uses your model. If no matching parameter is found, the output is still a model clone, but the requested patch has not been applied.

Krea2 Projector Tuner (BSS) Usage Tips:

  • Start with an available preset and multiplier set to 1.0. Change the multiplier gradually to compare weaker or stronger scaled versions of the same twelve preset values.
  • Select custom before adjusting the knobs. For a controlled comparison, begin with every knob at 0.0, change one knob at a time, and keep your other generation settings consistent; the source does not specify what each knob looks like visually.
  • Keep multiplier at 1.0 while exploring individual knobs so the values you enter are the values submitted to the patch. A multiplier of 0.0 makes all twelve submitted values zero, while a negative multiplier reverses their signs.
  • Check the log if tuning appears to have no effect. The node only patches the first model parameter whose name contains txtfusion.projector; a model without that parameter receives no patch.

Krea2 Projector Tuner (BSS) Common Errors and Solutions:

[Krea2Tuner] Could not find any parameter matching 'txtfusion.projector' in this model's state dict!

  • Explanation: The connected model has no parameter with the name this node searches for. The node returns a model clone without applying the patch.
  • Solution: Connect a compatible model that contains a txtfusion.projector parameter. Check that an upstream node has not replaced the intended model.

[Krea2Tuner] Failed to load preset file …: …

  • Explanation: A JSON preset file could not be read or converted into the twelve numeric values the loader expects. The loader logs the failure and continues with other available presets.
  • Solution: Check that the file is readable JSON containing a name and a knobs list with exactly twelve numbers or numeric strings. Correct the file, then reload or rerun as needed.

[Krea2Tuner] Reshape failed: … Trying to match shape directly.

  • Explanation: The node could not initially fit its twelve values to the selected projector parameter’s shape and is trying another reshape method. This warning alone does not confirm that the patch failed.
  • Solution: Check whether the run completes. If a subsequent shape error stops it, use a compatible model whose selected projector parameter contains exactly twelve values.

RuntimeError: shape … is invalid for input of size 12

  • Explanation: Neither reshape attempt can fit the twelve tuning values into the shape of the first parameter matched by txtfusion.projector.
  • Solution: Use a model with a compatible twelve-value projector parameter. Changing the knob settings will not change the number of values the node produces.

Preset is missing from the menu or does not apply the expected values

  • Explanation: The menu is assembled when the node’s input list is created, while presets are loaded again during execution. A newly added preset may not yet appear in the menu, and a preset name no longer found at execution falls back to Strongx3_wl7 values in the node code.
  • Solution: Refresh or reload the node interface after adding a preset. Check that the preset file still exists, has the intended name, and contains twelve valid values before running again.

Krea2 Projector Tuner (BSS) Related Nodes

Go back to the extension to check out more related nodes.
ComfyUI-Krea2-Projector-Tuner
RunComfy
Copyright 2025 RunComfy. All Rights Reserved.

RunComfy is the premier ComfyUI platform, offering ComfyUI online environment and services, along with ComfyUI workflows featuring stunning visuals. RunComfy also provides AI Models, enabling artists to harness the latest AI tools to create incredible art.

Krea2 Projector Tuner (BSS)