CivArchive
    Flux1 kontext (nunchaku+Multi_input+Lora、gguf) 70% time savings,Improved accuracy - NCK Multi_input+Lora_V1
    NSFW
    Preview 88771584
    Preview 85482210
    Preview 85599717
    Preview 85449955
    Preview 85450570
    Preview 85414944
    Preview 85414892
    Preview 85418457
    Preview 85418304
    Preview 85414946
    Preview 85414903
    Preview 85414893
    Preview 85465719
    Preview 85483458
    Preview 85483421
    Preview 85471449
    Preview 85482790

    Nunchaku Multi_input+Lora

    Now includes two separate workflows:
    ------Kontext_gguf&safetensors__Multi_input&Lora.json
    ------Kontext_nunchaku_Multi_input&Lora.json

    Anyone Installed mit-han-lab/ComfyUI-nunchaku but can't get it workin' right? Look here!

    so I really took my time setting up this workflow this time around. For anyone who's used the official nodes but doesn't know how to use multiple image inputs, or how to customize the generation resolution, or how to switch to the nunchuka-textencoder model… this streamlined workflow is perfect for you!

    The image generation time using nunchak's int4 model is now, like, one-fourth of what it used to be for me, and with very little loss in quality. I honestly don't even want to use gguf anymore.

    Nuchaku Checkpoint:

    https://huggingface.co/mit-han-lab/nunchaku-flux.1-kontext-dev/tree/main

    aqw-int4-flux.1-t5xxl (Optional):

    https://huggingface.co/mit-han-lab/nunchaku-t5/tree/main

    Nunchaku comfyui node:

    https://github.com/mit-han-lab/ComfyUI-nunchaku


    ComfyUI-nunchaku Installation Guide (windows):

    1.In the address bar of the ComfyUI_windows_portable directory, type cmd and press enter. Then, enter the following commands to check your torch and python versions:

    • "python_embeded\python.exe"

    • "python_embeded\python.exe -m pip list"
      For example, mine shows python 3.12 and torch 2.5.1+cu124.

    2.You can install the nunchaku node (ComfyUI-nunchaku v0.3.3) using ComfyUI-Manager, or manually by typing cmd in the address bar of the ComfyUI_windows_portable\ComfyUI\custom_nodes directory and then running git clone https://github.com/mit-han-lab/ComfyUI-nunchaku.git.

    3.Download the nunchaku whl file that corresponds to your versions from: https://github.com/mit-han-lab/nunchaku/releases. I already checked the version info in step 1, so I'll download nunchaku-0.3.1+torch2.5-cp312-cp312-win_amd64.whl. Afterdownloading, place the whl file in the ComfyUI_windows_portable directory, and then install it using "python_embeded\python.exe -m pip install nunchaku-0.3.1+torch2.5-cp312-cp312-win_amd64.whl".

    4.After installing, don't forget to update ComfyUI to the latest version and restart. Also, remember to place the downloaded nunchaku model in the diffusion_models folder. For Nvidia 40-series cards and below, choose int4; for 50-series, you can choose FP4.

    5.I found that python 3.11-based ComfyUI didn't work properly in my tests, but i'm not completely sure about that.


    gguf+Lora

    Got questions like 'Is there too much going on in the workflow?' or 'Are the hardware requirements too steep?' or 'Where do I even download the models?' or 'Does the output keep ignoring my input image?

    This workflow is actually made for beginners. You seriously just need this single workflow file, and that's it. And honestly, I barely did anything on it; I just took the official ComfyUI workflow, tweaked it a little, and added support for gguf and Lora.

    How to Use:

    1. Drag the workflow or example image into ComfyUI, and install any missing nodes.

    2. Download the model, place it in the diffusion_models folder, then update ComfyUI and restart.

    Checkpoint:

    https://huggingface.co/bullerwins/FLUX.1-Kontext-dev-GGUF/tree/main

    Guide:

    https://docs.bfl.ai/guides/prompting_guide_kontext_i2i

    https://docs.comfy.org/tutorials/flux/flux-1-kontext-dev

    https://comfyui-wiki.com/en/tutorial/advanced/image/flux/flux-1-kontext

    Here's what Flux1 Kontext can do right now, and I can't even list it all, but these are the main things:

    1. Change image style / Style transfer.

    2. Add or remove objects in the image.

    3. Make characters perform different actions (like turning around) or change their expressions while keeping their look consistent.

    4. Combine multiple characters and scenes.

    5. Virtual try-on for models. (I haven't gotten this to work in my tests yet. It worked, but I'm not happy with the results. ~The good news is that it is open source and free)

    so if you're selling clothes, check this out for model try-ons: if you don't specify a particular model, just give it the images of the clothes, and let Kontext generate the model for you. You'll actually get much better results that way!

    Description

    FAQ

    Comments (39)

    93dcmomi802Jun 30, 2025· 3 reactions
    CivitAI

    workflowKS node?

    SamLiu
    Author
    Jun 30, 2025· 2 reactions

    What you need is a beginner's tutorial. Try searching ‘How to use ComfyUI-Manager to install missing nodes and update ComfyUI’.

    Takethis16Jul 1, 2025· 3 reactions

    Rename the node from "workflowKS" to "KS". Save the workflow. reload the workflow, don't simply refresh it.
    The node was renamed and is giving an error for this reason.

    ybkzzang6422929Jul 1, 2025

    @Takethis16 THANK YOU!!!

    LolelJul 1, 2025

    @Takethis16 Does not seem to work for me. I renamed the node, saved, clicked X to close the workflow, reloaded it from the workflow panel but it is still showing the node as missing.

    SamLiu
    Author
    Jul 1, 2025

    @Lolel Maybe try dragging the workflow into ComfyUI again?

    Takethis16Jul 1, 2025

    @Lolel just go workflow, open and select the workflow you just saved.

    6ixthlogicJul 3, 2025

    need to learn what "Nunchaku" is.

    zczcgJul 4, 2025

    @Takethis16 can`t solve...the same

    Cant solve this one. Tried renaming to KS as suggested, it made me even download a node "NAG", but still nothing

    @SamLiu not really. the missing nodes have to show up in missing nodes to seek a begginers tutorial.

    SamLiu
    Author
    Jul 6, 2025

    @engagehostiles659 Double-check that you've successfully installed the Nunchaku nodes. Then, try dragging the workflow into ComfyUI again. OR, right-click on the KS node and select “convert to node.” >refresh

    kot0haJul 7, 2025

    In my case, I tried renaming "workflowKS" to "KS," but it still indicated that the nodes could not be found. However, upon closer investigation, I discovered an error in the console log showing that the nunchaku custom node was not installed correctly. So, I carefully reread the installation instructions and installed the correct wheel file, which resolved all the issues, and the workflow began to operate normally. If you are still unable to resolve the problem, I believe the first step is to confirm that your nunchaku custom node are installed correctly.

    P.S. Translated with the help of an LLM, so please excuse any errors in the English.

    ThePantherPilotJul 8, 2025· 2 reactions

    If you search for KS in the Nodes Library tab on the left of the screen, you should be able to find it. You just have to switch over your connectors.

    kamil321418Jul 8, 2025

    something is wrong with this node; I've tried to change the "Node name for S&R" to KS, workflow>KS, nothing. I even copied the name from a newly added KS node - the new one worked, the workflow one - nope. So I just recabled everything to the new node and it clicked.

    skyrimer3dJun 30, 2025
    CivitAI

    I have Python 3.10.6, and comfyui shows pytorch version: 2.7.1+cu128 when it boots, i'm on windows so i tried to install nunchaku-0.3.2.dev20250630+torch2.7-cp310-cp310-win_amd64.whl , but i get "ERROR: nunchaku-0.3.2.dev20250630+torch2.9-cp310-cp310-linux_x86_64.whl is not a supported wheel on this platform."

    SamLiu
    Author
    Jun 30, 2025· 1 reaction

    linux_x86_64.whl? linux or win?

    SilvicultorJul 3, 2025

    Make sure that you download the correct wheel for your OS, it can easily happen that you accidentally copy&pasted the wrong link. The error message clearly states that you tried to install the wheel intended for use with Linux. Also don't install the nightly/dev version of Nunchaku. 0.3.1 is recommended for use with Comfy. Give this one a try: https://huggingface.co/mit-han-lab/nunchaku/blob/main/nunchaku-0.3.1%2Btorch2.7-cp310-cp310-win_amd64.whl

    6ixthlogicJul 3, 2025

    pip installed the linux file? maybe.

    skyrimer3dJul 3, 2025

    @Silvicultor I ended up using "pip install torch==2.6 torchvision==0.21 torchaudio==2.6" like the github guide says, then used "nunchaku-0.2.0+torch2.6-cp310-cp310-win_amd64.whl" and it works, great wf indeed!

    BarokLesJul 5, 2025
    CivitAI

    Got this to work after a bit of messing about. Thank you so much for such a comprehensive workflow.

    SamLiu
    Author
    Jul 6, 2025

    Thanks to you! Your kind words really fuel my work.

    yoggypapJul 7, 2025
    CivitAI

    very nice, but hard to instal

    tbsmaxJul 9, 2025
    CivitAI

    Can this be done without the nunchaku???

    SamLiu
    Author
    Jul 11, 2025

    Made a few adjustments, so feel free to download it again.

    mertbaspinar34163Jul 19, 2025· 2 reactions
    CivitAI

    how can i download Quality__Details__Shaping__NSFW_Flux__V1-0000001 ?

    fipof22873112Jul 23, 2025· 1 reaction
    CivitAI

    I love this Workflow thanks.

    royalcask192Jul 29, 2025
    CivitAI

    All I get is loop error when trying your workflow?

    Nunchaku is a dependencies nightmare, so make sure you have the right version to match your python and torch versions (follow OP's installation instructions, above)

    STRWh3r3Aug 4, 2025
    CivitAI

    can it do NSFW?

    zxmizza382Aug 12, 2025
    CivitAI

    如何下载 Quality__Details__Shaping__NSFW_Flux__V1-0000001?

    89184840795s492Aug 14, 2025
    CivitAI
    I have this error, how can I solve it? Failed to get input node O for group node child 207:1 with slot O

    LuzhSep 28, 2025· 7 reactions
    CivitAI

    I have encountered this problem, can anyone help me please?

    Prompt outputs failed validation: FluxGuidance: - Required input is missing: conditioning

    SamLiu
    Author
    Oct 26, 2025

    Make sure ComfyUI is updated to the latest version. When you're using it, remember to bypass any image input nodes you're not actually using. That's the only solution I can think of. I have no idea about your workflow, though. Maybe you could record your process and upload it to Reddit or YouTube? I'm sure someone there would be able to help you out.

    itaskyDec 16, 2025

    i have the same error

    944739287517Jan 20, 2026

    It seems I found the problem through GEMINI. It told me that I need to unpack it, meaning breaking these composite nodes into native ones, and then it can run normally.

    itaskyDec 16, 2025
    CivitAI
    # ComfyUI Error Report ## Error Details - **Node ID:** N/A - **Node Type:** N/A - **Exception Type:** Prompt execution failed - **Exception Message:** Prompt outputs failed validation: FluxGuidance: - Required input is missing: conditioning ## Stack Trace ``` PromptExecutionError@http://127.0.0.1:8188/assets/index-UkVvUXbW.js:2:10374 queuePrompt@http://127.0.0.1:8188/assets/index-UkVvUXbW.js:4:5402 ``` ## System Information - **ComfyUI Version:** 0.4.0 - **Arguments:** main.py --listen --reserve-vram 0.6 - **OS:** linux - **Python Version:** 3.10.14 (main, May 6 2024, 19:42:50) [GCC 11.2.0] - **Embedded Python:** false - **PyTorch Version:** 2.8.0+cu128 ## Devices

    Workflows
    Flux.1 Kontext

    Details

    Downloads
    4,719
    Platform
    CivitAI
    Platform Status
    Available
    Created
    6/30/2025
    Updated
    4/30/2026
    Deleted
    -

    Files

    flux1KontextNunchakuMulti_nckMultiInputLoraV1.zip

    flux1KontextNunchakuMulti_nckMultiInputLoraV1.zip