ComfyUI-Krea2-Projector-Tuner Introduction
ComfyUI-Krea2-Projector-Tuner (BSS) is a custom ComfyUI node for adjusting how a loaded Krea2 model responds to text prompts. It applies temporary changes to the model’s txtfusion.projector layers while a workflow runs. You can choose a ready-made preset or adjust 12 sliders to experiment with prompt-following, composition, style, and the behavior the author describes as filter bypass.
The changes are applied in memory, rather than saved into the original model file. This lets you try different settings without permanently altering your Krea2 model. You can also save slider combinations as presets to reuse in later sessions.
How ComfyUI-Krea2-Projector-Tuner Works
Think of the projector as part of the path between your written prompt and the image the model generates. The tuner changes the strength of selected parts of that path. Instead of editing a model file, it uses ComfyUI’s weight-patching system to apply those changes to the model passed through the node.
Place the tuner between your Krea2 model loader and the node that uses the model, such as KSampler:
[Loader (Model)] → [Krea2 Projector Tuner (BSS)] → [KSampler (model)]
You then choose a preset or set the sliders yourself. The node passes the patched model onward for generation. This makes it practical to compare settings: keep your prompt and other workflow settings the same, change the tuner configuration, and observe what changes in the output.
ComfyUI-Krea2-Projector-Tuner Features
Presets and manual controls
The preset dropdown lets you select a saved configuration or choose custom for manual tuning. The included presets are stored as separate JSON files in the presets/ folder, which the extension writes on first start:
| Preset file | What the available documentation establishes |
|---|---|
strongx3_wl7.json | The author highlights Strongx3_wl7 as a recommended configuration and uses it in the example workflow. |
strong_2.5.json | An included alternative configuration. |
clean_bypass.json | An included configuration named for filter-bypass tuning. |
The available documentation does not specify the individual slider values or provide verified image comparisons for these presets. Treat them as starting points: try each one with the same prompt to see which result suits your work.
Selecting a preset updates the sliders on the node. If you move a slider afterward, the dropdown switches to custom, so you can tell that you are no longer using the saved values unchanged.
Overall strength and fine tuning
multiplierscales all the knob values together. Its default is1.0, and its range is -10.0 to +10.0. It is useful when you like the balance of a configuration but want to change its overall strength without editing every knob.knob_0throughknob_11control individual parts of the patch. Each has a range of -5.0 to +5.0, giving you more targeted control than the overall multiplier.
Sliders move in 0.01 increments for easier adjustment. You can also type more precise values, or load them from presets, with up to six decimal places preserved. For a first comparison, choose a preset and make small changes to one knob at a time; that makes it easier to identify which adjustment affected your image.
The author describes the knobs in broad groups:
| Knobs | Intended area of influence |
|---|---|
| 0–1 | Earlier text processing, including syntax and direct prompt-following. |
| 2–6 | Objects, spatial layout, composition, and human proportions. |
| 7–10 | More abstract themes, style, and negative alignment, including behavior the author associates with safety filtering. |
| 11 | The final text-encoder layer. |
These descriptions are a guide to experimentation, not a guarantee that changing a particular knob will produce the same visible effect in every image. The author describes making knobs 7–10 more negative as a way to suppress filtering-related behavior.
Preset buttons
The node provides three actions for managing your configurations:
- Save Preset: Saves the current manual slider values as a new JSON preset. The preset list refreshes in the interface.
- Delete Selected Preset: Deletes the selected preset file and returns the dropdown to
custom. - Open Presets Folder: Opens the folder containing preset files in your operating system’s file explorer.
Preset files can also be renamed, shared, or removed through your file explorer. Be careful with Delete Selected Preset: it removes the selected file from disk, not just from the dropdown.
ComfyUI-Krea2-Projector-Tuner Models
This extension does not provide a separate image-generation model. Its node takes an already loaded Krea2 model as input and passes a temporarily patched model to the next node. The included JSON files are tuning presets, not models or checkpoints; they change the tuner’s settings rather than replacing your Krea2 model.
What’s New with ComfyUI-Krea2-Projector-Tuner
The provided documentation identifies v2.0.0 and highlights these features:
- In-memory model patching applies changes without rewriting the original model file.
- Separate JSON presets make saved configurations easier to manage and reuse.
- On-node preset buttons let you save, delete, and browse presets from the ComfyUI interface.
- Automatic interface updates show a preset’s values on the sliders and switch back to
customwhen you adjust one. - 0.01 slider steps and precise typed values support both quick exploration and careful tuning.
No earlier version history is provided, so specific changes between previous releases are not documented here.
Troubleshooting ComfyUI-Krea2-Projector-Tuner
The tuner does not seem to affect the generated image.
- Check that the node receives the loaded Krea2 model through its
modelinput. - Check that the tuner’s model output—not the loader’s original output—is connected to the model input of your generation node.
- Compare a clearly different preset or setting while keeping your prompt and other workflow settings the same.
My saved preset is not showing the values I expected.
- Select the preset and check whether the node’s sliders update.
- If the dropdown says
custom, a slider has been adjusted since the preset was selected. - To keep those adjusted values for later, use Save Preset and give the configuration a new name.
I cannot find my preset files.
Use Open Presets Folder on the node. The extension stores presets as JSON files in its presets/ folder.
Can the tuner permanently change or corrupt my Krea2 model file?
The documented patching method applies changes in memory rather than writing them into the original model file. Saved presets are separate JSON files.
Do I need to tune all 12 knobs?
No. You can start with an included preset, use multiplier to adjust its overall strength, and only change individual knobs when you want to explore a more specific effect.
Learn More about ComfyUI-Krea2-Projector-Tuner
- ComfyUI-Krea2-Projector-Tuner repository — the extension’s project page.
- Russian-language README — the author’s alternate-language documentation.
