From c807b18b9ae34264fef4637bdf10034addd33991 Mon Sep 17 00:00:00 2001 From: peteromallet Date: Wed, 27 Mar 2024 23:31:50 +0100 Subject: [PATCH] Start work on tile IPA feature --- SteerableMotion.py | 98 +- imports/ComfyUI_IPAdapter_plus/.gitignore | 4 + .../CrossAttentionPatchImport.py | 167 ++ .../ComfyUI_IPAdapter_plus/IPAdapterPlus.py | 605 ++++++ imports/ComfyUI_IPAdapter_plus/LICENSE | 674 +++++++ imports/ComfyUI_IPAdapter_plus/README.md | 126 ++ imports/ComfyUI_IPAdapter_plus/__init__.py | 19 + .../examples/demo_workflow.jpg | Bin 0 -> 237238 bytes .../examples/ipadapter_advanced.json | 618 ++++++ .../examples/ipadapter_combine_embeds.json | 1538 +++++++++++++++ .../examples/ipadapter_faceid.json | 566 ++++++ .../examples/ipadapter_faceid_batch.json | 1168 +++++++++++ .../ipadapter_ideal_faceid_config.json | 756 +++++++ .../examples/ipadapter_negative_image.json | 956 +++++++++ .../examples/ipadapter_noise_injection.json | 676 +++++++ .../examples/ipadapter_simple.json | 546 ++++++ .../examples/ipadapter_tiled.json | 582 ++++++ .../examples/ipadapter_weight_types.json | 1733 +++++++++++++++++ .../examples/ipadapter_weighted_embeds.json | 836 ++++++++ .../image_proj_models.py | 275 +++ .../models/legacy_directory_do_not_use.txt | 0 imports/ComfyUI_IPAdapter_plus/utils.py | 228 +++ imports/IPAdapterPlus.py | 1352 ------------- 23 files changed, 12110 insertions(+), 1413 deletions(-) create mode 100644 imports/ComfyUI_IPAdapter_plus/.gitignore create mode 100644 imports/ComfyUI_IPAdapter_plus/CrossAttentionPatchImport.py create mode 100644 imports/ComfyUI_IPAdapter_plus/IPAdapterPlus.py create mode 100644 imports/ComfyUI_IPAdapter_plus/LICENSE create mode 100644 imports/ComfyUI_IPAdapter_plus/README.md create mode 100644 imports/ComfyUI_IPAdapter_plus/__init__.py create mode 100644 imports/ComfyUI_IPAdapter_plus/examples/demo_workflow.jpg create mode 100644 imports/ComfyUI_IPAdapter_plus/examples/ipadapter_advanced.json create mode 100644 imports/ComfyUI_IPAdapter_plus/examples/ipadapter_combine_embeds.json create mode 100644 imports/ComfyUI_IPAdapter_plus/examples/ipadapter_faceid.json create mode 100644 imports/ComfyUI_IPAdapter_plus/examples/ipadapter_faceid_batch.json create mode 100644 imports/ComfyUI_IPAdapter_plus/examples/ipadapter_ideal_faceid_config.json create mode 100644 imports/ComfyUI_IPAdapter_plus/examples/ipadapter_negative_image.json create mode 100644 imports/ComfyUI_IPAdapter_plus/examples/ipadapter_noise_injection.json create mode 100644 imports/ComfyUI_IPAdapter_plus/examples/ipadapter_simple.json create mode 100644 imports/ComfyUI_IPAdapter_plus/examples/ipadapter_tiled.json create mode 100644 imports/ComfyUI_IPAdapter_plus/examples/ipadapter_weight_types.json create mode 100644 imports/ComfyUI_IPAdapter_plus/examples/ipadapter_weighted_embeds.json create mode 100644 imports/ComfyUI_IPAdapter_plus/image_proj_models.py create mode 100644 imports/ComfyUI_IPAdapter_plus/models/legacy_directory_do_not_use.txt create mode 100644 imports/ComfyUI_IPAdapter_plus/utils.py delete mode 100644 imports/IPAdapterPlus.py diff --git a/SteerableMotion.py b/SteerableMotion.py index 78d7de8..6a953c7 100644 --- a/SteerableMotion.py +++ b/SteerableMotion.py @@ -5,17 +5,12 @@ import numpy as np # Third-party library imports import torch import torchvision.transforms as transforms - from PIL import Image import matplotlib.pyplot as plt - # Local application/library specific imports import folder_paths -from .imports.IPAdapterPlus import IPAdapterApplyImport, prep_image, IPAdapterEncoderImport -from .imports.AdvancedControlNet.latent_keyframe_nodes import LatentKeyframeInterpolationNodeImport -from .imports.AdvancedControlNet.weight_nodes import ScaledSoftUniversalWeightsImport +from .imports.ComfyUI_IPAdapter_plus.IPAdapterPlus import IPAdapterTiledImport, PrepImageForClipVisionImport, IPAdapterAdvancedImport from .imports.AdvancedControlNet.nodes_sparsectrl import SparseIndexMethodNodeImport -from .imports.AdvancedControlNet.nodes import ControlNetLoaderAdvancedImport, AdvancedControlNetApplyImport,TimestepKeyframeNodeImport class BatchCreativeInterpolationNode: @@ -32,8 +27,7 @@ class BatchCreativeInterpolationNode: "images": ("IMAGE", ), "model": ("MODEL", ), "ipadapter": ("IPADAPTER", ), - "clip_vision": ("CLIP_VISION",), - "control_net_name": (folder_paths.get_filename_list("controlnet"), ), + "clip_vision": ("CLIP_VISION",), "type_of_frame_distribution": (["linear", "dynamic"],), "linear_frame_distribution_value": ("INT", {"default": 16, "min": 4, "max": 64, "step": 1}), "dynamic_frame_distribution_values": ("STRING", {"multiline": True, "default": "0,10,26,40"}), @@ -42,35 +36,27 @@ class BatchCreativeInterpolationNode: "dynamic_key_frame_influence_values": ("STRING", {"multiline": True, "default": "(1.0,1.0),(1.0,1.5)(1.0,0.5)"}), "type_of_strength_distribution": (["linear", "dynamic"],), "linear_strength_value": ("STRING", {"multiline": False, "default": "(0.3,0.4)"}), - "dynamic_strength_values": ("STRING", {"multiline": True, "default": "(0.0,1.0),(0.0,1.0),(0.0,1.0),(0.0,1.0)"}), - "soft_scaled_cn_weights_multiplier": ("FLOAT", {"default": 0.85, "min": 0.0, "max": 10.0, "step": 0.1}), - "buffer": ("INT", {"default": 4, "min": 1, "max": 16, "step": 1}), - "relative_cn_strength": ("FLOAT", {"default": 0.1, "min": 0.0, "max": 10.0, "step": 0.01}), - "relative_ipadapter_strength": ("FLOAT", {"default": 1.0, "min": 0.0, "max": 10.0, "step": 0.01}), - "ipadapter_noise": ("FLOAT", {"default": 0.3, "min": 0.0, "max": 1.0, "step": 0.01}), - "ipadapter_start_at": ("FLOAT", {"default": 0.0, "min": 0.0, "max": 1.0, "step": 0.01}), - "ipadapter_end_at": ("FLOAT", {"default": 0.75, "min": 0.0, "max": 1.0, "step": 0.01}), - "cn_start_at": ("FLOAT", {"default": 0.0, "min": 0.0, "max": 1.0, "step": 0.01}), - "cn_end_at": ("FLOAT", {"default": 0.75, "min": 0.0, "max": 1.0, "step": 0.01}), + "dynamic_strength_values": ("STRING", {"multiline": True, "default": "(0.0,1.0),(0.0,1.0),(0.0,1.0),(0.0,1.0)"}), + "buffer": ("INT", {"default": 4, "min": 1, "max": 16, "step": 1}), + "high_detail_mode": ("BOOL", {"default": True}), + "ipa_weight": ("FLOAT", {"default": 1.0, "min": 0.0, "max": 2.0, "step": 0.1}), }, "optional": { } } - RETURN_TYPES = ("IMAGE","CONDITIONING","CONDITIONING","MODEL","SPARSE_METHOD","INT") - # "comparison_diagram, positive, negative, model, sparse_indexes, last_key_frame_position" + RETURN_TYPES = ("IMAGE","CONDITIONING","CONDITIONING","MODEL","SPARSE_METHOD","INT") RETURN_NAMES = ("GRAPH","POSITIVE","NEGATIVE","MODEL","KEYFRAME_POSITIONS","BATCH_SIZE") FUNCTION = "combined_function" CATEGORY = "Steerable-Motion" - def combined_function(self,positive,negative,images,model,ipadapter,clip_vision,control_net_name, + def combined_function(self,positive,negative,images,model,ipadapter,clip_vision, type_of_frame_distribution,linear_frame_distribution_value, dynamic_frame_distribution_values, type_of_key_frame_influence,linear_key_frame_influence_value, dynamic_key_frame_influence_values,type_of_strength_distribution, - linear_strength_value,dynamic_strength_values, soft_scaled_cn_weights_multiplier, - buffer, relative_cn_strength,relative_ipadapter_strength,ipadapter_noise, - ipadapter_start_at=0.0,ipadapter_end_at=0.75, cn_start_at=0.0, cn_end_at=0.75): + linear_strength_value,dynamic_strength_values, + buffer, high_detail_mode,ipa_weight): def get_keyframe_positions(type_of_frame_distribution, dynamic_frame_distribution_values, images, linear_frame_distribution_value): @@ -369,7 +355,6 @@ class BatchCreativeInterpolationNode: image = images[i-1] key_frame_influence_from,key_frame_influence_to = key_frame_influence_values[i-1] start_strength, mid_strength, end_strength = strength_values[i-1] - # strength_from, strength_to = cn_strength_values[i-1] keyframe_position = keyframe_positions[i] previous_key_frame_position = keyframe_positions[i-1] @@ -381,8 +366,10 @@ class BatchCreativeInterpolationNode: # interpolation = "ease-out" elif i == len(keyframe_positions) - 1: + image = images[i-2] strength_from = strength_to = strength_values[i-2][1] + batch_index_from = keyframe_positions[i-1] batch_index_to_excl = last_key_frame_position weights, frame_numbers = calculate_weights(batch_index_from, batch_index_to_excl, strength_from, strength_to, interpolation, False, last_key_frame_position, i, len(keyframe_positions), buffer) @@ -410,43 +397,32 @@ class BatchCreativeInterpolationNode: # COMBINE FIRST AND SECOND HALF weights = np.concatenate([first_half_weights, second_half_weights]) frame_numbers = np.concatenate([first_half_frame_numbers, second_half_frame_numbers]) - - # IMPORT REQUIRED NODES - latent_keyframe_interpolation_node = LatentKeyframeInterpolationNodeImport() - scaled_soft_control_net_weights = ScaledSoftUniversalWeightsImport() - timestep_keyframe_node = TimestepKeyframeNodeImport() - control_net_loader = ControlNetLoaderAdvancedImport() - apply_advanced_control_net = AdvancedControlNetApplyImport() - ipadapter_application = IPAdapterApplyImport() - ipadapter_encoder = IPAdapterEncoderImport() - - # IF CONTROL NET IS USED, APPLY IT - if relative_cn_strength > 0.0: - cn_frame_numbers, cn_weights = process_weights(frame_numbers, weights, relative_cn_strength) - latent_keyframe, = latent_keyframe_interpolation_node.load_keyframe(cn_weights, cn_frame_numbers) - control_net_weights, _ = scaled_soft_control_net_weights.load_weights(soft_scaled_cn_weights_multiplier, False) - timestep_keyframe = timestep_keyframe_node.load_keyframe(start_percent=0.0, control_net_weights=control_net_weights, latent_keyframe=latent_keyframe, prev_timestep_keyframe=None)[0] - control_net = control_net_loader.load_controlnet(control_net_name, timestep_keyframe)[0] - positive, negative = apply_advanced_control_net.apply_controlnet(positive, negative, control_net, image.unsqueeze(0), 1.0, cn_start_at, cn_end_at) - all_cn_frame_numbers.append(cn_frame_numbers) - all_cn_weights.append(cn_weights) + + # PROCESS WEIGHTS + ipa_frame_numbers, ipa_weights = process_weights(frame_numbers, weights, relative_ipadapter_strength) + + prepare_for_clip_vision = PrepImageForClipVisionImport() + prepped_image, = prepare_for_clip_vision.prep_image(image=image.unsqueeze(0), interpolation="LANCZOS", crop_position="pad", sharpening=0.1) + + prepped_image = prep_image(image=image.unsqueeze(0), interpolation="LANCZOS", crop_position="pad", sharpening=0.0)[0] + mask = create_mask_batch(last_key_frame_position, ipa_weights, ipa_frame_numbers) + + if high_detail_mode: + normal_ipa_start_at = 0.0 + normal_ipa_end_at = 0.25 else: - all_cn_frame_numbers = None - all_cn_weights = None - - # IF IP ADAPTER IS USED, APPLY IT - if relative_ipadapter_strength > 0.0: - ipa_frame_numbers, ipa_weights = process_weights(frame_numbers, weights, relative_ipadapter_strength) - prepped_image = prep_image(image=image.unsqueeze(0), interpolation="LANCZOS", crop_position="pad", sharpening=0.0)[0] - mask = create_mask_batch(last_key_frame_position, ipa_weights, ipa_frame_numbers) - embed, = ipadapter_encoder.preprocess(clip_vision, prepped_image, True, 0.0, 1.0) - model,_,_ = ipadapter_application.apply_ipadapter(ipadapter=ipadapter, model=model, weight=1.0, image=None, weight_type="original", - noise=ipadapter_noise, embeds=embed, attn_mask=mask, start_at=ipadapter_start_at, end_at=ipadapter_end_at, unfold_batch=True) - all_ipa_frame_numbers.append(ipa_frame_numbers) - all_ipa_weights.append(ipa_weights) - else: - all_ipa_frame_numbers = None - all_ipa_weights = None + normal_ipa_start_at = 0.0 + normal_ipa_end_at = 0.75 + + ipadapter_application = IPAdapterAdvancedImport() + model, = ipadapter_application.apply_ipadapter(model=model, ipadapter=ipadapter, image=prepped_image, weight=ipa_weight, weight_type='ease in-out', start_at=normal_ipa_start_at, end_at=normal_ipa_end_at, clip_vision=clip_vision, attn_mask=mask) + + if high_detail_mode: + tiled_ipa_application = IPAdapterTiledImport() + model, _ = ipadapter_application.apply_tiled(model=model, ipadapter=ipadapter, image=image.unsqueeze(0), weight=ipa_weight, weight_type='ease in-out', start_at=normal_ipa_start_at, end_at=normal_ipa_end_at, clip_vision=clip_vision, attn_mask=mask) + + all_ipa_frame_numbers.append(ipa_frame_numbers) + all_ipa_weights.append(ipa_weights) comparison_diagram, = plot_weight_comparison(all_cn_frame_numbers, all_cn_weights, all_ipa_frame_numbers, all_ipa_weights, buffer) diff --git a/imports/ComfyUI_IPAdapter_plus/.gitignore b/imports/ComfyUI_IPAdapter_plus/.gitignore new file mode 100644 index 0000000..b921ebf --- /dev/null +++ b/imports/ComfyUI_IPAdapter_plus/.gitignore @@ -0,0 +1,4 @@ +/__pycache__/ +/models/*.bin +/models/*.safetensors +.directory \ No newline at end of file diff --git a/imports/ComfyUI_IPAdapter_plus/CrossAttentionPatchImport.py b/imports/ComfyUI_IPAdapter_plus/CrossAttentionPatchImport.py new file mode 100644 index 0000000..195292d --- /dev/null +++ b/imports/ComfyUI_IPAdapter_plus/CrossAttentionPatchImport.py @@ -0,0 +1,167 @@ +import torch +import math +import torch.nn.functional as F +from comfy.ldm.modules.attention import optimized_attention +from .utils import tensor_to_size + +class CrossAttentionPatchImport: + # forward for patching + def __init__(self, ipadapter=None, number=0, weight=1.0, cond=None, uncond=None, weight_type="linear", mask=None, sigma_start=0.0, sigma_end=1.0, unfold_batch=False, embeds_scaling='V only'): + self.weights = [weight] + self.ipadapters = [ipadapter] + self.conds = [cond] + self.unconds = [uncond] + self.weight_types = [weight_type] + self.masks = [mask] + self.sigma_starts = [sigma_start] + self.sigma_ends = [sigma_end] + self.unfold_batch = [unfold_batch] + self.embeds_scaling = [embeds_scaling] + self.number = number + self.layers = 10 if '101_to_k_ip' in ipadapter.ip_layers.to_kvs else 15 # TODO: check if this is a valid condition to detect all models + + self.k_key = str(self.number*2+1) + "_to_k_ip" + self.v_key = str(self.number*2+1) + "_to_v_ip" + + def set_new_condition(self, ipadapter=None, number=0, weight=1.0, cond=None, uncond=None, weight_type="linear", mask=None, sigma_start=0.0, sigma_end=1.0, unfold_batch=False, embeds_scaling='V only'): + self.weights.append(weight) + self.ipadapters.append(ipadapter) + self.conds.append(cond) + self.unconds.append(uncond) + self.weight_types.append(weight_type) + self.masks.append(mask) + self.sigma_starts.append(sigma_start) + self.sigma_ends.append(sigma_end) + self.unfold_batch.append(unfold_batch) + self.embeds_scaling.append(embeds_scaling) + + def __call__(self, q, k, v, extra_options): + dtype = q.dtype + cond_or_uncond = extra_options["cond_or_uncond"] + sigma = extra_options["sigmas"].detach().cpu()[0].item() if 'sigmas' in extra_options else 999999999.9 + block_type = extra_options["block"][0] + #block_id = extra_options["block"][1] + t_idx = extra_options["transformer_index"] + + # extra options for AnimateDiff + ad_params = extra_options['ad_params'] if "ad_params" in extra_options else None + + b = q.shape[0] + seq_len = q.shape[1] + batch_prompt = b // len(cond_or_uncond) + out = optimized_attention(q, k, v, extra_options["n_heads"]) + _, _, oh, ow = extra_options["original_shape"] + + for weight, cond, uncond, ipadapter, mask, weight_type, sigma_start, sigma_end, unfold_batch, embeds_scaling in zip(self.weights, self.conds, self.unconds, self.ipadapters, self.masks, self.weight_types, self.sigma_starts, self.sigma_ends, self.unfold_batch, self.embeds_scaling): + if sigma <= sigma_start and sigma >= sigma_end: + if unfold_batch and cond.shape[0] > 1: + # Check AnimateDiff context window + if ad_params is not None and ad_params["sub_idxs"] is not None: + # if image length matches or exceeds full_length get sub_idx images + if cond.shape[0] >= ad_params["full_length"]: + cond = torch.Tensor(cond[ad_params["sub_idxs"]]) + uncond = torch.Tensor(uncond[ad_params["sub_idxs"]]) + # otherwise get sub_idxs images + else: + cond = tensor_to_size(cond, ad_params["full_length"]) + uncond = tensor_to_size(uncond, ad_params["full_length"]) + cond = cond[ad_params["sub_idxs"]] + uncond = uncond[ad_params["sub_idxs"]] + + cond = tensor_to_size(cond, batch_prompt) + uncond = tensor_to_size(uncond, batch_prompt) + + k_cond = ipadapter.ip_layers.to_kvs[self.k_key](cond) + k_uncond = ipadapter.ip_layers.to_kvs[self.k_key](uncond) + v_cond = ipadapter.ip_layers.to_kvs[self.v_key](cond) + v_uncond = ipadapter.ip_layers.to_kvs[self.v_key](uncond) + else: + k_cond = ipadapter.ip_layers.to_kvs[self.k_key](cond).repeat(batch_prompt, 1, 1) + k_uncond = ipadapter.ip_layers.to_kvs[self.k_key](uncond).repeat(batch_prompt, 1, 1) + v_cond = ipadapter.ip_layers.to_kvs[self.v_key](cond).repeat(batch_prompt, 1, 1) + v_uncond = ipadapter.ip_layers.to_kvs[self.v_key](uncond).repeat(batch_prompt, 1, 1) + + if weight_type == 'ease in': + weight = weight * (0.05 + 0.95 * (1 - t_idx / self.layers)) + elif weight_type == 'ease out': + weight = weight * (0.05 + 0.95 * (t_idx / self.layers)) + elif weight_type == 'ease in-out': + weight = weight * (0.05 + 0.95 * (1 - abs(t_idx - (self.layers/2)) / (self.layers/2))) + elif weight_type == 'reverse in-out': + weight = weight * (0.05 + 0.95 * (abs(t_idx - (self.layers/2)) / (self.layers/2))) + elif weight_type == 'weak input' and block_type == 'input': + weight = weight * 0.2 + elif weight_type == 'weak middle' and block_type == 'middle': + weight = weight * 0.2 + elif weight_type == 'weak output' and block_type == 'output': + weight = weight * 0.2 + elif weight_type == 'strong middle' and (block_type == 'input' or block_type == 'output'): + weight = weight * 0.2 + elif weight_type.startswith('style transfer'): + if t_idx != 6: + weight = 0.0 + + ip_k = torch.cat([(k_cond, k_uncond)[i] for i in cond_or_uncond], dim=0) + ip_v = torch.cat([(v_cond, v_uncond)[i] for i in cond_or_uncond], dim=0) + + if embeds_scaling == 'K+mean(V) w/ C penalty': + scaling = float(ip_k.shape[2]) / 1280.0 + weight = weight * scaling + ip_k = ip_k * weight + ip_v_mean = torch.mean(ip_v, dim=1, keepdim=True) + ip_v = (ip_v - ip_v_mean) + ip_v_mean * weight + out_ip = optimized_attention(q, ip_k, ip_v, extra_options["n_heads"]) + del ip_v_mean + elif embeds_scaling == 'K+V w/ C penalty': + scaling = float(ip_k.shape[2]) / 1280.0 + weight = weight * scaling + ip_k = ip_k * weight + ip_v = ip_v * weight + out_ip = optimized_attention(q, ip_k, ip_v, extra_options["n_heads"]) + elif embeds_scaling == 'K+V': + ip_k = ip_k * weight + ip_v = ip_v * weight + out_ip = optimized_attention(q, ip_k, ip_v, extra_options["n_heads"]) + else: + #ip_v = ip_v * weight + out_ip = optimized_attention(q, ip_k, ip_v, extra_options["n_heads"]) + out_ip = out_ip * weight # I'm doing this to get the same results as before + + if mask is not None: + mask_h = oh / math.sqrt(oh * ow / seq_len) + mask_h = int(mask_h) + int((seq_len % int(mask_h)) != 0) + mask_w = seq_len // mask_h + + # check if using AnimateDiff and sliding context window + if (mask.shape[0] > 1 and ad_params is not None and ad_params["sub_idxs"] is not None): + # if mask length matches or exceeds full_length, get sub_idx masks + if mask.shape[0] >= ad_params["full_length"]: + mask = torch.Tensor(mask[ad_params["sub_idxs"]]) + mask = F.interpolate(mask.unsqueeze(1), size=(mask_h, mask_w), mode="bilinear").squeeze(1) + else: + mask = F.interpolate(mask.unsqueeze(1), size=(mask_h, mask_w), mode="bilinear").squeeze(1) + mask = tensor_to_size(mask, ad_params["full_length"]) + mask = mask[ad_params["sub_idxs"]] + else: + mask = F.interpolate(mask.unsqueeze(1), size=(mask_h, mask_w), mode="bilinear").squeeze(1) + mask = tensor_to_size(mask, batch_prompt) + + mask = mask.repeat(len(cond_or_uncond), 1, 1) + mask = mask.view(mask.shape[0], -1, 1).repeat(1, 1, out.shape[2]) + + # covers cases where extreme aspect ratios can cause the mask to have a wrong size + mask_len = mask_h * mask_w + if mask_len < seq_len: + pad_len = seq_len - mask_len + pad1 = pad_len // 2 + pad2 = pad_len - pad1 + mask = F.pad(mask, (0, 0, pad1, pad2), value=0.0) + elif mask_len > seq_len: + crop_start = (mask_len - seq_len) // 2 + mask = mask[:, crop_start:crop_start+seq_len, :] + + out_ip = out_ip * mask + + out = out + out_ip + + return out.to(dtype=dtype) diff --git a/imports/ComfyUI_IPAdapter_plus/IPAdapterPlus.py b/imports/ComfyUI_IPAdapter_plus/IPAdapterPlus.py new file mode 100644 index 0000000..b72b9d5 --- /dev/null +++ b/imports/ComfyUI_IPAdapter_plus/IPAdapterPlus.py @@ -0,0 +1,605 @@ +import torch +import os +import math +import folder_paths + +import comfy.model_management as model_management +from comfy.clip_vision import load as load_clip_vision +from comfy.sd import load_lora_for_models +import comfy.utils + +import torch.nn as nn +from PIL import Image +try: + import torchvision.transforms.v2 as T +except ImportError: + import torchvision.transforms as T + +from .image_proj_models import MLPProjModelImport, MLPProjModelFaceIdImport, ProjModelFaceIdPlusImport, ResamplerImport, ImageProjModelImport +from .CrossAttentionPatchImport import CrossAttentionPatchImport +from .utils import ( + encode_image_masked, + tensor_to_size, + contrast_adaptive_sharpening, + tensor_to_image, + image_to_tensor, + ipadapter_model_loader, + insightface_loader, + get_clipvision_file, + get_ipadapter_file, + get_lora_file, +) + +# set the models directory +if "ipadapter" not in folder_paths.folder_names_and_paths: + current_paths = [os.path.join(folder_paths.models_dir, "ipadapter")] +else: + current_paths, _ = folder_paths.folder_names_and_paths["ipadapter"] +folder_paths.folder_names_and_paths["ipadapter"] = (current_paths, folder_paths.supported_pt_extensions) + +WEIGHT_TYPES = ["linear", "ease in", "ease out", 'ease in-out', 'reverse in-out', 'weak input', 'weak output', 'weak middle', 'strong middle', 'style transfer (SDXL)'] + +""" +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + Main IPAdapter Class +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +""" +class IPAdapterImport(nn.Module): + def __init__(self, ipadapter_model, cross_attention_dim=1024, output_cross_attention_dim=1024, clip_embeddings_dim=1024, clip_extra_context_tokens=4, is_sdxl=False, is_plus=False, is_full=False, is_faceid=False): + super().__init__() + + self.clip_embeddings_dim = clip_embeddings_dim + self.cross_attention_dim = cross_attention_dim + self.output_cross_attention_dim = output_cross_attention_dim + self.clip_extra_context_tokens = clip_extra_context_tokens + self.is_sdxl = is_sdxl + self.is_full = is_full + self.is_plus = is_plus + + if is_faceid: + self.image_proj_model = self.init_proj_faceid() + elif is_full: + self.image_proj_model = self.init_proj_full() + elif is_plus: + self.image_proj_model = self.init_proj_plus() + else: + self.image_proj_model = self.init_proj() + + self.image_proj_model.load_state_dict(ipadapter_model["image_proj"]) + self.ip_layers = To_KV(ipadapter_model["ip_adapter"]) + + def init_proj(self): + image_proj_model = ImageProjModelImport( + cross_attention_dim=self.cross_attention_dim, + clip_embeddings_dim=self.clip_embeddings_dim, + clip_extra_context_tokens=self.clip_extra_context_tokens + ) + return image_proj_model + + def init_proj_plus(self): + image_proj_model = ResamplerImport( + dim=self.cross_attention_dim, + depth=4, + dim_head=64, + heads=20 if self.is_sdxl else 12, + num_queries=self.clip_extra_context_tokens, + embedding_dim=self.clip_embeddings_dim, + output_dim=self.output_cross_attention_dim, + ff_mult=4 + ) + return image_proj_model + + def init_proj_full(self): + image_proj_model = MLPProjModelImport( + cross_attention_dim=self.cross_attention_dim, + clip_embeddings_dim=self.clip_embeddings_dim + ) + return image_proj_model + + def init_proj_faceid(self): + if self.is_plus: + image_proj_model = ProjModelFaceIdPlusImport( + cross_attention_dim=self.cross_attention_dim, + id_embeddings_dim=512, + clip_embeddings_dim=self.clip_embeddings_dim, # 1280, + num_tokens=self.clip_extra_context_tokens, # 4, + ) + else: + image_proj_model = MLPProjModelFaceIdImport( + cross_attention_dim=self.cross_attention_dim, + id_embeddings_dim=512, + num_tokens=self.clip_extra_context_tokens, + ) + return image_proj_model + + @torch.inference_mode() + def get_image_embeds(self, clip_embed, clip_embed_zeroed): + image_prompt_embeds = self.image_proj_model(clip_embed) + uncond_image_prompt_embeds = self.image_proj_model(clip_embed_zeroed) + return image_prompt_embeds, uncond_image_prompt_embeds + + @torch.inference_mode() + def get_image_embeds_faceid_plus(self, face_embed, clip_embed, s_scale, shortcut): + embeds = self.image_proj_model(face_embed, clip_embed, scale=s_scale, shortcut=shortcut) + return embeds + +class To_KV(nn.Module): + def __init__(self, state_dict): + super().__init__() + + self.to_kvs = nn.ModuleDict() + for key, value in state_dict.items(): + self.to_kvs[key.replace(".weight", "").replace(".", "_")] = nn.Linear(value.shape[1], value.shape[0], bias=False) + self.to_kvs[key.replace(".weight", "").replace(".", "_")].weight.data = value + +def set_model_patch_replace(model, patch_kwargs, key): + to = model.model_options["transformer_options"] + if "patches_replace" not in to: + to["patches_replace"] = {} + if "attn2" not in to["patches_replace"]: + to["patches_replace"]["attn2"] = {} + if key not in to["patches_replace"]["attn2"]: + to["patches_replace"]["attn2"][key] = CrossAttentionPatchImport(**patch_kwargs) + else: + to["patches_replace"]["attn2"][key].set_new_condition(**patch_kwargs) + +def ipadapter_execute(model, + ipadapter, + clipvision, + insightface=None, + image=None, + image_negative=None, + weight=1.0, + weight_faceidv2=None, + weight_type="linear", + combine_embeds="concat", + start_at=0.0, + end_at=1.0, + attn_mask=None, + pos_embed=None, + neg_embed=None, + unfold_batch=False, + embeds_scaling='V only'): + dtype = torch.float16 if model_management.should_use_fp16() else torch.bfloat16 if model_management.should_use_bf16() else torch.float32 + device = model_management.get_torch_device() + + is_full = "proj.3.weight" in ipadapter["image_proj"] + is_portrait = "proj.2.weight" in ipadapter["image_proj"] and not "proj.3.weight" in ipadapter["image_proj"] and not "0.to_q_lora.down.weight" in ipadapter["ip_adapter"] + is_faceid = is_portrait or "0.to_q_lora.down.weight" in ipadapter["ip_adapter"] + is_plus = is_full or "latents" in ipadapter["image_proj"] or "perceiver_resampler.proj_in.weight" in ipadapter["image_proj"] + is_faceidv2 = "faceidplusv2" in ipadapter + output_cross_attention_dim = ipadapter["ip_adapter"]["1.to_k_ip.weight"].shape[1] + is_sdxl = output_cross_attention_dim == 2048 + + if weight_type == "style transfer (SDXL)" and not is_sdxl: + weight_type = "linear" + print("\033[33mINFO: 'Style Transfer' weight type is only available for SDXL models, falling back to 'linear'.\033[0m") + + if is_faceid and not insightface: + raise Exception("insightface model is required for FaceID models") + + if is_faceidv2: + weight_faceidv2 = weight_faceidv2 if weight_faceidv2 is not None else weight*2 + + cross_attention_dim = 1280 if is_plus and is_sdxl and not is_faceid else output_cross_attention_dim + clip_extra_context_tokens = 16 if (is_plus and not is_faceid) or is_portrait else 4 + + if image is not None and image.shape[1] != image.shape[2]: + print("\033[33mINFO: the IPAdapter reference image is not a square, CLIPImageProcessor will resize and crop it at the center. If the main focus of the picture is not in the middle the result might not be what you are expecting.\033[0m") + + face_cond_embeds = None + if is_faceid: + if insightface is None: + raise Exception("Insightface model is required for FaceID models") + + from insightface.utils import face_align + + insightface.det_model.input_size = (640,640) # reset the detection size + image_iface = tensor_to_image(image) + face_cond_embeds = [] + image = [] + + for i in range(image_iface.shape[0]): + for size in [(size, size) for size in range(640, 256, -64)]: + insightface.det_model.input_size = size # TODO: hacky but seems to be working + face = insightface.get(image_iface[i]) + if face: + face_cond_embeds.append(torch.from_numpy(face[0].normed_embedding).unsqueeze(0)) + image.append(image_to_tensor(face_align.norm_crop(image_iface[i], landmark=face[0].kps, image_size=256))) + + if 640 not in size: + print(f"\033[33mINFO: InsightFace detection resolution lowered to {size}.\033[0m") + break + else: + raise Exception('InsightFace: No face detected.') + face_cond_embeds = torch.stack(face_cond_embeds).to(device, dtype=dtype) + image = torch.stack(image) + del image_iface, face + + if image is not None: + img_cond_embeds = encode_image_masked(clipvision, image) + + if is_plus: + img_cond_embeds = img_cond_embeds.penultimate_hidden_states + image_negative = image_negative if image_negative is not None else torch.zeros([1, 224, 224, 3]) + img_uncond_embeds = encode_image_masked(clipvision, image_negative).penultimate_hidden_states + else: + img_cond_embeds = img_cond_embeds.image_embeds if not is_faceid else face_cond_embeds + if image_negative is not None: + img_uncond_embeds = encode_image_masked(clipvision, image_negative).image_embeds + else: + img_uncond_embeds = torch.zeros_like(img_cond_embeds) + elif pos_embed is not None: + img_cond_embeds = pos_embed + + if neg_embed is not None: + img_uncond_embeds = neg_embed + else: + if is_plus: + img_uncond_embeds = encode_image_masked(clipvision, torch.zeros([1, 224, 224, 3])).penultimate_hidden_states + else: + img_uncond_embeds = torch.zeros_like(img_cond_embeds) + else: + raise Exception("Images or Embeds are required") + + # ensure that cond and uncond have the same batch size + img_uncond_embeds = tensor_to_size(img_uncond_embeds, img_cond_embeds.shape[0]) + + img_cond_embeds = img_cond_embeds.to(device, dtype=dtype) + img_uncond_embeds = img_uncond_embeds.to(device, dtype=dtype) + + # combine the embeddings if needed + if combine_embeds != "concat" and img_cond_embeds.shape[0] > 1 and not unfold_batch: + if combine_embeds == "add": + img_cond_embeds = torch.sum(img_cond_embeds, dim=0).unsqueeze(0) + if face_cond_embeds is not None: + face_cond_embeds = torch.sum(face_cond_embeds, dim=0).unsqueeze(0) + elif combine_embeds == "subtract": + img_cond_embeds = img_cond_embeds[0] - torch.mean(img_cond_embeds[1:], dim=0) + img_cond_embeds = img_cond_embeds.unsqueeze(0) + if face_cond_embeds is not None: + face_cond_embeds = face_cond_embeds[0] - torch.mean(face_cond_embeds[1:], dim=0) + face_cond_embeds = face_cond_embeds.unsqueeze(0) + elif combine_embeds == "average": + img_cond_embeds = torch.mean(img_cond_embeds, dim=0).unsqueeze(0) + if face_cond_embeds is not None: + face_cond_embeds = torch.mean(face_cond_embeds, dim=0).unsqueeze(0) + elif combine_embeds == "norm average": + img_cond_embeds = torch.mean(img_cond_embeds / torch.norm(img_cond_embeds, dim=0, keepdim=True), dim=0).unsqueeze(0) + if face_cond_embeds is not None: + face_cond_embeds = torch.mean(face_cond_embeds / torch.norm(face_cond_embeds, dim=0, keepdim=True), dim=0).unsqueeze(0) + img_uncond_embeds = img_uncond_embeds[0].unsqueeze(0) # TODO: better strategy for uncond could be to average them + + if attn_mask is not None: + attn_mask = attn_mask.to(device, dtype=dtype) + + ipa = IPAdapterImport( + ipadapter, + cross_attention_dim=cross_attention_dim, + output_cross_attention_dim=output_cross_attention_dim, + clip_embeddings_dim=img_cond_embeds.shape[-1], + clip_extra_context_tokens=clip_extra_context_tokens, + is_sdxl=is_sdxl, + is_plus=is_plus, + is_full=is_full, + is_faceid=is_faceid + ).to(device, dtype=dtype) + + if is_faceid and is_plus: + cond = ipa.get_image_embeds_faceid_plus(face_cond_embeds, img_cond_embeds, weight_faceidv2, is_faceidv2) + # TODO: check if noise helps with the uncod face embeds + uncod = ipa.get_image_embeds_faceid_plus(torch.zeros_like(face_cond_embeds), img_uncond_embeds, weight_faceidv2, is_faceidv2) + else: + cond, uncod = ipa.get_image_embeds(img_cond_embeds, img_uncond_embeds) + + cond = cond.to(device, dtype=dtype) + uncod = uncod.to(device, dtype=dtype) + + del img_cond_embeds, img_uncond_embeds + + sigma_start = model.model.model_sampling.percent_to_sigma(start_at) + sigma_end = model.model.model_sampling.percent_to_sigma(end_at) + + patch_kwargs = { + "ipadapter": ipa, + "number": 0, + "weight": weight, + "cond": cond, + "uncond": uncod, + "weight_type": weight_type, + "mask": attn_mask, + "sigma_start": sigma_start, + "sigma_end": sigma_end, + "unfold_batch": unfold_batch, + "embeds_scaling": embeds_scaling, + } + + if not is_sdxl: + for id in [1,2,4,5,7,8]: # id of input_blocks that have cross attention + set_model_patch_replace(model, patch_kwargs, ("input", id)) + patch_kwargs["number"] += 1 + for id in [3,4,5,6,7,8,9,10,11]: # id of output_blocks that have cross attention + set_model_patch_replace(model, patch_kwargs, ("output", id)) + patch_kwargs["number"] += 1 + set_model_patch_replace(model, patch_kwargs, ("middle", 0)) + else: + for id in [4,5,7,8]: # id of input_blocks that have cross attention + block_indices = range(2) if id in [4, 5] else range(10) # transformer_depth + for index in block_indices: + set_model_patch_replace(model, patch_kwargs, ("input", id, index)) + patch_kwargs["number"] += 1 + for id in range(6): # id of output_blocks that have cross attention + block_indices = range(2) if id in [3, 4, 5] else range(10) # transformer_depth + for index in block_indices: + set_model_patch_replace(model, patch_kwargs, ("output", id, index)) + patch_kwargs["number"] += 1 + for index in range(10): + set_model_patch_replace(model, patch_kwargs, ("middle", 0, index)) + patch_kwargs["number"] += 1 + + return model + + +class IPAdapterAdvancedImport: + def __init__(self): + self.unfold_batch = False + + @classmethod + def INPUT_TYPES(s): + return { + "required": { + "model": ("MODEL", ), + "ipadapter": ("IPADAPTER", ), + "image": ("IMAGE",), + "weight": ("FLOAT", { "default": 1.0, "min": -1, "max": 3, "step": 0.05 }), + "weight_type": (WEIGHT_TYPES, ), + "combine_embeds": (["concat", "add", "subtract", "average", "norm average"],), + "start_at": ("FLOAT", { "default": 0.0, "min": 0.0, "max": 1.0, "step": 0.001 }), + "end_at": ("FLOAT", { "default": 1.0, "min": 0.0, "max": 1.0, "step": 0.001 }), + "embeds_scaling": (['V only', 'K+V', 'K+V w/ C penalty', 'K+mean(V) w/ C penalty'], ), + }, + "optional": { + "image_negative": ("IMAGE",), + "attn_mask": ("MASK",), + "clip_vision": ("CLIP_VISION",), + } + } + + RETURN_TYPES = ("MODEL",) + FUNCTION = "apply_ipadapter" + CATEGORY = "ipadapter" + + def apply_ipadapter(self, model, ipadapter, image, weight, weight_type, start_at, end_at, combine_embeds="concat", weight_faceidv2=None, image_negative=None, clip_vision=None, attn_mask=None, insightface=None, embeds_scaling='V only'): + ipa_args = { + "image": image, + "image_negative": image_negative, + "weight": weight, + "weight_faceidv2": weight_faceidv2, + "weight_type": weight_type, + "combine_embeds": combine_embeds, + "start_at": start_at, + "end_at": end_at, + "attn_mask": attn_mask, + "unfold_batch": self.unfold_batch, + "embeds_scaling": embeds_scaling, + "insightface": insightface if insightface is not None else ipadapter['insightface']['model'] if 'insightface' in ipadapter else None + } + + if 'ipadapter' in ipadapter: + ipadapter_model = ipadapter['ipadapter']['model'] + clip_vision = clip_vision if clip_vision is not None else ipadapter['clipvision']['model'] + else: + ipadapter_model = ipadapter + clip_vision = clip_vision + + if clip_vision is None: + raise Exception("Missing CLIPVision model.") + + del ipadapter + + return (ipadapter_execute(model.clone(), ipadapter_model, clip_vision, **ipa_args), ) + + + + +class IPAdapterTiledImport: + def __init__(self): + self.unfold_batch = False + + @classmethod + def INPUT_TYPES(s): + return { + "required": { + "model": ("MODEL", ), + "ipadapter": ("IPADAPTER", ), + "image": ("IMAGE",), + "weight": ("FLOAT", { "default": 1.0, "min": -1, "max": 3, "step": 0.05 }), + "weight_type": (WEIGHT_TYPES, ), + "combine_embeds": (["concat", "add", "subtract", "average", "norm average"],), + "start_at": ("FLOAT", { "default": 0.0, "min": 0.0, "max": 1.0, "step": 0.001 }), + "end_at": ("FLOAT", { "default": 1.0, "min": 0.0, "max": 1.0, "step": 0.001 }), + "sharpening": ("FLOAT", { "default": 0.0, "min": 0.0, "max": 1.0, "step": 0.05 }), + "embeds_scaling": (['V only', 'K+V', 'K+V w/ C penalty', 'K+mean(V) w/ C penalty'], ), + }, + "optional": { + "image_negative": ("IMAGE",), + "attn_mask": ("MASK",), + "clip_vision": ("CLIP_VISION",), + } + } + + RETURN_TYPES = ("MODEL", "IMAGE", "MASK", ) + RETURN_NAMES = ("MODEL", "tiles", "masks", ) + FUNCTION = "apply_tiled" + CATEGORY = "ipadapter" + + def apply_tiled(self, model, ipadapter, image, weight, weight_type, start_at, end_at, sharpening, combine_embeds="concat", image_negative=None, attn_mask=None, clip_vision=None, embeds_scaling='V only'): + # 1. Select the models + if 'ipadapter' in ipadapter: + ipadapter_model = ipadapter['ipadapter']['model'] + clip_vision = clip_vision if clip_vision is not None else ipadapter['clipvision']['model'] + else: + ipadapter_model = ipadapter + clip_vision = clip_vision + + if clip_vision is None: + raise Exception("Missing CLIPVision model.") + + del ipadapter + + # 2. Extract the tiles + tile_size = 256 # I'm using 256 instead of 224 as it is more likely divisible by the latent size, it will be downscaled to 224 by the clip vision encoder + _, oh, ow, _ = image.shape + if attn_mask is None: + attn_mask = torch.ones([1, oh, ow], dtype=image.dtype, device=image.device) + + image = image.permute([0,3,1,2]) + attn_mask = attn_mask.unsqueeze(1) + # the mask should have the same proportions as the reference image and the latent + attn_mask = T.Resize((oh, ow), interpolation=T.InterpolationMode.BICUBIC, antialias=True)(attn_mask) + + # if the image is almost a square, we crop it to a square + if oh / ow > 0.75 and oh / ow < 1.33: + # crop the image to a square + image = T.CenterCrop(min(oh, ow))(image) + resize = (tile_size*2, tile_size*2) + + attn_mask = T.CenterCrop(min(oh, ow))(attn_mask) + # otherwise resize the smallest side and the other proportionally + else: + resize = (int(tile_size * ow / oh), tile_size) if oh < ow else (tile_size, int(tile_size * oh / ow)) + + # using PIL for better results + imgs = [] + for img in image: + img = T.ToPILImage()(img) + img = img.resize(resize, resample=Image.Resampling['LANCZOS']) + imgs.append(T.ToTensor()(img)) + image = torch.stack(imgs) + del imgs, img + + # we don't need a high quality resize for the mask + attn_mask = T.Resize(resize[::-1], interpolation=T.InterpolationMode.BICUBIC, antialias=True)(attn_mask) + + # we allow a maximum of 4 tiles + if oh / ow > 4 or oh / ow < 0.25: + crop = (tile_size, tile_size*4) if oh < ow else (tile_size*4, tile_size) + image = T.CenterCrop(crop)(image) + attn_mask = T.CenterCrop(crop)(attn_mask) + + attn_mask = attn_mask.squeeze(1) + + if sharpening > 0: + image = contrast_adaptive_sharpening(image, sharpening) + + image = image.permute([0,2,3,1]) + + _, oh, ow, _ = image.shape + + # find the number of tiles for each side + tiles_x = math.ceil(ow / tile_size) + tiles_y = math.ceil(oh / tile_size) + overlap_x = max(0, (tiles_x * tile_size - ow) / (tiles_x - 1 if tiles_x > 1 else 1)) + overlap_y = max(0, (tiles_y * tile_size - oh) / (tiles_y - 1 if tiles_y > 1 else 1)) + + base_mask = torch.zeros([attn_mask.shape[0], oh, ow], dtype=image.dtype, device=image.device) + + # extract all the tiles from the image and create the masks + tiles = [] + masks = [] + for y in range(tiles_y): + for x in range(tiles_x): + start_x = int(x * (tile_size - overlap_x)) + start_y = int(y * (tile_size - overlap_y)) + tiles.append(image[:, start_y:start_y+tile_size, start_x:start_x+tile_size, :]) + mask = base_mask.clone() + mask[:, start_y:start_y+tile_size, start_x:start_x+tile_size] = attn_mask[:, start_y:start_y+tile_size, start_x:start_x+tile_size] + masks.append(mask) + del mask + + # 3. Apply the ipadapter to each group of tiles + model = model.clone() + for i in range(len(tiles)): + ipa_args = { + "image": tiles[i], + "image_negative": image_negative, + "weight": weight, + "weight_type": weight_type, + "combine_embeds": combine_embeds, + "start_at": start_at, + "end_at": end_at, + "attn_mask": masks[i], + "unfold_batch": self.unfold_batch, + "embeds_scaling": embeds_scaling, + } + # apply the ipadapter to the model without cloning it + model = ipadapter_execute(model, ipadapter_model, clip_vision, **ipa_args) + + return (model, torch.cat(tiles), torch.cat(masks), ) + + + +class PrepImageForClipVisionImport: + @classmethod + def INPUT_TYPES(s): + return {"required": { + "image": ("IMAGE",), + "interpolation": (["LANCZOS", "BICUBIC", "HAMMING", "BILINEAR", "BOX", "NEAREST"],), + "crop_position": (["top", "bottom", "left", "right", "center", "pad"],), + "sharpening": ("FLOAT", {"default": 0.0, "min": 0, "max": 1, "step": 0.05}), + }, + } + + RETURN_TYPES = ("IMAGE",) + FUNCTION = "prep_image" + + CATEGORY = "ipadapter" + + def prep_image(self, image, interpolation="LANCZOS", crop_position="center", sharpening=0.0): + size = (224, 224) + _, oh, ow, _ = image.shape + output = image.permute([0,3,1,2]) + + if crop_position == "pad": + if oh != ow: + if oh > ow: + pad = (oh - ow) // 2 + pad = (pad, 0, pad, 0) + elif ow > oh: + pad = (ow - oh) // 2 + pad = (0, pad, 0, pad) + output = T.functional.pad(output, pad, fill=0) + else: + crop_size = min(oh, ow) + x = (ow-crop_size) // 2 + y = (oh-crop_size) // 2 + if "top" in crop_position: + y = 0 + elif "bottom" in crop_position: + y = oh-crop_size + elif "left" in crop_position: + x = 0 + elif "right" in crop_position: + x = ow-crop_size + + x2 = x+crop_size + y2 = y+crop_size + + output = output[:, :, y:y2, x:x2] + + imgs = [] + for img in output: + img = T.ToPILImage()(img) # using PIL for better results + img = img.resize(size, resample=Image.Resampling[interpolation]) + imgs.append(T.ToTensor()(img)) + output = torch.stack(imgs, dim=0) + del imgs, img + + if sharpening > 0: + output = contrast_adaptive_sharpening(output, sharpening) + + output = output.permute([0,2,3,1]) + + return (output, ) + + diff --git a/imports/ComfyUI_IPAdapter_plus/LICENSE b/imports/ComfyUI_IPAdapter_plus/LICENSE new file mode 100644 index 0000000..f288702 --- /dev/null +++ b/imports/ComfyUI_IPAdapter_plus/LICENSE @@ -0,0 +1,674 @@ + GNU GENERAL PUBLIC LICENSE + Version 3, 29 June 2007 + + Copyright (C) 2007 Free Software Foundation, Inc. + Everyone is permitted to copy and distribute verbatim copies + of this license document, but changing it is not allowed. + + Preamble + + The GNU General Public License is a free, copyleft license for +software and other kinds of works. + + The licenses for most software and other practical works are designed +to take away your freedom to share and change the works. By contrast, +the GNU General Public License is intended to guarantee your freedom to +share and change all versions of a program--to make sure it remains free +software for all its users. We, the Free Software Foundation, use the +GNU General Public License for most of our software; it applies also to +any other work released this way by its authors. You can apply it to +your programs, too. + + When we speak of free software, we are referring to freedom, not +price. Our General Public Licenses are designed to make sure that you +have the freedom to distribute copies of free software (and charge for +them if you wish), that you receive source code or can get it if you +want it, that you can change the software or use pieces of it in new +free programs, and that you know you can do these things. + + To protect your rights, we need to prevent others from denying you +these rights or asking you to surrender the rights. Therefore, you have +certain responsibilities if you distribute copies of the software, or if +you modify it: responsibilities to respect the freedom of others. + + For example, if you distribute copies of such a program, whether +gratis or for a fee, you must pass on to the recipients the same +freedoms that you received. You must make sure that they, too, receive +or can get the source code. And you must show them these terms so they +know their rights. + + Developers that use the GNU GPL protect your rights with two steps: +(1) assert copyright on the software, and (2) offer you this License +giving you legal permission to copy, distribute and/or modify it. + + For the developers' and authors' protection, the GPL clearly explains +that there is no warranty for this free software. For both users' and +authors' sake, the GPL requires that modified versions be marked as +changed, so that their problems will not be attributed erroneously to +authors of previous versions. + + Some devices are designed to deny users access to install or run +modified versions of the software inside them, although the manufacturer +can do so. This is fundamentally incompatible with the aim of +protecting users' freedom to change the software. The systematic +pattern of such abuse occurs in the area of products for individuals to +use, which is precisely where it is most unacceptable. Therefore, we +have designed this version of the GPL to prohibit the practice for those +products. If such problems arise substantially in other domains, we +stand ready to extend this provision to those domains in future versions +of the GPL, as needed to protect the freedom of users. + + Finally, every program is threatened constantly by software patents. +States should not allow patents to restrict development and use of +software on general-purpose computers, but in those that do, we wish to +avoid the special danger that patents applied to a free program could +make it effectively proprietary. To prevent this, the GPL assures that +patents cannot be used to render the program non-free. + + The precise terms and conditions for copying, distribution and +modification follow. + + TERMS AND CONDITIONS + + 0. Definitions. + + "This License" refers to version 3 of the GNU General Public License. + + "Copyright" also means copyright-like laws that apply to other kinds of +works, such as semiconductor masks. + + "The Program" refers to any copyrightable work licensed under this +License. Each licensee is addressed as "you". "Licensees" and +"recipients" may be individuals or organizations. + + To "modify" a work means to copy from or adapt all or part of the work +in a fashion requiring copyright permission, other than the making of an +exact copy. The resulting work is called a "modified version" of the +earlier work or a work "based on" the earlier work. + + A "covered work" means either the unmodified Program or a work based +on the Program. + + To "propagate" a work means to do anything with it that, without +permission, would make you directly or secondarily liable for +infringement under applicable copyright law, except executing it on a +computer or modifying a private copy. Propagation includes copying, +distribution (with or without modification), making available to the +public, and in some countries other activities as well. + + To "convey" a work means any kind of propagation that enables other +parties to make or receive copies. Mere interaction with a user through +a computer network, with no transfer of a copy, is not conveying. + + An interactive user interface displays "Appropriate Legal Notices" +to the extent that it includes a convenient and prominently visible +feature that (1) displays an appropriate copyright notice, and (2) +tells the user that there is no warranty for the work (except to the +extent that warranties are provided), that licensees may convey the +work under this License, and how to view a copy of this License. If +the interface presents a list of user commands or options, such as a +menu, a prominent item in the list meets this criterion. + + 1. Source Code. + + The "source code" for a work means the preferred form of the work +for making modifications to it. "Object code" means any non-source +form of a work. + + A "Standard Interface" means an interface that either is an official +standard defined by a recognized standards body, or, in the case of +interfaces specified for a particular programming language, one that +is widely used among developers working in that language. + + The "System Libraries" of an executable work include anything, other +than the work as a whole, that (a) is included in the normal form of +packaging a Major Component, but which is not part of that Major +Component, and (b) serves only to enable use of the work with that +Major Component, or to implement a Standard Interface for which an +implementation is available to the public in source code form. A +"Major Component", in this context, means a major essential component +(kernel, window system, and so on) of the specific operating system +(if any) on which the executable work runs, or a compiler used to +produce the work, or an object code interpreter used to run it. + + The "Corresponding Source" for a work in object code form means all +the source code needed to generate, install, and (for an executable +work) run the object code and to modify the work, including scripts to +control those activities. However, it does not include the work's +System Libraries, or general-purpose tools or generally available free +programs which are used unmodified in performing those activities but +which are not part of the work. For example, Corresponding Source +includes interface definition files associated with source files for +the work, and the source code for shared libraries and dynamically +linked subprograms that the work is specifically designed to require, +such as by intimate data communication or control flow between those +subprograms and other parts of the work. + + The Corresponding Source need not include anything that users +can regenerate automatically from other parts of the Corresponding +Source. + + The Corresponding Source for a work in source code form is that +same work. + + 2. Basic Permissions. + + All rights granted under this License are granted for the term of +copyright on the Program, and are irrevocable provided the stated +conditions are met. This License explicitly affirms your unlimited +permission to run the unmodified Program. The output from running a +covered work is covered by this License only if the output, given its +content, constitutes a covered work. This License acknowledges your +rights of fair use or other equivalent, as provided by copyright law. + + You may make, run and propagate covered works that you do not +convey, without conditions so long as your license otherwise remains +in force. You may convey covered works to others for the sole purpose +of having them make modifications exclusively for you, or provide you +with facilities for running those works, provided that you comply with +the terms of this License in conveying all material for which you do +not control copyright. Those thus making or running the covered works +for you must do so exclusively on your behalf, under your direction +and control, on terms that prohibit them from making any copies of +your copyrighted material outside their relationship with you. + + Conveying under any other circumstances is permitted solely under +the conditions stated below. Sublicensing is not allowed; section 10 +makes it unnecessary. + + 3. Protecting Users' Legal Rights From Anti-Circumvention Law. + + No covered work shall be deemed part of an effective technological +measure under any applicable law fulfilling obligations under article +11 of the WIPO copyright treaty adopted on 20 December 1996, or +similar laws prohibiting or restricting circumvention of such +measures. + + When you convey a covered work, you waive any legal power to forbid +circumvention of technological measures to the extent such circumvention +is effected by exercising rights under this License with respect to +the covered work, and you disclaim any intention to limit operation or +modification of the work as a means of enforcing, against the work's +users, your or third parties' legal rights to forbid circumvention of +technological measures. + + 4. Conveying Verbatim Copies. + + You may convey verbatim copies of the Program's source code as you +receive it, in any medium, provided that you conspicuously and +appropriately publish on each copy an appropriate copyright notice; +keep intact all notices stating that this License and any +non-permissive terms added in accord with section 7 apply to the code; +keep intact all notices of the absence of any warranty; and give all +recipients a copy of this License along with the Program. + + You may charge any price or no price for each copy that you convey, +and you may offer support or warranty protection for a fee. + + 5. Conveying Modified Source Versions. + + You may convey a work based on the Program, or the modifications to +produce it from the Program, in the form of source code under the +terms of section 4, provided that you also meet all of these conditions: + + a) The work must carry prominent notices stating that you modified + it, and giving a relevant date. + + b) The work must carry prominent notices stating that it is + released under this License and any conditions added under section + 7. This requirement modifies the requirement in section 4 to + "keep intact all notices". + + c) You must license the entire work, as a whole, under this + License to anyone who comes into possession of a copy. This + License will therefore apply, along with any applicable section 7 + additional terms, to the whole of the work, and all its parts, + regardless of how they are packaged. This License gives no + permission to license the work in any other way, but it does not + invalidate such permission if you have separately received it. + + d) If the work has interactive user interfaces, each must display + Appropriate Legal Notices; however, if the Program has interactive + interfaces that do not display Appropriate Legal Notices, your + work need not make them do so. + + A compilation of a covered work with other separate and independent +works, which are not by their nature extensions of the covered work, +and which are not combined with it such as to form a larger program, +in or on a volume of a storage or distribution medium, is called an +"aggregate" if the compilation and its resulting copyright are not +used to limit the access or legal rights of the compilation's users +beyond what the individual works permit. Inclusion of a covered work +in an aggregate does not cause this License to apply to the other +parts of the aggregate. + + 6. Conveying Non-Source Forms. + + You may convey a covered work in object code form under the terms +of sections 4 and 5, provided that you also convey the +machine-readable Corresponding Source under the terms of this License, +in one of these ways: + + a) Convey the object code in, or embodied in, a physical product + (including a physical distribution medium), accompanied by the + Corresponding Source fixed on a durable physical medium + customarily used for software interchange. + + b) Convey the object code in, or embodied in, a physical product + (including a physical distribution medium), accompanied by a + written offer, valid for at least three years and valid for as + long as you offer spare parts or customer support for that product + model, to give anyone who possesses the object code either (1) a + copy of the Corresponding Source for all the software in the + product that is covered by this License, on a durable physical + medium customarily used for software interchange, for a price no + more than your reasonable cost of physically performing this + conveying of source, or (2) access to copy the + Corresponding Source from a network server at no charge. + + c) Convey individual copies of the object code with a copy of the + written offer to provide the Corresponding Source. This + alternative is allowed only occasionally and noncommercially, and + only if you received the object code with such an offer, in accord + with subsection 6b. + + d) Convey the object code by offering access from a designated + place (gratis or for a charge), and offer equivalent access to the + Corresponding Source in the same way through the same place at no + further charge. You need not require recipients to copy the + Corresponding Source along with the object code. If the place to + copy the object code is a network server, the Corresponding Source + may be on a different server (operated by you or a third party) + that supports equivalent copying facilities, provided you maintain + clear directions next to the object code saying where to find the + Corresponding Source. Regardless of what server hosts the + Corresponding Source, you remain obligated to ensure that it is + available for as long as needed to satisfy these requirements. + + e) Convey the object code using peer-to-peer transmission, provided + you inform other peers where the object code and Corresponding + Source of the work are being offered to the general public at no + charge under subsection 6d. + + A separable portion of the object code, whose source code is excluded +from the Corresponding Source as a System Library, need not be +included in conveying the object code work. + + A "User Product" is either (1) a "consumer product", which means any +tangible personal property which is normally used for personal, family, +or household purposes, or (2) anything designed or sold for incorporation +into a dwelling. In determining whether a product is a consumer product, +doubtful cases shall be resolved in favor of coverage. For a particular +product received by a particular user, "normally used" refers to a +typical or common use of that class of product, regardless of the status +of the particular user or of the way in which the particular user +actually uses, or expects or is expected to use, the product. A product +is a consumer product regardless of whether the product has substantial +commercial, industrial or non-consumer uses, unless such uses represent +the only significant mode of use of the product. + + "Installation Information" for a User Product means any methods, +procedures, authorization keys, or other information required to install +and execute modified versions of a covered work in that User Product from +a modified version of its Corresponding Source. The information must +suffice to ensure that the continued functioning of the modified object +code is in no case prevented or interfered with solely because +modification has been made. + + If you convey an object code work under this section in, or with, or +specifically for use in, a User Product, and the conveying occurs as +part of a transaction in which the right of possession and use of the +User Product is transferred to the recipient in perpetuity or for a +fixed term (regardless of how the transaction is characterized), the +Corresponding Source conveyed under this section must be accompanied +by the Installation Information. But this requirement does not apply +if neither you nor any third party retains the ability to install +modified object code on the User Product (for example, the work has +been installed in ROM). + + The requirement to provide Installation Information does not include a +requirement to continue to provide support service, warranty, or updates +for a work that has been modified or installed by the recipient, or for +the User Product in which it has been modified or installed. Access to a +network may be denied when the modification itself materially and +adversely affects the operation of the network or violates the rules and +protocols for communication across the network. + + Corresponding Source conveyed, and Installation Information provided, +in accord with this section must be in a format that is publicly +documented (and with an implementation available to the public in +source code form), and must require no special password or key for +unpacking, reading or copying. + + 7. Additional Terms. + + "Additional permissions" are terms that supplement the terms of this +License by making exceptions from one or more of its conditions. +Additional permissions that are applicable to the entire Program shall +be treated as though they were included in this License, to the extent +that they are valid under applicable law. If additional permissions +apply only to part of the Program, that part may be used separately +under those permissions, but the entire Program remains governed by +this License without regard to the additional permissions. + + When you convey a copy of a covered work, you may at your option +remove any additional permissions from that copy, or from any part of +it. (Additional permissions may be written to require their own +removal in certain cases when you modify the work.) You may place +additional permissions on material, added by you to a covered work, +for which you have or can give appropriate copyright permission. + + Notwithstanding any other provision of this License, for material you +add to a covered work, you may (if authorized by the copyright holders of +that material) supplement the terms of this License with terms: + + a) Disclaiming warranty or limiting liability differently from the + terms of sections 15 and 16 of this License; or + + b) Requiring preservation of specified reasonable legal notices or + author attributions in that material or in the Appropriate Legal + Notices displayed by works containing it; or + + c) Prohibiting misrepresentation of the origin of that material, or + requiring that modified versions of such material be marked in + reasonable ways as different from the original version; or + + d) Limiting the use for publicity purposes of names of licensors or + authors of the material; or + + e) Declining to grant rights under trademark law for use of some + trade names, trademarks, or service marks; or + + f) Requiring indemnification of licensors and authors of that + material by anyone who conveys the material (or modified versions of + it) with contractual assumptions of liability to the recipient, for + any liability that these contractual assumptions directly impose on + those licensors and authors. + + All other non-permissive additional terms are considered "further +restrictions" within the meaning of section 10. If the Program as you +received it, or any part of it, contains a notice stating that it is +governed by this License along with a term that is a further +restriction, you may remove that term. If a license document contains +a further restriction but permits relicensing or conveying under this +License, you may add to a covered work material governed by the terms +of that license document, provided that the further restriction does +not survive such relicensing or conveying. + + If you add terms to a covered work in accord with this section, you +must place, in the relevant source files, a statement of the +additional terms that apply to those files, or a notice indicating +where to find the applicable terms. + + Additional terms, permissive or non-permissive, may be stated in the +form of a separately written license, or stated as exceptions; +the above requirements apply either way. + + 8. Termination. + + You may not propagate or modify a covered work except as expressly +provided under this License. Any attempt otherwise to propagate or +modify it is void, and will automatically terminate your rights under +this License (including any patent licenses granted under the third +paragraph of section 11). + + However, if you cease all violation of this License, then your +license from a particular copyright holder is reinstated (a) +provisionally, unless and until the copyright holder explicitly and +finally terminates your license, and (b) permanently, if the copyright +holder fails to notify you of the violation by some reasonable means +prior to 60 days after the cessation. + + Moreover, your license from a particular copyright holder is +reinstated permanently if the copyright holder notifies you of the +violation by some reasonable means, this is the first time you have +received notice of violation of this License (for any work) from that +copyright holder, and you cure the violation prior to 30 days after +your receipt of the notice. + + Termination of your rights under this section does not terminate the +licenses of parties who have received copies or rights from you under +this License. If your rights have been terminated and not permanently +reinstated, you do not qualify to receive new licenses for the same +material under section 10. + + 9. Acceptance Not Required for Having Copies. + + You are not required to accept this License in order to receive or +run a copy of the Program. Ancillary propagation of a covered work +occurring solely as a consequence of using peer-to-peer transmission +to receive a copy likewise does not require acceptance. However, +nothing other than this License grants you permission to propagate or +modify any covered work. These actions infringe copyright if you do +not accept this License. Therefore, by modifying or propagating a +covered work, you indicate your acceptance of this License to do so. + + 10. Automatic Licensing of Downstream Recipients. + + Each time you convey a covered work, the recipient automatically +receives a license from the original licensors, to run, modify and +propagate that work, subject to this License. You are not responsible +for enforcing compliance by third parties with this License. + + An "entity transaction" is a transaction transferring control of an +organization, or substantially all assets of one, or subdividing an +organization, or merging organizations. If propagation of a covered +work results from an entity transaction, each party to that +transaction who receives a copy of the work also receives whatever +licenses to the work the party's predecessor in interest had or could +give under the previous paragraph, plus a right to possession of the +Corresponding Source of the work from the predecessor in interest, if +the predecessor has it or can get it with reasonable efforts. + + You may not impose any further restrictions on the exercise of the +rights granted or affirmed under this License. For example, you may +not impose a license fee, royalty, or other charge for exercise of +rights granted under this License, and you may not initiate litigation +(including a cross-claim or counterclaim in a lawsuit) alleging that +any patent claim is infringed by making, using, selling, offering for +sale, or importing the Program or any portion of it. + + 11. Patents. + + A "contributor" is a copyright holder who authorizes use under this +License of the Program or a work on which the Program is based. The +work thus licensed is called the contributor's "contributor version". + + A contributor's "essential patent claims" are all patent claims +owned or controlled by the contributor, whether already acquired or +hereafter acquired, that would be infringed by some manner, permitted +by this License, of making, using, or selling its contributor version, +but do not include claims that would be infringed only as a +consequence of further modification of the contributor version. For +purposes of this definition, "control" includes the right to grant +patent sublicenses in a manner consistent with the requirements of +this License. + + Each contributor grants you a non-exclusive, worldwide, royalty-free +patent license under the contributor's essential patent claims, to +make, use, sell, offer for sale, import and otherwise run, modify and +propagate the contents of its contributor version. + + In the following three paragraphs, a "patent license" is any express +agreement or commitment, however denominated, not to enforce a patent +(such as an express permission to practice a patent or covenant not to +sue for patent infringement). To "grant" such a patent license to a +party means to make such an agreement or commitment not to enforce a +patent against the party. + + If you convey a covered work, knowingly relying on a patent license, +and the Corresponding Source of the work is not available for anyone +to copy, free of charge and under the terms of this License, through a +publicly available network server or other readily accessible means, +then you must either (1) cause the Corresponding Source to be so +available, or (2) arrange to deprive yourself of the benefit of the +patent license for this particular work, or (3) arrange, in a manner +consistent with the requirements of this License, to extend the patent +license to downstream recipients. "Knowingly relying" means you have +actual knowledge that, but for the patent license, your conveying the +covered work in a country, or your recipient's use of the covered work +in a country, would infringe one or more identifiable patents in that +country that you have reason to believe are valid. + + If, pursuant to or in connection with a single transaction or +arrangement, you convey, or propagate by procuring conveyance of, a +covered work, and grant a patent license to some of the parties +receiving the covered work authorizing them to use, propagate, modify +or convey a specific copy of the covered work, then the patent license +you grant is automatically extended to all recipients of the covered +work and works based on it. + + A patent license is "discriminatory" if it does not include within +the scope of its coverage, prohibits the exercise of, or is +conditioned on the non-exercise of one or more of the rights that are +specifically granted under this License. You may not convey a covered +work if you are a party to an arrangement with a third party that is +in the business of distributing software, under which you make payment +to the third party based on the extent of your activity of conveying +the work, and under which the third party grants, to any of the +parties who would receive the covered work from you, a discriminatory +patent license (a) in connection with copies of the covered work +conveyed by you (or copies made from those copies), or (b) primarily +for and in connection with specific products or compilations that +contain the covered work, unless you entered into that arrangement, +or that patent license was granted, prior to 28 March 2007. + + Nothing in this License shall be construed as excluding or limiting +any implied license or other defenses to infringement that may +otherwise be available to you under applicable patent law. + + 12. No Surrender of Others' Freedom. + + If conditions are imposed on you (whether by court order, agreement or +otherwise) that contradict the conditions of this License, they do not +excuse you from the conditions of this License. If you cannot convey a +covered work so as to satisfy simultaneously your obligations under this +License and any other pertinent obligations, then as a consequence you may +not convey it at all. For example, if you agree to terms that obligate you +to collect a royalty for further conveying from those to whom you convey +the Program, the only way you could satisfy both those terms and this +License would be to refrain entirely from conveying the Program. + + 13. Use with the GNU Affero General Public License. + + Notwithstanding any other provision of this License, you have +permission to link or combine any covered work with a work licensed +under version 3 of the GNU Affero General Public License into a single +combined work, and to convey the resulting work. The terms of this +License will continue to apply to the part which is the covered work, +but the special requirements of the GNU Affero General Public License, +section 13, concerning interaction through a network will apply to the +combination as such. + + 14. Revised Versions of this License. + + The Free Software Foundation may publish revised and/or new versions of +the GNU General Public License from time to time. Such new versions will +be similar in spirit to the present version, but may differ in detail to +address new problems or concerns. + + Each version is given a distinguishing version number. If the +Program specifies that a certain numbered version of the GNU General +Public License "or any later version" applies to it, you have the +option of following the terms and conditions either of that numbered +version or of any later version published by the Free Software +Foundation. If the Program does not specify a version number of the +GNU General Public License, you may choose any version ever published +by the Free Software Foundation. + + If the Program specifies that a proxy can decide which future +versions of the GNU General Public License can be used, that proxy's +public statement of acceptance of a version permanently authorizes you +to choose that version for the Program. + + Later license versions may give you additional or different +permissions. However, no additional obligations are imposed on any +author or copyright holder as a result of your choosing to follow a +later version. + + 15. Disclaimer of Warranty. + + THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY +APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT +HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY +OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, +THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR +PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM +IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF +ALL NECESSARY SERVICING, REPAIR OR CORRECTION. + + 16. Limitation of Liability. + + IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING +WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS +THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY +GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE +USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF +DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD +PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), +EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF +SUCH DAMAGES. + + 17. Interpretation of Sections 15 and 16. + + If the disclaimer of warranty and limitation of liability provided +above cannot be given local legal effect according to their terms, +reviewing courts shall apply local law that most closely approximates +an absolute waiver of all civil liability in connection with the +Program, unless a warranty or assumption of liability accompanies a +copy of the Program in return for a fee. + + END OF TERMS AND CONDITIONS + + How to Apply These Terms to Your New Programs + + If you develop a new program, and you want it to be of the greatest +possible use to the public, the best way to achieve this is to make it +free software which everyone can redistribute and change under these terms. + + To do so, attach the following notices to the program. It is safest +to attach them to the start of each source file to most effectively +state the exclusion of warranty; and each file should have at least +the "copyright" line and a pointer to where the full notice is found. + + + Copyright (C) + + This program is free software: you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation, either version 3 of the License, or + (at your option) any later version. + + This program is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + GNU General Public License for more details. + + You should have received a copy of the GNU General Public License + along with this program. If not, see . + +Also add information on how to contact you by electronic and paper mail. + + If the program does terminal interaction, make it output a short +notice like this when it starts in an interactive mode: + + Copyright (C) + This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'. + This is free software, and you are welcome to redistribute it + under certain conditions; type `show c' for details. + +The hypothetical commands `show w' and `show c' should show the appropriate +parts of the General Public License. Of course, your program's commands +might be different; for a GUI interface, you would use an "about box". + + You should also get your employer (if you work as a programmer) or school, +if any, to sign a "copyright disclaimer" for the program, if necessary. +For more information on this, and how to apply and follow the GNU GPL, see +. + + The GNU General Public License does not permit incorporating your program +into proprietary programs. If your program is a subroutine library, you +may consider it more useful to permit linking proprietary applications with +the library. If this is what you want to do, use the GNU Lesser General +Public License instead of this License. But first, please read +. diff --git a/imports/ComfyUI_IPAdapter_plus/README.md b/imports/ComfyUI_IPAdapter_plus/README.md new file mode 100644 index 0000000..f7fed54 --- /dev/null +++ b/imports/ComfyUI_IPAdapter_plus/README.md @@ -0,0 +1,126 @@ +# ComfyUI IPAdapter plus +[ComfyUI](https://github.com/comfyanonymous/ComfyUI) reference implementation for [IPAdapter](https://github.com/tencent-ailab/IP-Adapter/) models. + +IPAdapter implementation that follows the ComfyUI way of doing things. The code is memory efficient, fast, and shouldn't break with Comfy updates. + +# Open source for you but not free for me... + +I started working on IPAdapter because I needed it for my work. As the project evolved I'm inevitably receiving feature requests, bug reports and support requests. + +I'm an open source advocate and I'm happy to share all my code for free but maintaining the IPAdapter, the [Essentials](https://github.com/cubiq/ComfyUI_essentials), [InstantID](https://github.com/cubiq/ComfyUI_InstantID) and [Face Analysis](https://github.com/cubiq/ComfyUI_FaceAnalysis) takes time. + +**I'm not expecting donations but if you are making a profit from my projects it is only fair that you give something back.** I'm talking especially to companies here, I know the struggles of being a freelancer. + +Please contact me if you are interested in a sponsorship at _matt3o@gmail_ or consider a contribution via [PayPal](https://paypal.me/matt3o) (Matteo "matt3o" Spinelli, Firenze, IT). That will help maintaining the code, adding new features and working on better documentation. + +And in that regard I really need to thank [Nathan Shipley](https://www.nathanshipley.com/) for his generous donation. Go check his website, he's terribly talented. + +## :warning: IPAdapter V2: complete Code rewrite warning + +A code cleanup was long overdue and with the occasion I also added a few new important features. The code should be faster and should take less resources but with such an important code rewrite it's inevitable to have introduced some new bugs. + +**At the moment I'm releasing this completely undocumented!** I will post better documentation and video tutorials in the coming days. In the meantime you can check the `example` directory for most of the old and new features. + +## Important updates + +**2024/03/23**: Complete code rewrite!. **This is a breaking update!** Your previous workflows won't work and you'll need to recreate them. You've been warned! After the update, refresh your browser, delete the old IPAdapter nodes and create the new ones. + +**2024/02/02**: Added experimental [tiled IPAdapter](#tiled-ipadapter). It lets you easily handle reference images that are not square. Can be useful for upscaling. + +**2024/01/19**: Support for FaceID Portrait models. + +**2024/01/16**: Notably increased quality of FaceID Plus/v2 models. Check the [comparison](https://github.com/cubiq/ComfyUI_IPAdapter_plus/issues/195) of all face models. + +*(previous updates removed for better readability)* + +## What is it? + +The IPAdapter are very powerful models for image-to-image conditioning. Given one or more reference images you can do variations augmented by text prompt, controlnets and masks. Think of it as a 1-image lora. + +## Example workflow + +The [example directory](./examples/) has many workflows that cover all IPAdapter functionalities. + +![IPAdapter Example workflow](./examples/demo_workflow.jpg) + +## Video Tutorials + + + Watch the video + + +**:star: [New IPAdapter features](https://youtu.be/_JzDcgKgghY)** + +The following videos are about the previous version of IPAdapter, but they still contain valuable information. + +**:nerd_face: [Basic usage video](https://youtu.be/7m9ZZFU3HWo)** + +**:rocket: [Advanced features video](https://www.youtube.com/watch?v=mJQ62ly7jrg)** + +**:japanese_goblin: [Attention Masking video](https://www.youtube.com/watch?v=vqG1VXKteQg)** + +**:movie_camera: [Animation Features video](https://www.youtube.com/watch?v=ddYbhv3WgWw)** + +## Installation + +Download or git clone this repository inside `ComfyUI/custom_nodes/` directory or use the Manager. Beware that the automatic update of the manager sometimes doesn't work and you may need to upgrade manually. + +IPAdapter always requires the latest version of ComfyUI. If something doesn't work be sure to upgrade! + +There's now an *Unified Model Loader*, for it to work you need to name the files exactly how it is described below. + +The pre-trained models are available on [huggingface](https://huggingface.co/h94/IP-Adapter), download and place them in the `ComfyUI/models/ipadapter` directory (create it if not present). You can also use any custom location setting an `ipadapter` entry in the `extra_model_paths.yaml` file. + +IPAdapter also needs the image encoders. You need the [CLIP-ViT-H-14-laion2B-s32B-b79K.safetensors](https://huggingface.co/h94/IP-Adapter/resolve/main/models/image_encoder/model.safetensors) and [CLIP-ViT-bigG-14-laion2B-39B-b160k.safetensors](https://huggingface.co/h94/IP-Adapter/resolve/main/sdxl_models/image_encoder/model.safetensors) image encoders, you may already have them. If you don't, download them but **be careful because the file name is the same for both!** Rename them and place them in the `ComfyUI/models/clip_vision/` directory. + +The following table shows the combination of Checkpoint and Image encoder to use for each IPAdapter Model. Any Tensor size mismatch you may get it is likely caused by a wrong combination. + +| SD v. | IPadapter | Img encoder | Notes | +|---|---|---|---| +| v1.5 | [ip-adapter_sd15](https://huggingface.co/h94/IP-Adapter/resolve/main/models/ip-adapter_sd15.safetensors) | ViT-H | Basic model, average strength | +| v1.5 | [ip-adapter_sd15_light](https://huggingface.co/h94/IP-Adapter/resolve/main/models/ip-adapter_sd15_light.safetensors) | ViT-H | Light model, very light impact | +| v1.5 | [ip-adapter_sd15_light_v11](https://huggingface.co/h94/IP-Adapter/resolve/main/models/ip-adapter_sd15_light_v11.bin) | ViT-H | Updated light model | +| v1.5 | [ip-adapter-plus_sd15](https://huggingface.co/h94/IP-Adapter/resolve/main/models/ip-adapter-plus_sd15.safetensors) | ViT-H | Plus model, very strong | +| v1.5 | [ip-adapter-plus-face_sd15](https://huggingface.co/h94/IP-Adapter/resolve/main/models/ip-adapter-plus-face_sd15.safetensors) | ViT-H | Face model, use only for faces | +| v1.5 | [ip-adapter-full-face_sd15](https://huggingface.co/h94/IP-Adapter/resolve/main/models/ip-adapter-full-face_sd15.safetensors) | ViT-H | Stronger face model, not necessarily better | +| v1.5 | [ip-adapter_sd15_vit-G](https://huggingface.co/h94/IP-Adapter/resolve/main/models/ip-adapter_sd15_vit-G.safetensors) | ViT-bigG | Base model trained with a bigG encoder | +| SDXL | [ip-adapter_sdxl](https://huggingface.co/h94/IP-Adapter/resolve/main/sdxl_models/ip-adapter_sdxl.safetensors) | ViT-bigG | Base SDXL model, mostly deprecated | +| SDXL | [ip-adapter_sdxl_vit-h](https://huggingface.co/h94/IP-Adapter/resolve/main/sdxl_models/ip-adapter_sdxl_vit-h.safetensors) | ViT-H | New base SDXL model | +| SDXL | [ip-adapter-plus_sdxl_vit-h](https://huggingface.co/h94/IP-Adapter/resolve/main/sdxl_models/ip-adapter-plus_sdxl_vit-h.safetensors) | ViT-H | SDXL plus model, stronger | +| SDXL | [ip-adapter-plus-face_sdxl_vit-h](https://huggingface.co/h94/IP-Adapter/resolve/main/sdxl_models/ip-adapter-plus-face_sdxl_vit-h.safetensors) | ViT-H | SDXL face model | + +**FaceID** requires `insightface`, you need to install them in your ComfyUI environment. Check [this issue](https://github.com/cubiq/ComfyUI_IPAdapter_plus/issues/162) for help. + +When the dependencies are satisfied you need: + +| SD v. | IPadapter | Img encoder | Lora | +|---|---|---|---| +| v1.5 | [FaceID](https://huggingface.co/h94/IP-Adapter-FaceID/resolve/main/ip-adapter-faceid_sd15.bin) | (not used¹) | [FaceID Lora](https://huggingface.co/h94/IP-Adapter-FaceID/resolve/main/ip-adapter-faceid_sd15_lora.safetensors) | +| v1.5 | [FaceID Plus](https://huggingface.co/h94/IP-Adapter-FaceID/resolve/main/ip-adapter-faceid-plus_sd15.bin) | ViT-H | [FaceID Plus Lora](https://huggingface.co/h94/IP-Adapter-FaceID/resolve/main/ip-adapter-faceid-plus_sd15_lora.safetensors) | +| v1.5 | [FaceID Plus v2](https://huggingface.co/h94/IP-Adapter-FaceID/resolve/main/ip-adapter-faceid-plusv2_sd15.bin) | ViT-H | [FaceID Plus v2 Lora](https://huggingface.co/h94/IP-Adapter-FaceID/resolve/main/ip-adapter-faceid-plusv2_sd15_lora.safetensors) | +| v1.5 | [FaceID Portrait](https://huggingface.co/h94/IP-Adapter-FaceID/resolve/main/ip-adapter-faceid-portrait_sd15.bin) | (not used¹)| not needed | +| SDXL | [FaceID](https://huggingface.co/h94/IP-Adapter-FaceID/resolve/main/ip-adapter-faceid_sdxl.bin) | (not used¹) | [FaceID SDXL Lora](https://huggingface.co/h94/IP-Adapter-FaceID/resolve/main/ip-adapter-faceid_sdxl_lora.safetensors) | +| SDXL | [FaceID Plus v2](https://huggingface.co/h94/IP-Adapter-FaceID/resolve/main/ip-adapter-faceid-plusv2_sdxl.bin) | ViT-H | [FaceID SDXL Lora](https://huggingface.co/h94/IP-Adapter-FaceID/resolve/main/ip-adapter-faceid-plusv2_sdxl_lora.safetensors) | + + +¹ The base FaceID model doesn't make use of a CLIP vision encoder. Remember to pair any FaceID model together with any other Face model to make it more effective. + +The loras need to be placed into `ComfyUI/models/loras/` directory. + +## Generic suggestions + +There's a basic workflow included in this repo and a few examples in the [examples](./examples/) directory. Usually it's a good idea to lower the `weight` to at least `0.8` and increase the steps a little. + +## Documentation soon to come... + +Working on it! + +## Troubleshooting + +Please check the [troubleshooting](https://github.com/cubiq/ComfyUI_IPAdapter_plus/issues/108) before posting a new issue. Alse remember to check the previous closed issues. + +## Credits + +- [IPAdapter](https://github.com/tencent-ailab/IP-Adapter/) +- [ComfyUI](https://github.com/comfyanonymous/ComfyUI) +- [laksjdjf](https://github.com/laksjdjf/IPAdapter-ComfyUI/) diff --git a/imports/ComfyUI_IPAdapter_plus/__init__.py b/imports/ComfyUI_IPAdapter_plus/__init__.py new file mode 100644 index 0000000..03a9149 --- /dev/null +++ b/imports/ComfyUI_IPAdapter_plus/__init__.py @@ -0,0 +1,19 @@ +""" + ██▓ ██▓███ ▄▄▄ ▓█████▄ ▄▄▄ ██▓███ ▄▄▄█████▓▓█████ ██▀███ +▓██▒▓██░ ██▒▒████▄ ▒██▀ ██▌▒████▄ ▓██░ ██▒▓ ██▒ ▓▒▓█ ▀ ▓██ ▒ ██▒ +▒██▒▓██░ ██▓▒▒██ ▀█▄ ░██ █▌▒██ ▀█▄ ▓██░ ██▓▒▒ ▓██░ ▒░▒███ ▓██ ░▄█ ▒ +░██░▒██▄█▓▒ ▒░██▄▄▄▄██ ░▓█▄ ▌░██▄▄▄▄██ ▒██▄█▓▒ ▒░ ▓██▓ ░ ▒▓█ ▄ ▒██▀▀█▄ +░██░▒██▒ ░ ░ ▓█ ▓██▒░▒████▓ ▓█ ▓██▒▒██▒ ░ ░ ▒██▒ ░ ░▒████▒░██▓ ▒██▒ +░▓ ▒▓▒░ ░ ░ ▒▒ ▓▒█░ ▒▒▓ ▒ ▒▒ ▓▒█░▒▓▒░ ░ ░ ▒ ░░ ░░ ▒░ ░░ ▒▓ ░▒▓░ + ▒ ░░▒ ░ ▒ ▒▒ ░ ░ ▒ ▒ ▒ ▒▒ ░░▒ ░ ░ ░ ░ ░ ░▒ ░ ▒░ + ▒ ░░░ ░ ▒ ░ ░ ░ ░ ▒ ░░ ░ ░ ░░ ░ + ░ ░ ░ ░ ░ ░ ░ ░ ░ + ░ + ·-—+ IPAdapter Plus Extension for ComfyUI +—-· · + Brought to you by Matteo "Matt3o/Cubiq" Spinelli + https://github.com/cubiq/ComfyUI_IPAdapter_plus/ +""" + +from .IPAdapterPlus import NODE_CLASS_MAPPINGS, NODE_DISPLAY_NAME_MAPPINGS + +__all__ = ['NODE_CLASS_MAPPINGS', 'NODE_DISPLAY_NAME_MAPPINGS'] diff --git a/imports/ComfyUI_IPAdapter_plus/examples/demo_workflow.jpg b/imports/ComfyUI_IPAdapter_plus/examples/demo_workflow.jpg new file mode 100644 index 0000000000000000000000000000000000000000..d30bb7c96196a0613e64ea80b523690c6eace083 GIT binary patch literal 237238 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

O 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

elB0MUjqGWa^BlhCxUPU`n^4X5% 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≧S zbb25j6-X=iQ#}m{l(}tL9xC$?CQ$gt8`PKSTi^Me#qU4RUy0!N(juAq7RP)Eoq5zu zH(=7rdHdqnvdzdU(;J^E-*mTQ@dsjuOgqoH9L9W=FbP3M1eAC>S434jY2hZi~D z=wMxBVj0CCR?P2zb>6$?ix1fTsNKd)k9OzcAIEipSP7GXTmIaJ);bliE6$kCqy}_= ze)}~sMy_owJVSZP7vnZJ=(dVeKtzpGU|0Nsr#A$GCF1Z8ihNG88OJX&<6^o%)Ln43 z$lN$aS9vZ+z?b5Zr>hL-61UE+G&! zxI2LamjD5RdvFNu?hxD?cWvBhdY?u1`@Q@9&N=sv@BX}uL66Z*uUWI^T&#L#)l*eM zbiVb%vxN)r=|*^|ZGs{1n6nZ2Tmghoy;h9@e7qWK-5n}GrWV(f=U)Fi@m1eY2ClS# zA5SUm9<5pH`OkE^8d?kag*uh`Yox?gv8WNcaQzzxU!bzeYn2+v5%jCN9Qdo?&Xs2C zjPbqfXPEigC{g!fUWryX^2!ETii08PXrAb@Whw1B>t^h-%5mowP&a1SLzD}%43U_o zEg}0I^>vfVUm$wkyB;7+L6Cf@D|QCMO6(Cs7dBt@NaI;S-%oZotW0rr4~Ahnwv{?o z{EjuZ4!q#mg%dnvi&EXl@B~bDt1r!$!y5LPUcD4k^?0x@F@ikrTxMxMo$Xu#Yoyg% zKfKheioq^;!!DL4R%WhkbREHBRd%su4&)?{tla5gn+Iid@qypnm7fUCDXT-mL3x zoPxGp`fR8q|AzGy8<*f zeVFSNyqm1_5z{^7BB*f&U&i^MT$ZE)_jnEWlU_@I#G}B0Ost(wQ6@X|r8m7`QR43? z;`WYQ0odzSZ20amFr@<4j`04-=O5^tdYxjeNlnuqJ!O8E1@rXTfS>Y^wqssBa^HxW~(so6L&53yEdG$$mP2bjjoG;F}{$EC0$d4*bR7iNi zxuDOIXvSHqs$i-U#BS=BESgK+(7zE?!?Mgfag;p6r#H7&Ta}@r^Msi@8-34pKY>L zsuf@GHhv+EV8k&?Bcnnsk&LL^LwU zk)nL3danWvQXLT;GV3=w2&IW1+z4wxiLMTG%O7G|>23Vf5Ih+9tlp@y>#5NWsmc-G zd)xa>^M>=5SWmWx%fCP~Ise`|#IjRx#QW(Bmw>0S#57?L0h^vw)WE?AI`8rGHcA{U z_Ge`4`L(CQB(^E$F2qqfDGG5)XNLS+xPx@d=+v7pm?TE91un{%|2^P8_rm^Rvm3W- z?oyzGedE{oDTkLV_P6%Wswk%0)smiqi0=Ci%yxPp&Vsb?6bn0ZLUj8fk#4I93LVzD zLWI#l0>lvy)-f%@fA9aNxN*PZa(E5MQzmUgL`ZGAhKoCHLE7PJ{!66|60?pxky^r5 zC?!I=J8=-*%U0`oC7zF}aXh zFN5;Q6QCZgsVb8BF`CT#FR}IPI9Q?9?m~zTx-BLYa)rOOUWMlF;l=REGuomQ?vt1zRPcUB$4g#Rn|1T* z*3DOL;KZoYMoi-5!k70ZVl>|Z{e0e%K0HkxsM#dxf}Wnc5pA^zr-7+X!Rhwx6O zN=-=Ol|#Kb3=%UuY+(sO@u%#nS41urF2`&}uZA-J4hKDgfpqtB({t&6%rD4iv@`J9 zQea`ShPpy~pbw;qQVSzASz`f|DB%wyNxV^ivCx8R=4e*GLc*GIp@M`QvO9bK5<98MjLxtA>x%!F z(0{uE6Sx96n&th`NPMb>CFA0MGB@MGe+Fm!PyK+W??av&psogBA$pL0H%rk?`hWmzbv62lvNS#3(zl&PI3hk^7`%o z=E9%d0zAF{v+V*_@sZf@Kbhly3WHBf0cSPvzcvrW>3_N=ay+bx|BpLRb~M3ZM*HKE zW^qLGJ5_3;Rpyvd{1H30H2SG z#gxli5WSKs!(L^<9WX9#{sO9$ojM&ao_u94|D*_mL0}Q61aPcGy>sAIpU5T|!HYNg zvOryt4B))At+Am<lFJEBCmFQcvSC<~&!@ca?jjmS4Ww)(+pr2?6`S=pm zQ%V)~ekbzTf?oNE`0t`v%{142GZQI? z89<{i;SD_5%TtpLH&M zN>WBEhc0&O346?fZZv!*_XVK2mNVHf`xbgHirO0mQDX0zmSTGBKSd4l(c2g|9P61j zbFrvdKO~rT?>_I8FmoZo)8d~LnsTG0Q_jl`Fi)){oer`|COKE;w3O(RxXH_0ZE>B_ zJknQGAGAasq%GnjKKVu%SdjQe)h<(>Tu$lcf4!90(O&6vL)I8gxVbM8e1G?@iH%(4 z=bK8&8|na*H(DKS7_B1iU2D%(2m%WNe=ho!PqN`CSyNpyEFvDUTLY|udwDBgz6SUF zu?uU)Q~#O$eWC}huv>34o#V#p^o*EG_cs%qVRC5&6L^Ri?a2wMNDz?ppA=b;uOqjwM}8ZhV8eQ$0{Y zoY6SX&nL|(jptay$b&EhCSBlOd+js%L1d+=PU}Ij!vVEi32ou2B-VLbdeJHMXF}x=34% zfsj5k?WZxn5H5S=`pHKnmTQiVg=uqE9%9LrIr8Ufhg#H?-~FIaUjhv|?{lgY;CH%* zuN&sC0qqwu(fb6ieiq#gFDgY>^-Z&6A%0QCG9s7n<1dry5d0)~)P!#J#;_AZxPY{P z9LLA&4s9lJU9q$^}K%z(c`E`P&p>u(%3tGYZ@h&@hM~w9>H#1dNTT@{8cIDMG?!P zYBcB7&Q^pMB20GfUEO=2?co}$&c*#b_|-CVleL=;#j^q2!QufdSt=FJLpTe}{ZzJ> zRk?q^4i~a}XMc9F^s+;^Sn+KyXUyF<(bJthLkHf%Pq-!3mmh18?BaWA>P4z{Tf=WB zaJupOc8o`aw8Sa{lMALdYXyCBzl$V$QY@|JT&3ad%_b(9)EX62_(|xd3pIK1=T3gq z7v1`C8bS6xtm2-^U43JnKJsE1KZmY!JVmvMf6c@YK`a`a_R-sLYGbCA(i(4p_uj;f zGPLjXWh&y$We#+1_>-}_x3Fhqb12o9+(Au=X=P71x%Dv^+kIARoO|Kp>C-p|A6#kE z>FV6`jd;2H-+}Qwr-VT)q3L)-ozJP@;#$+-s_1U<$>?YMoc_PjEzhc4M0DBq#Yo;! z=Z&pjR_w*N{{>Q*Is!^A@Q{Y;_@l9y8u|=@kR?1wN9{MW{B6Y;1&j@PrjVbXmg!!J zT@?B)^XxS6R7~SLaiYJAoMLDnu_6t(K=})?urBa(VRf;6TELR#V7f2r{BHIm^%I;va?JK* zVNc9fe7R2)S>gkcBb4>UWj7p(@R-m7Dr zPnHUy%*06Sq+fsn`JoD2Kt43qay7=PlQ_Z%wt`fuYn}j*>Ir-VB0HUk@+tUqI_jwp zjI0buq0W1ST}p*QoeWZTbKO(mikpZaU-D8FOt%2-K%#sK?R_jdE;Escck<9vT{F$o zy~bJu$3PA3d$OWaY!bu3#UN^Plssy4@oS=XXK+kdz<%o*HQ;$9IeUCqD1>%&o z($k@>`mSWdyzoX)9{s!VO_U`FkkZhntHj96K6m6Ta5}mU{vs!66yc&BaG`UA*%{rb z)Y%kn1X<{=ldtMtCOc^hpAI6vWPQa!b&c`a-nwhV-Xk-xuGF0<3Orb$zEd0&&F5Uo z)}jNa*XM9qEhTR9MX6Uj)mw!(x>@_7rbAp0cw>qbQ8f-z`X896Ki-QTc&ADAz==%8 zO(JboedHyrdq{n1fU%g4t#Ag@tP7TT_38qZ#{a(jjWd|cO1rpel#!HvN5mqKk(S4xjuaEjlB^O)!=Z%#cxj5*`d>drN z_)Io_^Khlg_waZDI=j{9c@oJc;iKHUe_94Dfv!4-v<$qbkkR@mQKLd5vzUso7%|;- zirAgsxpESj=A{a6AMvYd9a~n>->`LvIFCx&DK+2oe7K6lIMp2tCEL=Ok&BgRkU}=D zCoe(dC3+u`N}?k}$kpZL2W62g9_C%MSV$nJ-nqH^)vX+H>k}dHsb+CO<=6TaW!x z$&F@wn7sR2@9U3-vi#~_@C?;~q_k+;cR!j4KInuF&=>Mt&{KX_lLo!`|L}|7e1{zQ zGs%+YD366OF#+m?#Aw|rl9lvU=opEB!IK#wCT^C9r_^q}RCz&3??p1#6Y4%vk!Bkj zi}}SuD)n8g?KL?t$0awy*aA$ju6d@+ImE>hE6c=*yk*x*sp99}#8Zm}UnA@OW}F7H zDSMbm=6#;??wf=TB?Bx@#IX?C zSXoJ8j3`3qAC%zK)R;K6IrmZR$xo%FRE<*BcH1G@$*5cJ@FL{c_Z_jbR`KLI==|9h z-33Qxl?>D_8B^YTlRRzIMP$^n9NWV1e?qYo#D^m>;`MGGPPQ;mY(>B;SQ1A{S`Vd- z-5z@_fR|uTAWOp#lA)0?nmQ${QfT#U2(zc%!u0GM?{!ER_0lh<0tE5p#aAf5<@3wK zc}$xd8ufY=!^6Kf#lC*0{!zV0?{hC-9by!aO{s8#AJt+>yA)M9VD))C{c1{5Q?2ep zs$4s@-Tm#Yy(33NW7k?;>Px=HKyB|+mi?KYWby&W;h1_nt;24U)}y%{wBsH~-XSL9 zFoxz~L=dU9MOH)*lQvWuk^Td0ZglXegSyH_n&YPL)lI)^@0V)JSUdr0{ZvQSA<9vW zCVCn~aT3;(hmumWhABJDW`cbvV*r@@8wIx%_;*&m38{F3W?xXcm)mbSWUHq5{4sHtX7kPyg8cdrv@3>@>S=m6`@9%%qj~PY5rJ|)VW$@FD>ysvF+RF68Z4__>lqNF zc-NeZFx4kBwbgW~EAYZZLZ@XzQ_lX>XOy5FscBSdkt1W3r4_6E4wg~W@9utkW4+n>`tj>S>_bCz%uB?rC zX9hTIPzsWdRw_6v|D{|dmXV0$x> z0AudxslIwQ0W<-8H0Sxc??!}F5dh4H@|uGF{*pz!b6y*5-~E`4l1|$ z%1=ho7zQB?*5YAUw^30wiN0l*`cf9yMeA^;2f{ZX4od;SDt^CE8t^39xe7{EgQ zB!D(#fGBl;*UMZnx06Q${tuWD*vPZI@e{NC1bF9wp7mzD08{}!_&4Kd#TSLji&cx5 zKUOSX$}o;+xTUbWl3DB{ekXi1A!cz8GWw&bg2iv3c*2F14l?s(Tr%YLzTL@SEU`Xj z9Uwh;$REj?+nZ74+A)dF-}jxA#bRm^_)2G^Qc+(=2zaR6%T6xjIa0{GC%vr{AQRk( z9%)D^$8cZPqE|V6F7-_KsZTyQUQyneFCrB_9d)nqb?MDSWgps^PU}0w#pH9qed_%l z@F)fu#|l~c)v|T8ht0u&oRsPZj*BwHb(Am7D)~L=2f8JVAxUAml3L&6;71(#wMi#^ z-4Iv^>xI{s&}h6xY(|tFIDSgT>nMox%USL`XY-rcK1f^S@tee|!#a)oCT$7a{4qb= zYaVV2s;L@Oo9bN*jN95kS8|eQeTVxi25iD86COoS{2S+%n4lJqc$uE?r(k zK2KYs#ukAHC7JgtrR%W)_UC4Bf%{Ik>aL*a(*xC}NLUErvD`bw_gy7F#+bRr>)^dipwu$iVGbPJ zsKvIbUnWVum$R;?rjsMB-z#jPopC&W3LcaYaSl%`f=kqm7vahRcfdJd$NqB+S zbc2|Om)}=MEzPREYZW_gGt!U|v^rJm;>qKW6UW&N)ky?$BU&TGh;w&g_w*gLMo)p% zW);Ma?1SyD4lqthCQg@gWeL`BI=N2N{McV0=e1y~nHLW~M>Wvm$(eb}+NgJo<`q>> zQpNC%t4~ceD=iyKn{*kQRX>ESX2iLAB2J2g0-d?{?uBmn+Wqj-&-GhUBu~=IEx9CE zz#LW05r|tGH=oHqAI~(1;lW31GZ2K0+_1YXF|WQ+T3#%)P<-TAf%Y?|9z`~&KU>9J z)QY&dUzce+#oC^|H+k3GR#Opuc*VXnyiG&}c5&+6hRLG+|)-tJ({e%gu5$34uW?do1R-K9)G7eUm zDa*$RS&dbGLKcw@wD^saO#Z&8bEH+uprK47m>!HwzJSq`bzatk3o{?PNj?e8nx^B)9g zn;Xy*5-hb-E4D)SRnE&=J4T|$X|T|+njh9ZlQ*k%c$Ky@n)|Hou`Z`aG1PTmdv6&O zDRS_m>z_~0&4`TV2$Pj7~5$n^9T`68Ru zXk4p8t}IVh}jX(*s(0g3ym~#oJ7tGHYvtIVH}Tu-EN&na5ixb`uIq z<_)YY>FPLfE9iv2-+j?&r?|)oRd6Qar$q8=feETq5r9 z%`;&~rJiRO%zrUctUXLo%d8UK{&b{_-yQZhfJf&Ci4kn?+E%vf%CHMQ_&z zxR3Jqus$zrd1hj<2g!b3QdvRf$>v?Eqe??rvE+B3Yg5OLiunp{~Zw zaMQcZ&NM@kT8$L+D~npS{9>SE{Z+aLNvf{rm9WtyTVdS1#atPP>)OxN@^^2#;)M66<)2KZXa|dZND7xuzbAtY-Rv9~oOdb+c4-8qbK*@{^?^@N zdbw_7JK%I<)uhjW{8NTgvKSqoN_H+gGla#^6|V}i3(#|Yw@{dHqg~h$3*N_u*cDv4 zaq@of&3B4572?t~DV?cS+z!zsf<%X()|1!kc0=Tav z91fKMKRDxh8}>d0@+m@X%rfz+OTzL#SH$X;fl8^5%W4y|(nrelPHbwaU*U(1jyMt@ z$%r`?DBpWIEjL7mrIS=n1HD}r^cQ3uNMB3kM4`pqfjxsY;&d=&Q%tnh2zwOm!bHh{ zT%V40Qf{zy4N4MdV?<&}#ZT%+v*tp(>APRG^-eSejNuf!V@VVI!rgXz=a6@_Ss(e~ zA>A)XmETl^&zZW^v#skdP?)O`?yBgAyoBm7jH{$u(@Xajt%ZUzt10NQl!+DBYux%i#XY)5;Be$37d;lRC850&u@%dya3J zd|3hRS6&}H!s;}nap=*B1l3LVVEYG?vZFC%`{O*U$pT@|e`VbOtS?o;WCl>~BXLSs z`mv9Y4@7ND9lJ?E5DkR=n5DYFu}JHH%CKnIYSJhLnMgp=&gbh$fQzLn zdJ2%K!Wa-x{7TU$KCc`|USuNp?&jqhH8NTtkRBz2kH%J<0h8hCkGOE4C;S&m3pH_seMYhHlf1wATmK?%`E8Z2DQ7+ba!i4-0JT7bdFa>D=o4S>v;ALOLgfW0@zl$w#^C^Ijl0mvsQ|c2G+5U*vUmsNh*k(X(3`qBJ!Cbi6{7MlEv%DTG z5M&iz-&g14z4U>AG{z>tO$weQQr8xsN7j!Fz=g|vQsXTGgzh;10yR8XGyTUK3q;Sb zM5S@lQ??LpRublfDj!9)fPUp1A>qDfO~k~#P7zUQ(h>kS@+-79rA*PskF{kx!-OCU z!@g2q!U=u!g}`%~FZLe~N#oz!OM?W%MOdzwoz!m8{LzJC+{NJAm3D#ufkd&AXzcN9;NV~oDIAkP@Yo+!WFgc6CWJ!B`w zJ&y6UZ}>73-T9q|H@Fm{y}}$y4l41{X4tbC)MIM5XI$B@<*;0jEUAh3soh7o#Gk9_=PWJu9{yaHe7g#bqdrGT zKByiI66Kz8ZV^+fsPrnfKJy*jTJAQrr@@UiS!obAQswv#X`J1#W~2X}XM)onDg4 zxfEvkSCP9?Xwn{}q9g(|>VsegpalF!|20gmcQ=0P!&swg4Q+MS7Kfa+_{Sg4@n47H zx+vYJ@%4wdNa&|GlY!)=9sO+Tfo@S}Ks?^8@#^N|22mLvu}x1?OU%@ZMJx8#KSB0J zPI4&Zy^bg}AN+}>MMS{|;RU-1m4*xbkeb4#&o(@$wDy6*I3HC>qY#A8Bfg32u|3(> z4gOMHs=K0ke(a(oqa-@1619%^Tg~Ld?>AYA4;Do83p9~K-+%zhU4DSDQZ~zu>br_F zTi^c9bvV(G{1+MqwnUI3F-wCg5uW(=&zWX~btSC(Zq2h{JHcJfTfSL>y9gzc3iEep zZUNmt7SNs^v5O0z*0 zkl?*N>L%|D87x0QoLJgy^yd#4*s@f%P``O%S>BShO14I|sQ9VYvYRQNWDe1>j%K8f zp9^M9(P22mSdeTus2n-ao;U|9O@(3iqJ;aWYQ=Vwh-eTI^cCWlL57ZLBlvmejTVY!+8n1PF{PsE?7 zy{Q1Utwm--IbfOAqkJ=r0cRhlknJU5s2(R~kTlXym>t-SdlwFNk6rHqy5XinE^9C) zm3WsSv+7|w>40bJtCoPqb~!b5Lp$X+tMmQVyj|zsF|oL%P;&0*Cg&cqaVuySfVU*|7k&m zq9J*G2QY95+h+U;!Wc45#dN}o&Z%r|G>|<02b2yc4Z<`0;$aK-SXbeH9;Uq`B84VObC7bjTX zX_?|RLw!9dmftaP?+8v$PigJs?|ZkDSmN!H)Ep%WXz+YLwxQDK-TaUb4k>bBo&H@{ z$EB~lt+VY!6Sef{d_65F9(HXF4ukq2{Y@zP`<3d^66FH+46u%NLK9G(9`+kM#m7FfdvI zv&uv!SE4+=%=_~SSorO{T(C!>1p>-aCO}{Qd~E^D>2DJbSorD->>Ie<-S+>PU$tj6 z-$$=J(@t#1%i^nKSX?Gi+nruoZ`Ry(Wl22gvT_F{ga=F?2ttm2eIoPjYaIa=9OEhpu*9yuFViUZL~J83qP)yBujVW~TPjj=?h-Y$8(sgQ$4jyEU84SXW|H z(Z?>vzBFN}u{q@T846J&9haqVBt;di?b781VGjTY+a$d9MO`~mA#4MDJ5*0l~iQD(hFZEig$<;hTeHlR`{+^*+ z;HD$Dr-;-g))-B@Z)cPmduc(^eR*d(8m&diw8mA|8_X=~n}9&x#Dycb83&Lg3x!5q zJ8|Pjpg9dkO3uqKr@oAgL5{Q=n8=I+uFS5lpzoYpSci)%z7Q?qHeX*N!mK6)v0jb7 zQKXNVjEj}O7Adw}=~TCZ<4;|>mmiK^7vuJR}anN`1^}zaOJNdCG6R z=*puxti$#)#p3&GHydgJ#Dbs4HV7W+KD-IWQwG}JDWMdX<=O5zYQRH5BwFg9p%Vu5kc{}ma0BK zk1lKb&@!5L5@@bKjw;56QmYwA`=WfOh8b(5R47+Jv)BX176)HO&h1#Rcsj%5uL%#? zPWE@!?0T`E-rAJbyqGzwO&e70&r5oC(1qp0_1d(MS@vi5l>S}S=ZCDnK<{ld zI+JO9U!J^;1sbk(f;A@B^+nf)6hTL=g|iW1w?pl|f{iD&x$hh0emtG0t<54n8!fQi z^*Oj2Bzj%R&M$y;zT6ybc!P4%x6ayg6usVtuCr(rv#la#7w@Q=P9|4R13q>NjFBc3 zurjAhh&DO%Ti*^f`FSAkVr~2?5_3N^7TK7!O=LaZof$gQysi3M@^;x6^XzU1(xwcj z_v_#me(q%!w<}6F<;`dEJc&+kn@~-PLg0O$t;l)uja{!1rZ+usjt(u%b+_)x?@dVP zzO5VhxGBAjIF7Z^>{ru%QQDvvUrVLTJ9f^7V>dam+$m3?7^Ftq)r9BhyYDpTQWE}+ zH^PP7K{uT_$qry|jI`MgN;BSViN)n~{R@A_W+iml8#B1w??#?+f=F{>p9 z8Y~*h4}v#O4KsNMHs@_b0v zslo3$E~sL+GbXZUdEl>6`D2wc_Uz_^Wm#}q#m{qkPLG-TJtvbefdihVx_Yl z(%R%~qrn8tfkvJ!o3;Dmqdwr!2?PHm6(`baqeRk85BrGUcmx0Qb~hwmQXa^irhB^3aaYrwz{)i0lBLg?x1M=WRXr%UX&QmWd=A$!$@o+xsxd{; z+sKCHKB{wa-giYVxz8Q>C8T0dN=Ein#_25MCv(wcLX;Me4!{+2_V8n2?4kPPvb547 zf!Vz7uo&%-`X`5>U7-?C2Miox-VkvV!1*#F>I<7+_bhO;fQfm^Bg8Q6GV7ahtO+#2 z^#)#mUd>v(R2ADw`DQ=2x*;N8Zg~3%pkYFKw<+?cs4w8Cs3{SL3xquOWASJ zuG=g`CyHpsLXt1Oo!T8DOAYQ0ZoI@lU+D(>yN>T$m$)nMS|kU^@359_Y!bjPY(;nW zMT!9+pIsk57>`H^-8&M&^iYXBOjMqFV==Eu+5&8kpYP?g06%jMk+g!Qa7q_kV7hv} z){uQ-tFj&mc`8$d^O@f=b7zKchQcvry1c%&i6f3<$`;_GP!imZ*DnklPX zrS;JReb!EYv~88&LtzIEpFEBotr)U@d|5d16XdPh*XFx#RbhPLjp1R1}co~Q2 z1~4`V;|5^6k6!^1bH7(bs9S_PhqZW!SlTnb!1ApIA>Vo?tMZd2i$8^^K1Bv0*?Vw* z^)>wY{c|ADu2~#`TtLLq6&U;5=f0W5C;phNJLj3@)N!}tpCu4q`aib=BxPc$&_w_x z&)JB%K{nT7X{0`*J2J>bFF^h-o0nO#0Hg!taPJH7)@w52T6{p(?-2TmpRkdDe5S^%PejbCN3jKL*`_hfNKc@xg zQ6q5y;beWZr<@iDpo4(}xxlFWQU=6~(w7KO`RNdy`Q?My%{?T-vb#J^YVS@g2op7Ns%Ta+Xq*vIgb$(kAOk>B zE_KX6UVG-oOMjdwS-J@CB^3ojPDXY&hYg z+bKi;q^4OYx_T)3$WIqETR&ZPfnF-4@hh>vwX!K{d)XkXRxa4F7L{_<-(CVA9VRnN zQ#VCv`3aVC|E?nGY04+iXKjADzQp^A1}X0pU*o279^YBD>It4mx;yy19ZTuaMuG(i z?Kim`nnIadJ<;Gm1I?UM!uG_gyGgcS0@9Qr>mMK9PLxjLhBn*_QOO!HewVjv@V8mk zA=+R;2=!P8s!H%RZq^d=sw);RE&MJuyCV~Ijv2n6*O%QgXL)+IYEHIYRjm@*_%pi1 z((OE3-XTY4$UHxUDrjL~5lnj3mjvPzplYDW_+dKJe-oN(0V!JClUYB-@^{XMk551c z@Iu~Lb?9u8%5SD)@plvp+C>YK+PUQoyo#^nXEl#{2k)*FgpzVw<)kq<&3tVCrWXx*k>ytO6!;m9v!rtItbD6XYzx?#K%xBWcx z8(pHeKcwWJ6S78>kG>Gz2>_8Rdp&Ti2M0cXGih@PMqe<{7eA({qKo^Kve-vbj1!SJ zZ8Yr160bQ}CVpRi45x9oHNw0}n3#N{$h@S$7b-fCD}`Z~#G0n(5uc8O#EH$S$jF+` zDGu7yTj#AGTao-&d1l8d{k;N{ckX2;&AFsZt06Uo`RJJqZG-Ske15l$o%oav+q!eh zY_mQ!>Cg?1D03-w62I3K&2eK_IV|=-s;yK)?2UbOvBdDMfx`HMgv(a2 zI5uVTl+sq-7qD5KzwYaCk8gc7+rK03bH%z>c*ne$3ZSFXSulxHgKAz~*CY?>ylOi# zf>Yf-syPE%7ivqE+|Dn7F<&W9RfH&vbd!;%!j}h*4@SKooq_v6C7# zkpL@dDu8uD!q|@RM^S%=%oM4XvxRFJ0yPa;>fs#h^-K*yk<^yRc7B27P;SSSTuvxe z-Aco>aTNPAN_->}gp4xxc?!`J@7fYuVd2=pb-MIr5z%GZdI!5t(V=gH{GWZOx2M); zPej5JpO^s3+Dj=;QEZC{^t4B!KsLr%aq~JF7qi*#jr)@q?Ig8tDJ~GU2=7AMqJ~9> z?QB^yaS-h&y6Arow~T6j&_44534)l-7S<_%F3oc~Qmol}+M${+;G=Z{c(3LW<0woq zK>a>T2>S>n*7shD?uWxQYfT=M*n+pxNSp+AO93jwU(wv&JId`4i;N_0V595JxjVe7 zKAY84U6OX9@qAZB#r7OE@BN5US8fF94paR*1gBVWu2-V3ZYqzJeMEiUs(d(0N?z8} zHsrPA8`)AYA-(NWp6kPx(l~|Jl$7PxRp~Ci%5tDxTsx#}Pin_Hg=I9FK^i!qBjf1- zjb185?h0VcA#>Vr`NEbJ2=cu}ZO`}c$a%!yXgFPGx1eAP=& zGe`$|QS6ck7tX1B7Q>XJ<=J%Xh>8Rf;0J9Ui83EZF1)GzWl>^tSeoOXKfe|?%KRec zITd4~dYnQN*dAfdtuXWSVQVG8rG@&Qr_9j3&Bx^hJB{YIlpm(I@2D_IlJK7jwUH#TTBv2;E9U~DIBCaJjXI5B|HMAL4>WOu)hDSdHXx>&1Y?G4^%WpYLqd=5f`7=`*(Rud$n~{_peLY z=AqPQYvJ@lYF-Sx$j*s=z;n$R4-3T2u9&Uy4~v0m^*lwsJ)H$k7osHrxvj$?Nm6NAxzTpsr=-9O`)AUn5OWuw)Og@`zPRKH$iJAV7z3iG5s4KaiGrmQZA7x;QpyU|C(3Bf=jYzLpF7i2q(F~9C3`L& zE4n`Fxa9HU^?VGhIIq98Lc2ahy+9np`hl+y2HM}g$yz7=y|7)u%#-xXl*FJw0wF$+ zq3C7jwyYVgI8AyphF17GRs*`_PoW>U&bwxHwV|Ifae+1$v=}M8t(P=-?QzLF44GI( zL+gGa)wdV7nN4*%pG>2)bxK%Qb|MvC8*!xFzlc}5gJif+4E(`#Kwpyo9q0TfjD4~koFf)e)50bn!V#z16f}kW7s#d)h;ChC zLozfKf!5uLB&L|*Hctmv6r`oj0>Tt=FIn%@?wKtdtc-|QYJ~Ez^LGgnNoxAVmZInu zE^cdQlW$VA;<`m&PP@ow{7yInXfU1ueZaY=d=)r-g~E+acCui?^fy~K(tas04Co^^ z1fbMzd(M*vY+*@3N6(4)O-DaLNffZI`qO_w(mxu#w}mm<{|ykIoOy_)0mv6Xq)#sY z8~A;MWqVIxElRJDDG_ZzNZx5G3V%@BhTYn~;Vytr6Q4XHZT}|%WXUpM&NItC;ukZ$ zTYsb3e}J{42lwMTp2msy0t-nFp!q)-9bxppFnTWH=03n`Q+KF4$wUb5_u$TQ2L?nm z&IA4H2=K)jK$z{h0A|cYX71mFJO8+CO#hyX@gF;7vi)ZWKs^Qo$w$Th2ofje_J2G# zJj#Cr^OT5mz_|d2ZD?vtb^tgGAk;?j!v8l&O9h-FtTnne2%$hXu+ek;1OVgfri1$y zGQj6R{XPzH@EhOZN)Jz4;NCIF2Kr*^ws@&(u;xT~l6`2lyK?zt37LIx3BTp>GAJ>! zMB*3>;1sbgVj6#Q##F~tMqRzY_Hu>wIwK>qU@I8UVY0<4!A`)d~c~t4ke2XgCRn8zk7e7HD^xSoo;EP^UQ&p?z zzFz^edtM=E4TG!@7c)uH1R5bfC!4vheHKd?ke0TIY zw0)pRWTdy$dQvP3cK-bKGG=~I$L+$YSSJ4G7fM{lxVe-BOqp??2Y4DaC6(ejPK-29 zSAuv9RNe#$TaFVuLaY1VevI)sjT^<^5>$?%?HT;?KKA)HY|lG{R$2r4uA64IkG2V# z!%a{vwTdOd3VI9pt_VE7-CB^0w^7|n2_AKHPes&wx^i+|pqAd;3med(9uhWK6X2dD z{0gc~8mtGO4cza{&9XiuF{D=d6S;~IX=NMsiLA@Taw!pysNQKtcglN{uVItwE#6!! zH%`O&+81nL3$5;!IDRE6YTqoXo=!}yU$O=H(ilC{y~(Rql39>D=ddd&c~gNx_Ha6h za?@z)Qf_fl2gNQ_G+whKS+x4L=q+{PMf8fY!HD&8m^(s{n5$+}RfP;spyOqmv^RAj z;MX+7{dz&{{9w}M*hwV^l^n3!+IY~Tmw@l#pV#$)=cw0?LoS*g+$5&3y9Pcy)meTc zn!qulqa6r_A;Difq|FaQ?HZ2TFoC9zU;=My%k?&t#aB6>-U`Go;82dHawPtRj$vQ9U5L%-7jH$kr}67S ziKffCE4ya{7*3gDerY9LW4MOL>ueA^jbA6;z7*pjb#19O%~PX%8i7;9f}amYc}mfq zS<`2I^_);*V6F-pTm zTPLXfGgjm7?6+fP(UfbH<;YyplbpP}21CRC0=Zw5b-g~Bsy&HbA{cnsScS(Q zvb$TW0HwpMi4ZgU6r6NeX3>!R8l$tLjq*IWde1Fljx>f^(o6Rp?_5LRs?$)2^bPmEg)W|pl(f`{nP7PNj$uuah1<1mPi@f5nJ)Kfc&J;Urknt62=p8Oum^8B zx1hK3J69A}j>3z9zP+%Su()X9#?<;G2~oL=#c%EldK1n{vajo=kD%3&QYMCTJ&f8v znH*DQTbardOBZx?mQoH(gyZPurfNYz)vkp(&1aFdDWUan8Y$SY1|Ocjei7n%-7Z+P^K97Fm zfNRj2Jz-3s-KJpA3FFkUdI*P`k^6ykHIM!de+dX2d5tvK(uCy}5@~H#n44P5*57OW7MHA3I#h zE&ZQ;vNZIfxnVj-?8u>N+$_T`dvmjrnujG4-I`yNUGA%m_}&-GnG%&P7(I$(;Vd3U z-2Ext8M5$woY2d4nQfjO-bl_h?)9yOrVv$7#Qj8;^rdnpnr4+BMAND^+9Wp&HI5Xf6;Tyu^siWmlQ8@tY-hrT<()z>@&vdem}SOI|{e!-<`=fKprnDh6eK2&9pq+A`tIPgYQ2*qT65U z{2E;GoZRN%{L=xcP_~BpqJm+;8RKFB%_+;UC?VZ6tjvO_f01tnF-0qR#unYb?=p~N z)kHf;G|USB__Uqx;7&%~xUS(w>A+^jw@9%fNyow}2i(j9zL~n~wX{bLPx*6ZJ`W8n z{e0fXsrglC^XUuV`>9GwlX^T=qioDrbS<+uhuSSkyRV>dLT#0DII3-yD$wyNVijlS3KF+`?VF`aQl**Xy(5en^cb{;{5b zg4Qq3IiYXk_f#fX$-jqS6AVekXK1^fb-aRfJXZ*N4_{|Rr!i7hKjZ4I@kZx2BHkzMJoeND7OEI_Mlm!; zVgk(B;{X6v~b8~rna{)`VbOLh^Rsxv%w)C6A=$&B9deE zs=Z!jY2PO`1(iwQin@G}Xj8zT*`4%97pHn(5Z#y{8C+g;X(T=kvk^XR3R;Y~aWddK zh8&IkWGq&%`ZYn2>L8n$j0Hab#Vwcy%6kI{D53g^ff5QzQ8jeWxVb?>At=m;Fp(AX z<|ZR^90W2mCnN9UtxSF(0lANiH;HSOF@DkchQIc^Xfo)P1P16Gx>r{z)+8B0egx*U zJ3bH!CEeHHFg1y*pmP+|m9J758RNJGK%OX3JsRl@-19>A(?|)NaZnZG^)f5Eo>;~~ zbxfh98VDapST*^H{ey_mVpa;8UI=vf0nX2aEP0AGIk{1gM9GE$FwbxXTG&WJi-Tnb zen2Asqgyvk?PYK_6Ec|q1E$PoO(uq&*cA#oU(g^KAOvj46e)p~DAJ1-uq;UDgg|*g zIKt|_T*DD^ZF-P84vh3Ku6|z`81FSMup7XoaY0M@O{mb8BG3t_evd3?X6F4T#P9Qx z=!jJ|?WQ(?i}PM{%&9>5+zC6793WXw{NyU%XH) z^dL##sE`7s2`7pA0YQWShQ_hY9Rm=v;-M3E%Yn3j9mr;;fA?2+?Dr9?n-Q(s_CN0d z3l>q$^ZYG!9VZc)&DG6XbKK?hYDv|5PoCJZjn%Sqo-)v5ic=gZZmM`tuZ_s}zO{Ss z7T6ld%s@Vq5gsvOoLI;h_2x7l+~Z2zy3M%|bTV16`(J84FN(widK*j_%EDydCvePXjR77Prr z9i1D@0osH%$cxDU{SRQ7s?bvCo~h}s1S2||2;%;&@lEUsFG(eV^=k4}6DsxNa>M zWDQO1QM=hlW#2N1=+%z)?kK%cre_xTygXRWB#yQ!tW#WT&1l1AR-gJWlXua-?H5|= z=>zlM{7&hNXb@K5qt)$fFSN~&HT}HM)G30%%f8lH;CK)tZhFL0MAB^O{)V=uN8{0X zU*!I4lQz|q zJd4XhV)x7}NFE-RZYv4vNpzDfgZ}I7i+2o2;Mn@sAEE!~ zd(?VN6)v$XVbiaq{@R$cEbrTr+u!SRQpXJNs#OY7q+bSlTY1<-Dtqx9Y7a)O7#VM0 zKkzKCd`s(S?7xwBbbqX{sq$~AWF<+mC;#q;@%JA}?~cWIVr*Z7Q?+E=%N#x!1_(Nb zLGWSX<+@4nvz+BK+XLMr=h-u=$)CHD`a%po4`SUtj<3(r>V(o99>31_Yr3J@!lbp` zT=>xE%0pEMs~3MuPiG_9&D5SoPJpMd9&5Pb!|#MfJvRDViYJ7wZ2)cWPQ`Y{Y|4?1 z}89V0x@`0oN$Sis5s{Q`rF!O#p-zcF&W+>tUq6Iyr}o^WS8-J9$@p~FN@W}s(;kVbnpPVVVO}y=`5kQ3wM5!BTinzJx$u(KU*ji*Z>@ z$xWvsy-e(sNZ?9g-?H%SrNAxq{$a77viFq9aC7K}HqSA)jo(%iceuC~t_u6IMl5}j zl=GR7))-i|iWpcZ+fI*T&%1t4$PFN905mU$NnT{|TJn@k=%iQUF{|HT;XJId+T18L zQlBpG#UN$(k>9NLL3-Mp@pZXL!_7=OLCKRYl4BCtj83+C&cb`?t1CWZ&_lR0bY4<1 z`}utc|Bks$-xqUZlZPrIVEK9kTQXQUe~G-^yK6g6M3kf%XtGsTmt2spB;v5{8O!MB zdGd)W?U?DQw_~T@%BmH+_hEO7B%EtYi|T5Aerd?Sqa`7lNRL77SGKkc&63=aIBe!Q z=1<0L7DGZmib`e6TD+(=tR$=s7ABq_$+j4_*BNiIweb~vMy)BkE52Ch$^Mn&eMa_u zdh@8o4=8$-#xf=s|HhZr^H{~c)pT!`%64G=6vbtYOa`d>mDV@8g8RAGpij^-1N!yM&gvTn48roj+C$vN|5Dn4=O30!q>h zsm}XntzHwZ(zk>Bap{xK-+!6zZmIsV99TIdF=%29(rIT|wv)`)el$!sxxm3_e>*js z+&z&}#l0$PweOc`gw*v(!%%E4lGo?Ebfn%T<5!nG7ha0iWZcz$bO_Qgjmhr#ZiMV% zqAZ^8GDS+H`66!gdv7VAdYaB}4T#F8O9{Nam(Lf$;LE{5IyRPqaB6pZK^Fw4I&CT* z;7x>o&;CeG;hg+wU-NA0F-1cOu~F=+|1BqBOYqw6w|xgC@5@OKlm~Wc}`v z#&}EHr*!Figm#Vxp{xZBw8I(GoFuL@TQ`wcI+t(Y;kTAr(%yMGg|!Gk+|0kBv?Gqj zXTavoKP8xcQdj(eigmMXnA$1xXwJ&`NpS^+s&MA=uU0E=9nXF9M7~6UnUv?h=~qQY zJ_mf*7GL-s>ryxA{;TqS+sO)xc+lOhO>x2U;>aOg$2B{cMHwKYlLEG0#Zo;>Dp8*7y5`xn_Y(hD&vs0|!NEva#`!wL z#8hXds(+4E#ZViRV6GW*Aa0}cNQqUK4MiI=`5~DwGm=|?mBv?0GS7>-Y4QfL8cPx> z9enFW^DC6EkH5~IE=(oG+j;&FQ5^7Q-I-eFNm)%*(Z?u}z|&G6RCd(cLmF)jGbC;! z)oNBD^0x2yZN~Db4sQ=KOGK5;7*9G}=Z(g9+0Wj+@FL}!?X0w6-u8t-UOtgeLk`=p zgTf)N7FX*k%D=?9ew|RA$sQ@qd05LT6mQoBPBN1-whwGBEsEs+4RztzR_fC`EiJB$ zknJEgo}cgvG>RD+UtiX0sb=+H)&Kk)mtXyQJ;<+23@Dr}%#zmd?ESTGcT`}t+2hz* zOX;bBgg54_6nF|D4iIAe2KovDP4{UDI5XFqB8yPG!CgfXe-mH12 zyu2Vt;Ur#j6{n7`xSae0A>L}np!NW~kU6L);QY?y^0iX-ece4Mn#t`Bs@ zTXKOrV!2TUM`W_)%@l;)0jS8?wEek^;1JY$e1=eb%K9E$jJ2+8ez6o!z=ww)B0!qZF$ zMD#Ga%qaX}GxLFDlqgBfq8ctQwx_BKq53xu;L$hHtTqs~bsF{)b*wfi1sIl}1O_8c zctq)kL>NwZqA(S7mB!1$frU8(2VHnF7K5*hG<8kbf(+m&f*yrjgz|hkuB7{ryyMCX znW{y|Y?&OZRsA}D4Ecm!#PZNpQ;{Njd!h3B6b64$Vj}d@5?CfU5rHjibTFKVFj^uA zJ5;>5g7o@;ANpxkj0jmuQX9}b>>WW~=o57vzA9+{aV46JrxzmvI5IBE5KSb4ZZd)x z9umL(46G49C8^g_d5{Qb;YA&iqI5*iEkbB{wxJ7$0AmQc0~~+Y zmZ0BZJlh$j8jdGDjR_YWFa=w@OF2RN)4dQ^5IF@Y>)e+wDi=~Bjki8!l|SHpb6SH^ z#f*OzQCQqxIQJ#hBwCaTG6*8(W|>$=+y#7f=Kpgv2!k%K33$+V`d|ddNyx(WRNX|W zFxDE9A(9|zM$%+JjRa~+zQXjR{~CXP6d)D^T>wK9md7ED=7zg$9{`52Klo&S*0ZK7 z0;H-pNh?$l3%*I*IF?f4}Mq9sfu;tPGSy`}=uk%r`xNL8XCwzKSz&%9gH_rC610o$>Uv z#r6SRf9kWJ@qB!G#ZL}wjg{+OOC6*m38}VPLo6qIUz?=fU9n?08zLdfpjT(>ct>q% zwISoBwX=v?362%u=Is~S>~>Ikph8Qeq;kMe^CXvtt+6GZh# za-(e{_+N@@5QHY~x==4lQcP}hvQha2=!%oKfo++B!q(!B-NND%_@`F$k|7%sMj5*YXq`xJZa2DqE*_%e275QY@oGiIil)HD!z_P z-K|w%T$^70U@iK_NyLyfSW7E>Tp}mrTe7N3t?&pt z@_}5&@K=`AaYp>It)tyvn$^NDF;zV>+420jq&YBc<7SSA2$80{anPdUcu<-gf&Grp9Ir3P_kC`v#@4gkKmRW=_mCEvD+A3 zCcVxDD%%+iM8ZAB?^}$Rs}SU_H8_leoT~Tu{ffq$4o$E|qGb44H5XsFy{xl;{(C#@ zEj{+BG?J~gjQ)Bp%ls<2&F$~~3x;1=+E9hxj~LZ_vfad#*_JLn9b@4GRe8C{>l#2iRvX@tPY#qYJD+m8l}*8 z=W52o79(fTZZFvr#uE3=P9Oe`D(3G+2l!M@-g6+ct>mv`3 zOzC9vsG}g&UJE_jaR0<-f)N46>@cRpa;%zHPYoEi4oVXSTjCQ6udTx{kzRqVj;xg8QYF|nEutbi-(`0ZBrl;sNHCP z6G2?f!J9y77R_ZZ*xsY5+*rX0J5u_YM?=oF!5R<&+YXc3G8}ndZEZGfNTbA%dl-pX zI{c}@an*~|edMQB*4?7VGdX4h8o{j6Ly7PHay@B|v-NlK9WfKQ2KzmJi+Tax>k)T+ z>Ke4v?9DeowQ|Jc6TyrsAL)fPxND(r}zRvdO=$Uiv*0QvUK!GSIX8msT;jt$mL@Bo zlKi`2NyHZNM%PU>l%I@cTR4$t8X+ggRly2A$M61GM&et*9>fS zk9~+4;Mc_>YJG9OH8}M4MC?25ZmRkX{KCTH(J%>82bB_zFKK=VTh@fs$I?%)2Ioj~ zB5?>Y2!*|!W0~A4^0JDuIFz;a*5OKp<^88(R@mUc)|_mN!t9##gbyu+)^Mz|m9uRi z+(GgjXShykV`iJYXO0`KEEl_XZ{z{bi^UF6`iOk6 zWZRdgyYxS+ubcLrX5*nWX1-Te2?hz>d3wr~WrEU{Np+C9y>(Yf|3^h-wVRFU?S%N4 z7l%yyxmg?CHcdj%oZX7{Q(s5U51KK`pLL!U?*aD79;fcF(qXh}MM8V&U&jZ_SW+F| z6xq?kLlkV&xz^1l6U3j!t!Es0+iV<;cNI+|x&)RHbVHpg89&kuiUm}Q=z??MYL91! z=UXlHY0Z4k?;XW9XsyRNpLAph(Y;ErdlW7ocAzpL*2D_X*o|L$;+_?rav=jAe6B}a zfA~s!gp03QIAr&&?>=6As22Q{hHR+wh@i?aJzPsP?0xi`%4lJ^= zyj^L~W-nG9+_;HBZKKmWN66z(6fUu5)V9rIfFSW?*e;n5seJn4o1DsF$}wywe~z*s z$zOhEe$Y5#qc~fd-`m#nIhc5ER6lEj67=Sg17{}M?^=Q{@F5QBg5y1PkO61@Hi$hF z?VyKlv1bS8&f~NZOEshX|5(~QdeA3L3I%N8qmxN50VJT5tgo*J`y{R~90HsLfRF%T zZT5%yf-G0HUR4MUi(sL0LGldn!4>5uK!Pfy>K?=*CJmvfc0gw9C4R&OiUXd=nYqyi zG*$z78U(N!*cs0H6eaL3K_lK?umVAJ0AfK36eV%x)=6Vb_}PpEE+{7@3!QKa03;xF z;`Eqs@E5d%3E_fFLjzi%nSdmSllOR40be=5X#g+{mlQx4=3fCDked9du|MktfA>o3SFXV_+4U1V4`K_cYzy0s|1pGCGdsSnJ3a{S+8&QVkW)~KO4J%kdVN7 z1q28HE!ZL8!`eDJM(=HOHUItb|M_jsGs~$RT9A0-gN|A(J^jZv=Uon>{na1e7WC#) z5&j^Ffc)k;MLBU~GW1Wp46CtXGV!Zt(Ir3R>s&l$&s5g=m(ownx0&b@SCLMyH`7A# zTAzO!=A~P=gC}^{ZV2!i(SfBTbG_EoJtNw_S*y%5jzv1t0FZA)HYzpoX7!cUaorKQ z7@7{9AD$m9Au0qpN-9lBGH2jR0UAbU%o^C%7X^@9B7qY1)0zP zfhxI@O8+Vbs4WB_L0B!&ZvdU-51>afv`-pxIQ-$_-G>&q3o$QpvazB!PZ|!VZZ9ok&Mc-o^s}6;>D+)>|7Or0^1<1dvYvb@jP{PS4f@tzyBD)sPc8 zv$%LShd@#`NQk%8gFv1*Iwjj{3=LCqp{xL1u$bN-@yL+bI3N&WF}FPQ5jwM02xyt3B5wbs=}_z|Uj<1*MV)<~0o>F!lh zhvFv)WN%!Q`N^}9*jNq^B>cV_qn=k0G}6(0`z^K)eKl^nm-|TiFY}Z6clp2MzhQo3 zMt$>AISd;Kn)T*r)z==7sP87~ImNHs<~;0hj~9w8rBdm2X*l3<9ma9&XT@vluR(fm zvNekTC27c&aSO~E#fd#kjXB8n$R|!ar8dB z)GyV@@+x@}(_fo%b+x1Q#?5j5bCVj37B@}ZwLc8UiWR#tZ*ZMFgs&fOuioiT2||#r zsq<>F39w?a94|iK3iWZ}I}VujQqesM$*avM0I|~v`%RID4)`Ms@>+~wUsnu_1F&@$F5x1B*vOR33udgKO%|%dY>-0YVxXo4} z*m{+HatZg|f@Xy$+jG?S(j%4Gq$AmCMK*<#rxk%YW+zS2`R`}7gG`Xx0ej#V>v>U) zbuvw%tXk3#LT}fDng_#e3eHL5BlJR4TXBXS-(VFLuNJ8L`~ET1)9nt+v;VNVqFErz}Idt2PHAWGwU$@PgIy}kK zn)@4-*0TvCqfe67@kd6S1$nLMW@k55?o9kuU62?gCf1{HoV`!;*&LOvXwDw0uZg@} z;8#2zVzlqsl~X1zT@L3B`Q?R6$u}pQw{ZBbM3>WcUV!{NePx|9?sGaH4Zgo25<}Ml z-6-|)vwp8GbDpHzB9NGul9LhXz-;J`%}xAVuATKMx1K|3cUJ@MFLV~3k9LsdWrjOa zGsf?lU8`iv`}cG<)86^#zWEa23VuhN=-qcmt<%bh7SA`J4yMhc=FwfB)J%SKe(1}g^}v2{-M5suxduhhLay>cp-;^I6K zy)06XM@a4k-+K28v#scmZ;Ou77It)Pvzx%pbigKxoYQ7JP1Sq7{@~`cNpIY47>PO2 z(|iNnD=y|AAH3GS-Sg69w?Jzf@!Iy@UORCrKd(ubc^I78$g77&Lp$o>p#2+_t49%Y zXSOY<_;0J~xvCH5Z|7CI*%Q)H)BY5R>)OtEU*Ji7FNBoDK+-Oy+jqtxw>G7BAH->m zU6(avGwS!u)M9z@jo4pCz;pd7Z)KZr9$x{z1$hVaXu7{i*$aZ`=kSpzLw-e*Xx^bt zs;!oBj~ZdVf#Ty0+imh6iPN1Cnd?5gVU~-W-i&L9eRy$4&3@;u$qx`DKTNEI?fdsd z-W!e&^WQS2_+1ks=9FQ@`^h~V06E6VeZ}ywKk!fLiR#fJEV2=KP2&s8^B_(;d9(`7 zL99)X`~gpMEK8Arb)~cHSAMVJ;KpmSv99crR1JTt3YAKFS3lsA)Dv zdNuRI(H`~71;`j)-N zi1u{YTRJ9Wt|e~>-+UQONq1Z4JMxNqzvfm9aU1IJ(o=VhjCCkCim5%J;P(!MKM_s6RcPMtDxD2yb%ErbPq0PrxwJe90w&d60t2AoLDXtt%E zQb>Omz2P_%D!Hnpw%zk~vzlo3DsKys(*OgnV`DvLMLi)RV9lrpi8Z}&o-%VHQX`{M z^0WPs{pe{#TN}or5a*sMTbyFFewKoFzk-8{@rcwMbscVl$9X9qH=RR`v~0R7fjV(e zIA@If*e*$VXwwwmvR>QkEo;;8R$UWZ8}hr=^xjJ9BfR8Pc7xH{Y^5R}9-Zd(3ets~ zHtZLOf6XhtZ5!S5rAY-=qf^1jY}*(Au#|iBQJ-=MS+m*82*KmnQ}2@Qqr5yO2I^l- zJIEb_uk)M2m*_&td&E( zmnSbUTw3SCk%@0S{0x-K(iKxy)yICE7ZUTVicsynH^y5Pr;F)4n59e}aK_Xce_UqJ zQkPEQgeyumH(ZhQPHW_SZqB4Wfm`20ZU_;m5jpT|cK>(Bc3zX-T1@2K0P6bZ`x+yA z1z)NKh~8$sux6;h+=1`g3oXO~rw44CKd#k{lY%oQ>E^^L0yVVEAD%nI5zF=M)tKt^ z>v7!e9N%&kjV)TZq7IPz!QV<%OkW4rw2r-0 z0M;)nJ_uEae+W_$bpg=6(mi6ry_mkQ02nV;kYqwlmW-XSD&*+bf}K#qBGj+~2sA+$ znOUev|2#@V*>z<&Hpvn)NK$y9EK7>U_Lo(FxLuq!BvxHhmt1T<02E(vLW}~;UGiv9 zVO5Byhj!U0ffYdN5BmeWV$1@`77mp(KF8Pn=z^%f%mT)N5BzrSssOMb(nu8CQjA(r z5}M1e~;g`NMqo$~Fop`ah=4xxDzBmkHq zJBWk=ofg^^F#|*d7p=i@o2xFrovXQvgEQ zhn%_p9|(6=%t@BR+ne449Eggu{};mUjL)UY;M??P*jh_qyD;|yP+ERDfADSJ^KZ!J z-<}z|lprAx&vokpF?u`=5@GHKNZx8aC1@EyYJ*6L9#I#x@=Bo96*txU=Q*hgg{N`f z%>;p8zibCL&%Oqlo~K#GA4SiOin<{QnvHHoR5y5eFt!5NDe%J{25?gej6QD{s`!Y5 zkigcSld26PojoEx6n8xNhcH!{J|n6iwFkjZ2(_Q9I0WCCGVVhdnSIee)Nyx0bxk57 z&%C$Ki9uwgh`YMu_c8@QHjxih`=1sER0~amd#i_5xIZ4~D;C=Rfd05mjHdy#N3_lP z01msQvDfhc_8JomFu_3DO>}=Mfaf*G@3?<+>Ov+Vs&?(IDI0K||112-F(rEQsm_ zimL8dRi=P$D6}-#F8WTWWq^ zer(1lMt*9=@1TPx`E4|Kko4!W3Ovq#}pH-T%lO{xN7+hh`WcbtxB%&MlAqIIy^opaIU$-58LJYxY#Jegviha3)N)sU>Y0aq0y&O#*N$LKwUmRRBDU!kyRK_`k*u3GPu_W+ zJXWXn3_DxI!f*#P$#OPWYtpVig%%;ZLzhayHyJqm-!4`)T8q`^A{pF z-Dnm*{fg>YhT|{DRF(?HEIv4Y!u*W>Q%$zEsf%8hMg;Q8{$x(JqL)Ya2vL=YotPk9 zbXvv=Vl(*xueY{r(ZR%iOe9!Gj58%2we436i%5Jy1dEud)6nmy@@y)#XM94MFZew z*NAni+7aOecaN-QcxLlnG)@YZHY~bjFbYo8!+kM~U#xs4*zyL8DnmgsR+_6| z=P7Vl!4NQ&(E*j5)3?SJeM(k5iatU9@5Fp43qr)jT+59tv%Zd(s$<@%rkoZ!i2x32 zS?1p(eRcG;>|>`~+ot|hLVO<6&%T$5&L29!E33WSwVTE1dimgiiA6rllA&udz{XUdiqSPMTMQX3*Gxs*^J@udn)wOGoQa! z&UM^~GDmpX<$RLZpfNf6RO#W&w;}&Z^m)lo$JwbMK4X{#KMMPPmzhZ>>xpJRtD2qU z>`g>v1|{tekQs(`PA#8eHKNyj_)PKoOUBUO@a}axZ~KiwZR$A$m21ku>ncC_zPupv{SSdk|ksx6`ee) z*qTk&;+@*V7iFu#=)P#_v>hW6pa-6_WX$q7CIQumq=?F`;D`p%Jl7Hb zJBsfutZAi|d|(fVoOEuLd{SvHL$1E)-&a#Nth%E%0AJ$O?JQbJCC*Nh%XB`w_lw8+ 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 H{PO<*UMNZn literal 0 HcmV?d00001 diff --git a/imports/ComfyUI_IPAdapter_plus/examples/ipadapter_advanced.json b/imports/ComfyUI_IPAdapter_plus/examples/ipadapter_advanced.json new file mode 100644 index 0000000..ae712dd --- /dev/null +++ b/imports/ComfyUI_IPAdapter_plus/examples/ipadapter_advanced.json @@ -0,0 +1,618 @@ +{ + "last_node_id": 17, + "last_link_id": 26, + "nodes": [ + { + "id": 4, + "type": "CheckpointLoaderSimple", + "pos": [ + 50, + 730 + ], + "size": { + "0": 315, + "1": 98 + }, + "flags": {}, + "order": 0, + "mode": 0, + "outputs": [ + { + "name": "MODEL", + "type": "MODEL", + "links": [ + 20 + ], + "slot_index": 0 + }, + { + "name": "CLIP", + "type": "CLIP", + "links": [ + 3, + 5 + ], + "slot_index": 1 + }, + { + "name": "VAE", + "type": "VAE", + "links": [ + 8 + ], + "slot_index": 2 + } + ], + "properties": { + "Node name for S&R": "CheckpointLoaderSimple" + }, + "widgets_values": [ + "sd15/realisticVisionV51_v51VAE.safetensors" + ] + }, + { + "id": 9, + "type": "SaveImage", + "pos": [ + 1770, + 710 + ], + "size": [ + 529.7760009765616, + 582.3048192804504 + ], + "flags": {}, + "order": 11, + "mode": 0, + "inputs": [ + { + "name": "images", + "type": "IMAGE", + "link": 9 + } + ], + "properties": {}, + "widgets_values": [ + "IPAdapter" + ] + }, + { + "id": 7, + "type": "CLIPTextEncode", + "pos": [ + 690, + 840 + ], + "size": { + "0": 425.27801513671875, + "1": 180.6060791015625 + }, + "flags": {}, + "order": 6, + "mode": 0, + "inputs": [ + { + "name": "clip", + "type": "CLIP", + "link": 5 + } + ], + "outputs": [ + { + "name": "CONDITIONING", + "type": "CONDITIONING", + "links": [ + 6 + ], + "slot_index": 0 + } + ], + "properties": { + "Node name for S&R": "CLIPTextEncode" + }, + "widgets_values": [ + "blurry, noisy, messy, lowres, jpeg, artifacts, ill, distorted, malformed" + ] + }, + { + "id": 8, + "type": "VAEDecode", + "pos": [ + 1570, + 700 + ], + "size": [ + 140, + 46 + ], + "flags": {}, + "order": 10, + "mode": 0, + "inputs": [ + { + "name": "samples", + "type": "LATENT", + "link": 7 + }, + { + "name": "vae", + "type": "VAE", + "link": 8 + } + ], + "outputs": [ + { + "name": "IMAGE", + "type": "IMAGE", + "links": [ + 9 + ], + "slot_index": 0 + } + ], + "properties": { + "Node name for S&R": "VAEDecode" + } + }, + { + "id": 5, + "type": "EmptyLatentImage", + "pos": [ + 801, + 1097 + ], + "size": { + "0": 315, + "1": 106 + }, + "flags": {}, + "order": 1, + "mode": 0, + "outputs": [ + { + "name": "LATENT", + "type": "LATENT", + "links": [ + 2 + ], + "slot_index": 0 + } + ], + "properties": { + "Node name for S&R": "EmptyLatentImage" + }, + "widgets_values": [ + 512, + 512, + 1 + ] + }, + { + "id": 16, + "type": "CLIPVisionLoader", + "pos": [ + 308, + 161 + ], + "size": { + "0": 315, + "1": 58 + }, + "flags": {}, + "order": 2, + "mode": 0, + "outputs": [ + { + "name": "CLIP_VISION", + "type": "CLIP_VISION", + "links": [ + 24 + ], + "shape": 3 + } + ], + "properties": { + "Node name for S&R": "CLIPVisionLoader" + }, + "widgets_values": [ + "IPAdapter_image_encoder_sd15.safetensors" + ] + }, + { + "id": 15, + "type": "IPAdapterModelLoader", + "pos": [ + 308, + 52 + ], + "size": { + "0": 315, + "1": 58 + }, + "flags": {}, + "order": 3, + "mode": 0, + "outputs": [ + { + "name": "IPADAPTER", + "type": "IPADAPTER", + "links": [ + 21 + ], + "shape": 3 + } + ], + "properties": { + "Node name for S&R": "IPAdapterModelLoader" + }, + "widgets_values": [ + "ip-adapter-plus_sd15.safetensors" + ] + }, + { + "id": 14, + "type": "IPAdapterAdvanced", + "pos": [ + 793, + 304 + ], + "size": { + "0": 315, + "1": 254 + }, + "flags": {}, + "order": 8, + "mode": 0, + "inputs": [ + { + "name": "model", + "type": "MODEL", + "link": 20 + }, + { + "name": "ipadapter", + "type": "IPADAPTER", + "link": 21, + "slot_index": 1 + }, + { + "name": "image", + "type": "IMAGE", + "link": 26 + }, + { + "name": "image_negative", + "type": "IMAGE", + "link": null + }, + { + "name": "attn_mask", + "type": "MASK", + "link": null + }, + { + "name": "clip_vision", + "type": "CLIP_VISION", + "link": 24, + "slot_index": 5 + } + ], + "outputs": [ + { + "name": "MODEL", + "type": "MODEL", + "links": [ + 23 + ], + "shape": 3, + "slot_index": 0 + } + ], + "properties": { + "Node name for S&R": "IPAdapterAdvanced" + }, + "widgets_values": [ + 0.8, + "linear", + "concat", + 0, + 1 + ] + }, + { + "id": 17, + "type": "PrepImageForClipVision", + "pos": [ + 798, + 145 + ], + "size": { + "0": 315, + "1": 106 + }, + "flags": {}, + "order": 7, + "mode": 0, + "inputs": [ + { + "name": "image", + "type": "IMAGE", + "link": 25 + } + ], + "outputs": [ + { + "name": "IMAGE", + "type": "IMAGE", + "links": [ + 26 + ], + "shape": 3, + "slot_index": 0 + } + ], + "properties": { + "Node name for S&R": "PrepImageForClipVision" + }, + "widgets_values": [ + "LANCZOS", + "top", + 0.15 + ] + }, + { + "id": 12, + "type": "LoadImage", + "pos": [ + 311, + 270 + ], + "size": [ + 315, + 314 + ], + "flags": {}, + "order": 4, + "mode": 0, + "outputs": [ + { + "name": "IMAGE", + "type": "IMAGE", + "links": [ + 25 + ], + "shape": 3, + "slot_index": 0 + }, + { + "name": "MASK", + "type": "MASK", + "links": null, + "shape": 3 + } + ], + "properties": { + "Node name for S&R": "LoadImage" + }, + "widgets_values": [ + "girl_sitting.png", + "image" + ] + }, + { + "id": 6, + "type": "CLIPTextEncode", + "pos": [ + 690, + 610 + ], + "size": { + "0": 422.84503173828125, + "1": 164.31304931640625 + }, + "flags": {}, + "order": 5, + "mode": 0, + "inputs": [ + { + "name": "clip", + "type": "CLIP", + "link": 3 + } + ], + "outputs": [ + { + "name": "CONDITIONING", + "type": "CONDITIONING", + "links": [ + 4 + ], + "slot_index": 0 + } + ], + "properties": { + "Node name for S&R": "CLIPTextEncode" + }, + "widgets_values": [ + "in a peaceful spring morning a woman wearing a white shirt is sitting in a park on a bench\n\nhigh quality, detailed, diffuse light" + ] + }, + { + "id": 3, + "type": "KSampler", + "pos": [ + 1210, + 700 + ], + "size": { + "0": 315, + "1": 262 + }, + "flags": {}, + "order": 9, + "mode": 0, + "inputs": [ + { + "name": "model", + "type": "MODEL", + "link": 23 + }, + { + "name": "positive", + "type": "CONDITIONING", + "link": 4 + }, + { + "name": "negative", + "type": "CONDITIONING", + "link": 6 + }, + { + "name": "latent_image", + "type": "LATENT", + "link": 2 + } + ], + "outputs": [ + { + "name": "LATENT", + "type": "LATENT", + "links": [ + 7 + ], + "slot_index": 0 + } + ], + "properties": { + "Node name for S&R": "KSampler" + }, + "widgets_values": [ + 0, + "fixed", + 30, + 6.5, + "ddpm", + "karras", + 1 + ] + } + ], + "links": [ + [ + 2, + 5, + 0, + 3, + 3, + "LATENT" + ], + [ + 3, + 4, + 1, + 6, + 0, + "CLIP" + ], + [ + 4, + 6, + 0, + 3, + 1, + "CONDITIONING" + ], + [ + 5, + 4, + 1, + 7, + 0, + "CLIP" + ], + [ + 6, + 7, + 0, + 3, + 2, + "CONDITIONING" + ], + [ + 7, + 3, + 0, + 8, + 0, + "LATENT" + ], + [ + 8, + 4, + 2, + 8, + 1, + "VAE" + ], + [ + 9, + 8, + 0, + 9, + 0, + "IMAGE" + ], + [ + 20, + 4, + 0, + 14, + 0, + "MODEL" + ], + [ + 21, + 15, + 0, + 14, + 1, + "IPADAPTER" + ], + [ + 23, + 14, + 0, + 3, + 0, + "MODEL" + ], + [ + 24, + 16, + 0, + 14, + 5, + "CLIP_VISION" + ], + [ + 25, + 12, + 0, + 17, + 0, + "IMAGE" + ], + [ + 26, + 17, + 0, + 14, + 2, + "IMAGE" + ] + ], + "groups": [], + "config": {}, + "extra": {}, + "version": 0.4 +} \ No newline at end of file diff --git a/imports/ComfyUI_IPAdapter_plus/examples/ipadapter_combine_embeds.json b/imports/ComfyUI_IPAdapter_plus/examples/ipadapter_combine_embeds.json new file mode 100644 index 0000000..f961f67 --- /dev/null +++ b/imports/ComfyUI_IPAdapter_plus/examples/ipadapter_combine_embeds.json @@ -0,0 +1,1538 @@ +{ + "last_node_id": 51, + "last_link_id": 118, + "nodes": [ + { + "id": 5, + "type": "EmptyLatentImage", + "pos": [ + 801, + 1097 + ], + "size": { + "0": 315, + "1": 106 + }, + "flags": {}, + "order": 0, + "mode": 0, + "outputs": [ + { + "name": "LATENT", + "type": "LATENT", + "links": [ + 2, + 89, + 100, + 111 + ], + "slot_index": 0 + } + ], + "properties": { + "Node name for S&R": "EmptyLatentImage" + }, + "widgets_values": [ + 512, + 512, + 1 + ] + }, + { + "id": 16, + "type": "CLIPVisionLoader", + "pos": [ + 650, + 80 + ], + "size": { + "0": 315, + "1": 58 + }, + "flags": {}, + "order": 1, + "mode": 0, + "outputs": [ + { + "name": "CLIP_VISION", + "type": "CLIP_VISION", + "links": [ + 24, + 96, + 107, + 118 + ], + "shape": 3 + } + ], + "properties": { + "Node name for S&R": "CLIPVisionLoader" + }, + "widgets_values": [ + "IPAdapter_image_encoder_sd15.safetensors" + ] + }, + { + "id": 3, + "type": "KSampler", + "pos": [ + 1580, + 300 + ], + "size": { + "0": 315, + "1": 262 + }, + "flags": {}, + "order": 13, + "mode": 0, + "inputs": [ + { + "name": "model", + "type": "MODEL", + "link": 23 + }, + { + "name": "positive", + "type": "CONDITIONING", + "link": 4 + }, + { + "name": "negative", + "type": "CONDITIONING", + "link": 6 + }, + { + "name": "latent_image", + "type": "LATENT", + "link": 2 + } + ], + "outputs": [ + { + "name": "LATENT", + "type": "LATENT", + "links": [ + 7 + ], + "slot_index": 0 + } + ], + "properties": { + "Node name for S&R": "KSampler" + }, + "widgets_values": [ + 0, + "fixed", + 30, + 6.5, + "dpmpp_2m", + "karras", + 1 + ] + }, + { + "id": 4, + "type": "CheckpointLoaderSimple", + "pos": [ + 300, + 700 + ], + "size": { + "0": 315, + "1": 98 + }, + "flags": {}, + "order": 2, + "mode": 0, + "outputs": [ + { + "name": "MODEL", + "type": "MODEL", + "links": [ + 20, + 93, + 104, + 115 + ], + "slot_index": 0 + }, + { + "name": "CLIP", + "type": "CLIP", + "links": [ + 3, + 5 + ], + "slot_index": 1 + }, + { + "name": "VAE", + "type": "VAE", + "links": [ + 8, + 91, + 102, + 113 + ], + "slot_index": 2 + } + ], + "properties": { + "Node name for S&R": "CheckpointLoaderSimple" + }, + "widgets_values": [ + "sd15/realisticVisionV51_v51VAE.safetensors" + ] + }, + { + "id": 12, + "type": "LoadImage", + "pos": [ + 240, + -60 + ], + "size": { + "0": 315, + "1": 314 + }, + "flags": {}, + "order": 3, + "mode": 0, + "outputs": [ + { + "name": "IMAGE", + "type": "IMAGE", + "links": [ + 83 + ], + "shape": 3, + "slot_index": 0 + }, + { + "name": "MASK", + "type": "MASK", + "links": null, + "shape": 3 + } + ], + "properties": { + "Node name for S&R": "LoadImage" + }, + "widgets_values": [ + "warrior_woman.png", + "image" + ] + }, + { + "id": 7, + "type": "CLIPTextEncode", + "pos": [ + 740, + 780 + ], + "size": { + "0": 425.27801513671875, + "1": 180.6060791015625 + }, + "flags": {}, + "order": 7, + "mode": 0, + "inputs": [ + { + "name": "clip", + "type": "CLIP", + "link": 5 + } + ], + "outputs": [ + { + "name": "CONDITIONING", + "type": "CONDITIONING", + "links": [ + 6, + 88, + 99, + 110 + ], + "slot_index": 0 + } + ], + "properties": { + "Node name for S&R": "CLIPTextEncode" + }, + "widgets_values": [ + "blurry, noisy, messy, lowres, jpeg, artifacts, ill, distorted, malformed" + ] + }, + { + "id": 14, + "type": "IPAdapterAdvanced", + "pos": [ + 1220, + 260 + ], + "size": { + "0": 315, + "1": 254 + }, + "flags": {}, + "order": 9, + "mode": 0, + "inputs": [ + { + "name": "model", + "type": "MODEL", + "link": 20 + }, + { + "name": "ipadapter", + "type": "IPADAPTER", + "link": 21, + "slot_index": 1 + }, + { + "name": "image", + "type": "IMAGE", + "link": 85 + }, + { + "name": "image_negative", + "type": "IMAGE", + "link": null + }, + { + "name": "attn_mask", + "type": "MASK", + "link": null + }, + { + "name": "clip_vision", + "type": "CLIP_VISION", + "link": 24, + "slot_index": 5 + } + ], + "outputs": [ + { + "name": "MODEL", + "type": "MODEL", + "links": [ + 23 + ], + "shape": 3, + "slot_index": 0 + } + ], + "properties": { + "Node name for S&R": "IPAdapterAdvanced" + }, + "widgets_values": [ + 0.8, + "linear", + "concat", + 0, + 1 + ] + }, + { + "id": 42, + "type": "SaveImage", + "pos": [ + 1950, + 1070 + ], + "size": { + "0": 529.7760009765625, + "1": 582.3048095703125 + }, + "flags": {}, + "order": 22, + "mode": 0, + "inputs": [ + { + "name": "images", + "type": "IMAGE", + "link": 92 + } + ], + "properties": {}, + "widgets_values": [ + "IPAdapter" + ] + }, + { + "id": 40, + "type": "KSampler", + "pos": [ + 1580, + 1070 + ], + "size": { + "0": 315, + "1": 262 + }, + "flags": {}, + "order": 14, + "mode": 0, + "inputs": [ + { + "name": "model", + "type": "MODEL", + "link": 86 + }, + { + "name": "positive", + "type": "CONDITIONING", + "link": 87 + }, + { + "name": "negative", + "type": "CONDITIONING", + "link": 88 + }, + { + "name": "latent_image", + "type": "LATENT", + "link": 89 + } + ], + "outputs": [ + { + "name": "LATENT", + "type": "LATENT", + "links": [ + 90 + ], + "slot_index": 0 + } + ], + "properties": { + "Node name for S&R": "KSampler" + }, + "widgets_values": [ + 0, + "fixed", + 30, + 6.5, + "dpmpp_2m", + "karras", + 1 + ] + }, + { + "id": 9, + "type": "SaveImage", + "pos": [ + 1950, + 420 + ], + "size": { + "0": 529.7760009765625, + "1": 582.3048095703125 + }, + "flags": {}, + "order": 21, + "mode": 0, + "inputs": [ + { + "name": "images", + "type": "IMAGE", + "link": 9 + } + ], + "properties": {}, + "widgets_values": [ + "IPAdapter" + ] + }, + { + "id": 6, + "type": "CLIPTextEncode", + "pos": [ + 740, + 550 + ], + "size": { + "0": 422.84503173828125, + "1": 164.31304931640625 + }, + "flags": {}, + "order": 6, + "mode": 0, + "inputs": [ + { + "name": "clip", + "type": "CLIP", + "link": 3 + } + ], + "outputs": [ + { + "name": "CONDITIONING", + "type": "CONDITIONING", + "links": [ + 4, + 87, + 98, + 109 + ], + "slot_index": 0 + } + ], + "properties": { + "Node name for S&R": "CLIPTextEncode" + }, + "widgets_values": [ + "closeup of a fierce warrior woman wearing a full armor at the end of a battle\n\nhigh quality, detailed" + ] + }, + { + "id": 15, + "type": "IPAdapterModelLoader", + "pos": [ + 650, + -20 + ], + "size": { + "0": 315, + "1": 58 + }, + "flags": {}, + "order": 4, + "mode": 0, + "outputs": [ + { + "name": "IPADAPTER", + "type": "IPADAPTER", + "links": [ + 21, + 94, + 105, + 116 + ], + "shape": 3 + } + ], + "properties": { + "Node name for S&R": "IPAdapterModelLoader" + }, + "widgets_values": [ + "ip-adapter-plus_sd15.safetensors" + ] + }, + { + "id": 39, + "type": "ImageBatch", + "pos": [ + 714, + 287 + ], + "size": { + "0": 210, + "1": 46 + }, + "flags": {}, + "order": 8, + "mode": 0, + "inputs": [ + { + "name": "image1", + "type": "IMAGE", + "link": 83 + }, + { + "name": "image2", + "type": "IMAGE", + "link": 84 + } + ], + "outputs": [ + { + "name": "IMAGE", + "type": "IMAGE", + "links": [ + 85, + 95, + 106, + 117 + ], + "shape": 3, + "slot_index": 0 + } + ], + "properties": { + "Node name for S&R": "ImageBatch" + } + }, + { + "id": 38, + "type": "LoadImage", + "pos": [ + 240, + 310 + ], + "size": { + "0": 315, + "1": 314 + }, + "flags": {}, + "order": 5, + "mode": 0, + "outputs": [ + { + "name": "IMAGE", + "type": "IMAGE", + "links": [ + 84 + ], + "shape": 3, + "slot_index": 0 + }, + { + "name": "MASK", + "type": "MASK", + "links": null, + "shape": 3 + } + ], + "properties": { + "Node name for S&R": "LoadImage" + }, + "widgets_values": [ + "anime_illustration.png", + "image" + ] + }, + { + "id": 43, + "type": "IPAdapterAdvanced", + "pos": [ + 1220, + 1030 + ], + "size": { + "0": 315, + "1": 254 + }, + "flags": {}, + "order": 10, + "mode": 0, + "inputs": [ + { + "name": "model", + "type": "MODEL", + "link": 93 + }, + { + "name": "ipadapter", + "type": "IPADAPTER", + "link": 94, + "slot_index": 1 + }, + { + "name": "image", + "type": "IMAGE", + "link": 95 + }, + { + "name": "image_negative", + "type": "IMAGE", + "link": null + }, + { + "name": "attn_mask", + "type": "MASK", + "link": null + }, + { + "name": "clip_vision", + "type": "CLIP_VISION", + "link": 96, + "slot_index": 5 + } + ], + "outputs": [ + { + "name": "MODEL", + "type": "MODEL", + "links": [ + 86 + ], + "shape": 3, + "slot_index": 0 + } + ], + "properties": { + "Node name for S&R": "IPAdapterAdvanced" + }, + "widgets_values": [ + 0.8, + "linear", + "add", + 0, + 1 + ] + }, + { + "id": 44, + "type": "KSampler", + "pos": [ + 3470, + 390 + ], + "size": { + "0": 315, + "1": 262 + }, + "flags": {}, + "order": 15, + "mode": 0, + "inputs": [ + { + "name": "model", + "type": "MODEL", + "link": 97 + }, + { + "name": "positive", + "type": "CONDITIONING", + "link": 98 + }, + { + "name": "negative", + "type": "CONDITIONING", + "link": 99 + }, + { + "name": "latent_image", + "type": "LATENT", + "link": 100 + } + ], + "outputs": [ + { + "name": "LATENT", + "type": "LATENT", + "links": [ + 101 + ], + "slot_index": 0 + } + ], + "properties": { + "Node name for S&R": "KSampler" + }, + "widgets_values": [ + 0, + "fixed", + 30, + 6.5, + "dpmpp_2m", + "karras", + 1 + ] + }, + { + "id": 45, + "type": "VAEDecode", + "pos": [ + 3840, + 400 + ], + "size": { + "0": 140, + "1": 46 + }, + "flags": {}, + "order": 19, + "mode": 0, + "inputs": [ + { + "name": "samples", + "type": "LATENT", + "link": 101 + }, + { + "name": "vae", + "type": "VAE", + "link": 102 + } + ], + "outputs": [ + { + "name": "IMAGE", + "type": "IMAGE", + "links": [ + 103 + ], + "slot_index": 0 + } + ], + "properties": { + "Node name for S&R": "VAEDecode" + } + }, + { + "id": 48, + "type": "KSampler", + "pos": [ + 3480, + 1170 + ], + "size": { + "0": 315, + "1": 262 + }, + "flags": {}, + "order": 16, + "mode": 0, + "inputs": [ + { + "name": "model", + "type": "MODEL", + "link": 108 + }, + { + "name": "positive", + "type": "CONDITIONING", + "link": 109 + }, + { + "name": "negative", + "type": "CONDITIONING", + "link": 110 + }, + { + "name": "latent_image", + "type": "LATENT", + "link": 111 + } + ], + "outputs": [ + { + "name": "LATENT", + "type": "LATENT", + "links": [ + 112 + ], + "slot_index": 0 + } + ], + "properties": { + "Node name for S&R": "KSampler" + }, + "widgets_values": [ + 0, + "fixed", + 30, + 6.5, + "dpmpp_2m", + "karras", + 1 + ] + }, + { + "id": 49, + "type": "VAEDecode", + "pos": [ + 3850, + 1180 + ], + "size": { + "0": 140, + "1": 46 + }, + "flags": {}, + "order": 20, + "mode": 0, + "inputs": [ + { + "name": "samples", + "type": "LATENT", + "link": 112 + }, + { + "name": "vae", + "type": "VAE", + "link": 113 + } + ], + "outputs": [ + { + "name": "IMAGE", + "type": "IMAGE", + "links": [ + 114 + ], + "slot_index": 0 + } + ], + "properties": { + "Node name for S&R": "VAEDecode" + } + }, + { + "id": 51, + "type": "IPAdapterAdvanced", + "pos": [ + 3120, + 1130 + ], + "size": { + "0": 315, + "1": 254 + }, + "flags": {}, + "order": 12, + "mode": 0, + "inputs": [ + { + "name": "model", + "type": "MODEL", + "link": 115 + }, + { + "name": "ipadapter", + "type": "IPADAPTER", + "link": 116, + "slot_index": 1 + }, + { + "name": "image", + "type": "IMAGE", + "link": 117 + }, + { + "name": "image_negative", + "type": "IMAGE", + "link": null + }, + { + "name": "attn_mask", + "type": "MASK", + "link": null + }, + { + "name": "clip_vision", + "type": "CLIP_VISION", + "link": 118, + "slot_index": 5 + } + ], + "outputs": [ + { + "name": "MODEL", + "type": "MODEL", + "links": [ + 108 + ], + "shape": 3, + "slot_index": 0 + } + ], + "properties": { + "Node name for S&R": "IPAdapterAdvanced" + }, + "widgets_values": [ + 0.8, + "linear", + "norm average", + 0, + 1 + ] + }, + { + "id": 47, + "type": "IPAdapterAdvanced", + "pos": [ + 3110, + 350 + ], + "size": { + "0": 315, + "1": 254 + }, + "flags": {}, + "order": 11, + "mode": 0, + "inputs": [ + { + "name": "model", + "type": "MODEL", + "link": 104 + }, + { + "name": "ipadapter", + "type": "IPADAPTER", + "link": 105, + "slot_index": 1 + }, + { + "name": "image", + "type": "IMAGE", + "link": 106 + }, + { + "name": "image_negative", + "type": "IMAGE", + "link": null + }, + { + "name": "attn_mask", + "type": "MASK", + "link": null + }, + { + "name": "clip_vision", + "type": "CLIP_VISION", + "link": 107, + "slot_index": 5 + } + ], + "outputs": [ + { + "name": "MODEL", + "type": "MODEL", + "links": [ + 97 + ], + "shape": 3, + "slot_index": 0 + } + ], + "properties": { + "Node name for S&R": "IPAdapterAdvanced" + }, + "widgets_values": [ + 0.8, + "linear", + "average", + 0, + 1 + ] + }, + { + "id": 8, + "type": "VAEDecode", + "pos": [ + 1748, + 613 + ], + "size": { + "0": 140, + "1": 46 + }, + "flags": {}, + "order": 17, + "mode": 0, + "inputs": [ + { + "name": "samples", + "type": "LATENT", + "link": 7 + }, + { + "name": "vae", + "type": "VAE", + "link": 8 + } + ], + "outputs": [ + { + "name": "IMAGE", + "type": "IMAGE", + "links": [ + 9 + ], + "slot_index": 0 + } + ], + "properties": { + "Node name for S&R": "VAEDecode" + } + }, + { + "id": 41, + "type": "VAEDecode", + "pos": [ + 1746, + 1386 + ], + "size": { + "0": 140, + "1": 46 + }, + "flags": {}, + "order": 18, + "mode": 0, + "inputs": [ + { + "name": "samples", + "type": "LATENT", + "link": 90 + }, + { + "name": "vae", + "type": "VAE", + "link": 91 + } + ], + "outputs": [ + { + "name": "IMAGE", + "type": "IMAGE", + "links": [ + 92 + ], + "slot_index": 0 + } + ], + "properties": { + "Node name for S&R": "VAEDecode" + } + }, + { + "id": 50, + "type": "SaveImage", + "pos": [ + 2530, + 1073 + ], + "size": { + "0": 529.7760009765625, + "1": 582.3048095703125 + }, + "flags": {}, + "order": 24, + "mode": 0, + "inputs": [ + { + "name": "images", + "type": "IMAGE", + "link": 114 + } + ], + "properties": {}, + "widgets_values": [ + "IPAdapter" + ] + }, + { + "id": 46, + "type": "SaveImage", + "pos": [ + 2518, + 419 + ], + "size": { + "0": 529.7760009765625, + "1": 582.3048095703125 + }, + "flags": {}, + "order": 23, + "mode": 0, + "inputs": [ + { + "name": "images", + "type": "IMAGE", + "link": 103 + } + ], + "properties": {}, + "widgets_values": [ + "IPAdapter" + ] + } + ], + "links": [ + [ + 2, + 5, + 0, + 3, + 3, + "LATENT" + ], + [ + 3, + 4, + 1, + 6, + 0, + "CLIP" + ], + [ + 4, + 6, + 0, + 3, + 1, + "CONDITIONING" + ], + [ + 5, + 4, + 1, + 7, + 0, + "CLIP" + ], + [ + 6, + 7, + 0, + 3, + 2, + "CONDITIONING" + ], + [ + 7, + 3, + 0, + 8, + 0, + "LATENT" + ], + [ + 8, + 4, + 2, + 8, + 1, + "VAE" + ], + [ + 9, + 8, + 0, + 9, + 0, + "IMAGE" + ], + [ + 20, + 4, + 0, + 14, + 0, + "MODEL" + ], + [ + 21, + 15, + 0, + 14, + 1, + "IPADAPTER" + ], + [ + 23, + 14, + 0, + 3, + 0, + "MODEL" + ], + [ + 24, + 16, + 0, + 14, + 5, + "CLIP_VISION" + ], + [ + 83, + 12, + 0, + 39, + 0, + "IMAGE" + ], + [ + 84, + 38, + 0, + 39, + 1, + "IMAGE" + ], + [ + 85, + 39, + 0, + 14, + 2, + "IMAGE" + ], + [ + 86, + 43, + 0, + 40, + 0, + "MODEL" + ], + [ + 87, + 6, + 0, + 40, + 1, + "CONDITIONING" + ], + [ + 88, + 7, + 0, + 40, + 2, + "CONDITIONING" + ], + [ + 89, + 5, + 0, + 40, + 3, + "LATENT" + ], + [ + 90, + 40, + 0, + 41, + 0, + "LATENT" + ], + [ + 91, + 4, + 2, + 41, + 1, + "VAE" + ], + [ + 92, + 41, + 0, + 42, + 0, + "IMAGE" + ], + [ + 93, + 4, + 0, + 43, + 0, + "MODEL" + ], + [ + 94, + 15, + 0, + 43, + 1, + "IPADAPTER" + ], + [ + 95, + 39, + 0, + 43, + 2, + "IMAGE" + ], + [ + 96, + 16, + 0, + 43, + 5, + "CLIP_VISION" + ], + [ + 97, + 47, + 0, + 44, + 0, + "MODEL" + ], + [ + 98, + 6, + 0, + 44, + 1, + "CONDITIONING" + ], + [ + 99, + 7, + 0, + 44, + 2, + "CONDITIONING" + ], + [ + 100, + 5, + 0, + 44, + 3, + "LATENT" + ], + [ + 101, + 44, + 0, + 45, + 0, + "LATENT" + ], + [ + 102, + 4, + 2, + 45, + 1, + "VAE" + ], + [ + 103, + 45, + 0, + 46, + 0, + "IMAGE" + ], + [ + 104, + 4, + 0, + 47, + 0, + "MODEL" + ], + [ + 105, + 15, + 0, + 47, + 1, + "IPADAPTER" + ], + [ + 106, + 39, + 0, + 47, + 2, + "IMAGE" + ], + [ + 107, + 16, + 0, + 47, + 5, + "CLIP_VISION" + ], + [ + 108, + 51, + 0, + 48, + 0, + "MODEL" + ], + [ + 109, + 6, + 0, + 48, + 1, + "CONDITIONING" + ], + [ + 110, + 7, + 0, + 48, + 2, + "CONDITIONING" + ], + [ + 111, + 5, + 0, + 48, + 3, + "LATENT" + ], + [ + 112, + 48, + 0, + 49, + 0, + "LATENT" + ], + [ + 113, + 4, + 2, + 49, + 1, + "VAE" + ], + [ + 114, + 49, + 0, + 50, + 0, + "IMAGE" + ], + [ + 115, + 4, + 0, + 51, + 0, + "MODEL" + ], + [ + 116, + 15, + 0, + 51, + 1, + "IPADAPTER" + ], + [ + 117, + 39, + 0, + 51, + 2, + "IMAGE" + ], + [ + 118, + 16, + 0, + 51, + 5, + "CLIP_VISION" + ] + ], + "groups": [], + "config": {}, + "extra": {}, + "version": 0.4 +} \ No newline at end of file diff --git a/imports/ComfyUI_IPAdapter_plus/examples/ipadapter_faceid.json b/imports/ComfyUI_IPAdapter_plus/examples/ipadapter_faceid.json new file mode 100644 index 0000000..99d0bbe --- /dev/null +++ b/imports/ComfyUI_IPAdapter_plus/examples/ipadapter_faceid.json @@ -0,0 +1,566 @@ +{ + "last_node_id": 20, + "last_link_id": 36, + "nodes": [ + { + "id": 8, + "type": "VAEDecode", + "pos": [ + 1640, + 710 + ], + "size": { + "0": 140, + "1": 46 + }, + "flags": {}, + "order": 8, + "mode": 0, + "inputs": [ + { + "name": "samples", + "type": "LATENT", + "link": 7 + }, + { + "name": "vae", + "type": "VAE", + "link": 8 + } + ], + "outputs": [ + { + "name": "IMAGE", + "type": "IMAGE", + "links": [ + 9 + ], + "slot_index": 0 + } + ], + "properties": { + "Node name for S&R": "VAEDecode" + } + }, + { + "id": 5, + "type": "EmptyLatentImage", + "pos": [ + 870, + 1100 + ], + "size": { + "0": 315, + "1": 106 + }, + "flags": {}, + "order": 0, + "mode": 0, + "outputs": [ + { + "name": "LATENT", + "type": "LATENT", + "links": [ + 2 + ], + "slot_index": 0 + } + ], + "properties": { + "Node name for S&R": "EmptyLatentImage" + }, + "widgets_values": [ + 512, + 512, + 1 + ] + }, + { + "id": 3, + "type": "KSampler", + "pos": [ + 1280, + 710 + ], + "size": { + "0": 315, + "1": 262 + }, + "flags": {}, + "order": 7, + "mode": 0, + "inputs": [ + { + "name": "model", + "type": "MODEL", + "link": 32 + }, + { + "name": "positive", + "type": "CONDITIONING", + "link": 4 + }, + { + "name": "negative", + "type": "CONDITIONING", + "link": 6 + }, + { + "name": "latent_image", + "type": "LATENT", + "link": 2 + } + ], + "outputs": [ + { + "name": "LATENT", + "type": "LATENT", + "links": [ + 7 + ], + "slot_index": 0 + } + ], + "properties": { + "Node name for S&R": "KSampler" + }, + "widgets_values": [ + 0, + "fixed", + 30, + 6.5, + "ddpm", + "karras", + 1 + ] + }, + { + "id": 9, + "type": "SaveImage", + "pos": [ + 1830, + 700 + ], + "size": { + "0": 529.7760009765625, + "1": 582.3048095703125 + }, + "flags": {}, + "order": 9, + "mode": 0, + "inputs": [ + { + "name": "images", + "type": "IMAGE", + "link": 9 + } + ], + "properties": {}, + "widgets_values": [ + "IPAdapter" + ] + }, + { + "id": 12, + "type": "LoadImage", + "pos": [ + 450, + 240 + ], + "size": { + "0": 315, + "1": 314 + }, + "flags": {}, + "order": 1, + "mode": 0, + "outputs": [ + { + "name": "IMAGE", + "type": "IMAGE", + "links": [ + 29 + ], + "shape": 3, + "slot_index": 0 + }, + { + "name": "MASK", + "type": "MASK", + "links": null, + "shape": 3 + } + ], + "properties": { + "Node name for S&R": "LoadImage" + }, + "widgets_values": [ + "rosario_4.jpg", + "image" + ] + }, + { + "id": 20, + "type": "IPAdapterUnifiedLoaderFaceID", + "pos": [ + 460, + 60 + ], + "size": { + "0": 315, + "1": 126 + }, + "flags": {}, + "order": 3, + "mode": 0, + "inputs": [ + { + "name": "model", + "type": "MODEL", + "link": 36 + }, + { + "name": "ipadapter", + "type": "IPADAPTER", + "link": null + } + ], + "outputs": [ + { + "name": "MODEL", + "type": "MODEL", + "links": [ + 35 + ], + "shape": 3, + "slot_index": 0 + }, + { + "name": "ipadapter", + "type": "IPADAPTER", + "links": [ + 34 + ], + "shape": 3 + } + ], + "properties": { + "Node name for S&R": "IPAdapterUnifiedLoaderFaceID" + }, + "widgets_values": [ + "FACEID PLUS V2", + 0.6, + "CPU" + ] + }, + { + "id": 7, + "type": "CLIPTextEncode", + "pos": [ + 760, + 850 + ], + "size": { + "0": 425.27801513671875, + "1": 180.6060791015625 + }, + "flags": {}, + "order": 5, + "mode": 0, + "inputs": [ + { + "name": "clip", + "type": "CLIP", + "link": 5 + } + ], + "outputs": [ + { + "name": "CONDITIONING", + "type": "CONDITIONING", + "links": [ + 6 + ], + "slot_index": 0 + } + ], + "properties": { + "Node name for S&R": "CLIPTextEncode" + }, + "widgets_values": [ + "blurry, noisy, messy, lowres, jpeg, artifacts, ill, distorted, malformed, naked" + ] + }, + { + "id": 6, + "type": "CLIPTextEncode", + "pos": [ + 760, + 620 + ], + "size": { + "0": 422.84503173828125, + "1": 164.31304931640625 + }, + "flags": {}, + "order": 4, + "mode": 0, + "inputs": [ + { + "name": "clip", + "type": "CLIP", + "link": 3 + } + ], + "outputs": [ + { + "name": "CONDITIONING", + "type": "CONDITIONING", + "links": [ + 4 + ], + "slot_index": 0 + } + ], + "properties": { + "Node name for S&R": "CLIPTextEncode" + }, + "widgets_values": [ + "closeup of a beautiful woman wearing a black dress on the seaside\n\nserene, sunset, spring, high quality, detailed, diffuse light" + ] + }, + { + "id": 4, + "type": "CheckpointLoaderSimple", + "pos": [ + 10, + 680 + ], + "size": { + "0": 315, + "1": 98 + }, + "flags": {}, + "order": 2, + "mode": 0, + "outputs": [ + { + "name": "MODEL", + "type": "MODEL", + "links": [ + 36 + ], + "slot_index": 0 + }, + { + "name": "CLIP", + "type": "CLIP", + "links": [ + 3, + 5 + ], + "slot_index": 1 + }, + { + "name": "VAE", + "type": "VAE", + "links": [ + 8 + ], + "slot_index": 2 + } + ], + "properties": { + "Node name for S&R": "CheckpointLoaderSimple" + }, + "widgets_values": [ + "sd15/realisticVisionV51_v51VAE.safetensors" + ] + }, + { + "id": 18, + "type": "IPAdapterFaceID", + "pos": [ + 850, + 190 + ], + "size": { + "0": 315, + "1": 298 + }, + "flags": {}, + "order": 6, + "mode": 0, + "inputs": [ + { + "name": "model", + "type": "MODEL", + "link": 35 + }, + { + "name": "ipadapter", + "type": "IPADAPTER", + "link": 34, + "slot_index": 1 + }, + { + "name": "image", + "type": "IMAGE", + "link": 29 + }, + { + "name": "image_negative", + "type": "IMAGE", + "link": null + }, + { + "name": "attn_mask", + "type": "MASK", + "link": null + }, + { + "name": "clip_vision", + "type": "CLIP_VISION", + "link": null + }, + { + "name": "insightface", + "type": "INSIGHTFACE", + "link": null + } + ], + "outputs": [ + { + "name": "MODEL", + "type": "MODEL", + "links": [ + 32 + ], + "shape": 3, + "slot_index": 0 + } + ], + "properties": { + "Node name for S&R": "IPAdapterFaceID" + }, + "widgets_values": [ + 1, + 2, + "linear", + "concat", + 0, + 1 + ] + } + ], + "links": [ + [ + 2, + 5, + 0, + 3, + 3, + "LATENT" + ], + [ + 3, + 4, + 1, + 6, + 0, + "CLIP" + ], + [ + 4, + 6, + 0, + 3, + 1, + "CONDITIONING" + ], + [ + 5, + 4, + 1, + 7, + 0, + "CLIP" + ], + [ + 6, + 7, + 0, + 3, + 2, + "CONDITIONING" + ], + [ + 7, + 3, + 0, + 8, + 0, + "LATENT" + ], + [ + 8, + 4, + 2, + 8, + 1, + "VAE" + ], + [ + 9, + 8, + 0, + 9, + 0, + "IMAGE" + ], + [ + 29, + 12, + 0, + 18, + 2, + "IMAGE" + ], + [ + 32, + 18, + 0, + 3, + 0, + "MODEL" + ], + [ + 34, + 20, + 1, + 18, + 1, + "IPADAPTER" + ], + [ + 35, + 20, + 0, + 18, + 0, + "MODEL" + ], + [ + 36, + 4, + 0, + 20, + 0, + "MODEL" + ] + ], + "groups": [], + "config": {}, + "extra": {}, + "version": 0.4 +} \ No newline at end of file diff --git a/imports/ComfyUI_IPAdapter_plus/examples/ipadapter_faceid_batch.json b/imports/ComfyUI_IPAdapter_plus/examples/ipadapter_faceid_batch.json new file mode 100644 index 0000000..3dd6685 --- /dev/null +++ b/imports/ComfyUI_IPAdapter_plus/examples/ipadapter_faceid_batch.json @@ -0,0 +1,1168 @@ +{ + "last_node_id": 32, + "last_link_id": 54, + "nodes": [ + { + "id": 8, + "type": "VAEDecode", + "pos": [ + 1640, + 710 + ], + "size": { + "0": 140, + "1": 46 + }, + "flags": {}, + "order": 19, + "mode": 0, + "inputs": [ + { + "name": "samples", + "type": "LATENT", + "link": 7 + }, + { + "name": "vae", + "type": "VAE", + "link": 8 + } + ], + "outputs": [ + { + "name": "IMAGE", + "type": "IMAGE", + "links": [ + 9 + ], + "slot_index": 0 + } + ], + "properties": { + "Node name for S&R": "VAEDecode" + } + }, + { + "id": 5, + "type": "EmptyLatentImage", + "pos": [ + 870, + 1100 + ], + "size": { + "0": 315, + "1": 106 + }, + "flags": {}, + "order": 0, + "mode": 0, + "outputs": [ + { + "name": "LATENT", + "type": "LATENT", + "links": [ + 2 + ], + "slot_index": 0 + } + ], + "properties": { + "Node name for S&R": "EmptyLatentImage" + }, + "widgets_values": [ + 512, + 512, + 1 + ] + }, + { + "id": 3, + "type": "KSampler", + "pos": [ + 1280, + 710 + ], + "size": { + "0": 315, + "1": 262 + }, + "flags": {}, + "order": 18, + "mode": 0, + "inputs": [ + { + "name": "model", + "type": "MODEL", + "link": 42 + }, + { + "name": "positive", + "type": "CONDITIONING", + "link": 4 + }, + { + "name": "negative", + "type": "CONDITIONING", + "link": 6 + }, + { + "name": "latent_image", + "type": "LATENT", + "link": 2 + } + ], + "outputs": [ + { + "name": "LATENT", + "type": "LATENT", + "links": [ + 7 + ], + "slot_index": 0 + } + ], + "properties": { + "Node name for S&R": "KSampler" + }, + "widgets_values": [ + 0, + "fixed", + 30, + 6.5, + "ddpm", + "karras", + 1 + ] + }, + { + "id": 9, + "type": "SaveImage", + "pos": [ + 1830, + 700 + ], + "size": { + "0": 529.7760009765625, + "1": 582.3048095703125 + }, + "flags": {}, + "order": 20, + "mode": 0, + "inputs": [ + { + "name": "images", + "type": "IMAGE", + "link": 9 + } + ], + "properties": {}, + "widgets_values": [ + "IPAdapter" + ] + }, + { + "id": 7, + "type": "CLIPTextEncode", + "pos": [ + 760, + 850 + ], + "size": { + "0": 425.27801513671875, + "1": 180.6060791015625 + }, + "flags": {}, + "order": 9, + "mode": 0, + "inputs": [ + { + "name": "clip", + "type": "CLIP", + "link": 5 + } + ], + "outputs": [ + { + "name": "CONDITIONING", + "type": "CONDITIONING", + "links": [ + 6 + ], + "slot_index": 0 + } + ], + "properties": { + "Node name for S&R": "CLIPTextEncode" + }, + "widgets_values": [ + "blurry, noisy, messy, lowres, jpeg, artifacts, ill, distorted, malformed, naked" + ] + }, + { + "id": 6, + "type": "CLIPTextEncode", + "pos": [ + 760, + 620 + ], + "size": { + "0": 422.84503173828125, + "1": 164.31304931640625 + }, + "flags": {}, + "order": 8, + "mode": 0, + "inputs": [ + { + "name": "clip", + "type": "CLIP", + "link": 3 + } + ], + "outputs": [ + { + "name": "CONDITIONING", + "type": "CONDITIONING", + "links": [ + 4 + ], + "slot_index": 0 + } + ], + "properties": { + "Node name for S&R": "CLIPTextEncode" + }, + "widgets_values": [ + "closeup of a beautiful woman wearing a black dress on the seaside\n\nserene, sunset, spring, high quality, detailed, diffuse light" + ] + }, + { + "id": 4, + "type": "CheckpointLoaderSimple", + "pos": [ + 10, + 680 + ], + "size": { + "0": 315, + "1": 98 + }, + "flags": {}, + "order": 1, + "mode": 0, + "outputs": [ + { + "name": "MODEL", + "type": "MODEL", + "links": [ + 36 + ], + "slot_index": 0 + }, + { + "name": "CLIP", + "type": "CLIP", + "links": [ + 3, + 5 + ], + "slot_index": 1 + }, + { + "name": "VAE", + "type": "VAE", + "links": [ + 8 + ], + "slot_index": 2 + } + ], + "properties": { + "Node name for S&R": "CheckpointLoaderSimple" + }, + "widgets_values": [ + "sd15/realisticVisionV51_v51VAE.safetensors" + ] + }, + { + "id": 22, + "type": "IPAdapterUnifiedLoader", + "pos": [ + 855, + 51 + ], + "size": { + "0": 315, + "1": 78 + }, + "flags": {}, + "order": 15, + "mode": 0, + "inputs": [ + { + "name": "model", + "type": "MODEL", + "link": 43 + }, + { + "name": "ipadapter", + "type": "IPADAPTER", + "link": 38 + } + ], + "outputs": [ + { + "name": "model", + "type": "MODEL", + "links": [ + 40 + ], + "shape": 3, + "slot_index": 0 + }, + { + "name": "ipadapter", + "type": "IPADAPTER", + "links": [ + 37 + ], + "shape": 3 + } + ], + "properties": { + "Node name for S&R": "IPAdapterUnifiedLoader" + }, + "widgets_values": [ + "FULL FACE - SD1.5 only (portraits stronger)" + ] + }, + { + "id": 21, + "type": "IPAdapter", + "pos": [ + 1280, + 170 + ], + "size": { + "0": 315, + "1": 166 + }, + "flags": {}, + "order": 17, + "mode": 0, + "inputs": [ + { + "name": "model", + "type": "MODEL", + "link": 40 + }, + { + "name": "ipadapter", + "type": "IPADAPTER", + "link": 37, + "slot_index": 1 + }, + { + "name": "image", + "type": "IMAGE", + "link": 53 + }, + { + "name": "attn_mask", + "type": "MASK", + "link": null + } + ], + "outputs": [ + { + "name": "MODEL", + "type": "MODEL", + "links": [ + 42 + ], + "shape": 3, + "slot_index": 0 + } + ], + "properties": { + "Node name for S&R": "IPAdapter" + }, + "widgets_values": [ + 0.4, + 0, + 1 + ] + }, + { + "id": 20, + "type": "IPAdapterUnifiedLoaderFaceID", + "pos": [ + 457, + 57 + ], + "size": { + "0": 315, + "1": 126 + }, + "flags": {}, + "order": 7, + "mode": 0, + "inputs": [ + { + "name": "model", + "type": "MODEL", + "link": 36 + }, + { + "name": "ipadapter", + "type": "IPADAPTER", + "link": null + } + ], + "outputs": [ + { + "name": "MODEL", + "type": "MODEL", + "links": [ + 35 + ], + "shape": 3, + "slot_index": 0 + }, + { + "name": "ipadapter", + "type": "IPADAPTER", + "links": [ + 34, + 38 + ], + "shape": 3, + "slot_index": 1 + } + ], + "properties": { + "Node name for S&R": "IPAdapterUnifiedLoaderFaceID" + }, + "widgets_values": [ + "FACEID PLUS V2", + 0.6, + "CPU" + ] + }, + { + "id": 12, + "type": "LoadImage", + "pos": [ + -220, + -370 + ], + "size": { + "0": 315, + "1": 314 + }, + "flags": {}, + "order": 2, + "mode": 0, + "outputs": [ + { + "name": "IMAGE", + "type": "IMAGE", + "links": [ + 44 + ], + "shape": 3, + "slot_index": 0 + }, + { + "name": "MASK", + "type": "MASK", + "links": null, + "shape": 3 + } + ], + "properties": { + "Node name for S&R": "LoadImage" + }, + "widgets_values": [ + "rosario-1.jpg", + "image" + ] + }, + { + "id": 25, + "type": "LoadImage", + "pos": [ + -580, + -380 + ], + "size": { + "0": 315, + "1": 314 + }, + "flags": {}, + "order": 3, + "mode": 0, + "outputs": [ + { + "name": "IMAGE", + "type": "IMAGE", + "links": [ + 45 + ], + "shape": 3, + "slot_index": 0 + }, + { + "name": "MASK", + "type": "MASK", + "links": null, + "shape": 3 + } + ], + "properties": { + "Node name for S&R": "LoadImage" + }, + "widgets_values": [ + "rosario_4.jpg", + "image" + ] + }, + { + "id": 24, + "type": "LoadImage", + "pos": [ + -230, + 0 + ], + "size": { + "0": 315, + "1": 314 + }, + "flags": {}, + "order": 4, + "mode": 0, + "outputs": [ + { + "name": "IMAGE", + "type": "IMAGE", + "links": [ + 46 + ], + "shape": 3, + "slot_index": 0 + }, + { + "name": "MASK", + "type": "MASK", + "links": null, + "shape": 3 + } + ], + "properties": { + "Node name for S&R": "LoadImage" + }, + "widgets_values": [ + "rosario_5.jpg", + "image" + ] + }, + { + "id": 26, + "type": "LoadImage", + "pos": [ + -580, + 0 + ], + "size": { + "0": 315, + "1": 314 + }, + "flags": {}, + "order": 5, + "mode": 0, + "outputs": [ + { + "name": "IMAGE", + "type": "IMAGE", + "links": [ + 47 + ], + "shape": 3, + "slot_index": 0 + }, + { + "name": "MASK", + "type": "MASK", + "links": null, + "shape": 3 + } + ], + "properties": { + "Node name for S&R": "LoadImage" + }, + "widgets_values": [ + "rosario-2.jpg", + "image" + ] + }, + { + "id": 27, + "type": "ImageBatch", + "pos": [ + 180, + -210 + ], + "size": { + "0": 210, + "1": 46 + }, + "flags": {}, + "order": 10, + "mode": 0, + "inputs": [ + { + "name": "image1", + "type": "IMAGE", + "link": 44 + }, + { + "name": "image2", + "type": "IMAGE", + "link": 45 + } + ], + "outputs": [ + { + "name": "IMAGE", + "type": "IMAGE", + "links": [ + 48 + ], + "shape": 3, + "slot_index": 0 + } + ], + "properties": { + "Node name for S&R": "ImageBatch" + } + }, + { + "id": 28, + "type": "ImageBatch", + "pos": [ + 180, + -110 + ], + "size": { + "0": 210, + "1": 46 + }, + "flags": {}, + "order": 11, + "mode": 0, + "inputs": [ + { + "name": "image1", + "type": "IMAGE", + "link": 46 + }, + { + "name": "image2", + "type": "IMAGE", + "link": 47 + } + ], + "outputs": [ + { + "name": "IMAGE", + "type": "IMAGE", + "links": [ + 49 + ], + "shape": 3, + "slot_index": 0 + } + ], + "properties": { + "Node name for S&R": "ImageBatch" + } + }, + { + "id": 18, + "type": "IPAdapterFaceID", + "pos": [ + 850, + 190 + ], + "size": { + "0": 315, + "1": 298 + }, + "flags": {}, + "order": 13, + "mode": 0, + "inputs": [ + { + "name": "model", + "type": "MODEL", + "link": 35 + }, + { + "name": "ipadapter", + "type": "IPADAPTER", + "link": 34, + "slot_index": 1 + }, + { + "name": "image", + "type": "IMAGE", + "link": 50 + }, + { + "name": "image_negative", + "type": "IMAGE", + "link": null + }, + { + "name": "attn_mask", + "type": "MASK", + "link": null + }, + { + "name": "clip_vision", + "type": "CLIP_VISION", + "link": null + }, + { + "name": "insightface", + "type": "INSIGHTFACE", + "link": null + } + ], + "outputs": [ + { + "name": "MODEL", + "type": "MODEL", + "links": [ + 43 + ], + "shape": 3, + "slot_index": 0 + } + ], + "properties": { + "Node name for S&R": "IPAdapterFaceID" + }, + "widgets_values": [ + 0.8, + 2, + "linear", + "concat", + 0, + 1 + ] + }, + { + "id": 29, + "type": "ImageBatch", + "pos": [ + 420, + -170 + ], + "size": { + "0": 210, + "1": 46 + }, + "flags": {}, + "order": 12, + "mode": 0, + "inputs": [ + { + "name": "image1", + "type": "IMAGE", + "link": 48 + }, + { + "name": "image2", + "type": "IMAGE", + "link": 49 + } + ], + "outputs": [ + { + "name": "IMAGE", + "type": "IMAGE", + "links": [ + 50, + 51 + ], + "shape": 3, + "slot_index": 0 + } + ], + "properties": { + "Node name for S&R": "ImageBatch" + } + }, + { + "id": 31, + "type": "ImageListToBatch+", + "pos": [ + 1218, + -208 + ], + "size": { + "0": 210, + "1": 26 + }, + "flags": {}, + "order": 16, + "mode": 0, + "inputs": [ + { + "name": "image", + "type": "IMAGE", + "link": 52 + } + ], + "outputs": [ + { + "name": "IMAGE", + "type": "IMAGE", + "links": [ + 53 + ], + "shape": 3, + "slot_index": 0 + } + ], + "properties": { + "Node name for S&R": "ImageListToBatch+" + } + }, + { + "id": 30, + "type": "FaceBoundingBox", + "pos": [ + 848, + -211 + ], + "size": { + "0": 315, + "1": 162 + }, + "flags": {}, + "order": 14, + "mode": 0, + "inputs": [ + { + "name": "analysis_models", + "type": "ANALYSIS_MODELS", + "link": 54, + "slot_index": 0 + }, + { + "name": "image", + "type": "IMAGE", + "link": 51 + } + ], + "outputs": [ + { + "name": "IMAGE", + "type": "IMAGE", + "links": [ + 52 + ], + "shape": 6, + "slot_index": 0 + }, + { + "name": "x", + "type": "INT", + "links": null, + "shape": 6 + }, + { + "name": "y", + "type": "INT", + "links": null, + "shape": 6 + }, + { + "name": "width", + "type": "INT", + "links": null, + "shape": 6 + }, + { + "name": "height", + "type": "INT", + "links": null, + "shape": 6 + } + ], + "properties": { + "Node name for S&R": "FaceBoundingBox" + }, + "widgets_values": [ + 30, + -1 + ] + }, + { + "id": 32, + "type": "FaceAnalysisModels", + "pos": [ + 602, + -369 + ], + "size": [ + 210, + 82 + ], + "flags": {}, + "order": 6, + "mode": 0, + "outputs": [ + { + "name": "ANALYSIS_MODELS", + "type": "ANALYSIS_MODELS", + "links": [ + 54 + ], + "shape": 3 + } + ], + "properties": { + "Node name for S&R": "FaceAnalysisModels" + }, + "widgets_values": [ + "dlib", + "CPU" + ] + } + ], + "links": [ + [ + 2, + 5, + 0, + 3, + 3, + "LATENT" + ], + [ + 3, + 4, + 1, + 6, + 0, + "CLIP" + ], + [ + 4, + 6, + 0, + 3, + 1, + "CONDITIONING" + ], + [ + 5, + 4, + 1, + 7, + 0, + "CLIP" + ], + [ + 6, + 7, + 0, + 3, + 2, + "CONDITIONING" + ], + [ + 7, + 3, + 0, + 8, + 0, + "LATENT" + ], + [ + 8, + 4, + 2, + 8, + 1, + "VAE" + ], + [ + 9, + 8, + 0, + 9, + 0, + "IMAGE" + ], + [ + 34, + 20, + 1, + 18, + 1, + "IPADAPTER" + ], + [ + 35, + 20, + 0, + 18, + 0, + "MODEL" + ], + [ + 36, + 4, + 0, + 20, + 0, + "MODEL" + ], + [ + 37, + 22, + 1, + 21, + 1, + "IPADAPTER" + ], + [ + 38, + 20, + 1, + 22, + 1, + "IPADAPTER" + ], + [ + 40, + 22, + 0, + 21, + 0, + "MODEL" + ], + [ + 42, + 21, + 0, + 3, + 0, + "MODEL" + ], + [ + 43, + 18, + 0, + 22, + 0, + "MODEL" + ], + [ + 44, + 12, + 0, + 27, + 0, + "IMAGE" + ], + [ + 45, + 25, + 0, + 27, + 1, + "IMAGE" + ], + [ + 46, + 24, + 0, + 28, + 0, + "IMAGE" + ], + [ + 47, + 26, + 0, + 28, + 1, + "IMAGE" + ], + [ + 48, + 27, + 0, + 29, + 0, + "IMAGE" + ], + [ + 49, + 28, + 0, + 29, + 1, + "IMAGE" + ], + [ + 50, + 29, + 0, + 18, + 2, + "IMAGE" + ], + [ + 51, + 29, + 0, + 30, + 1, + "IMAGE" + ], + [ + 52, + 30, + 0, + 31, + 0, + "IMAGE" + ], + [ + 53, + 31, + 0, + 21, + 2, + "IMAGE" + ], + [ + 54, + 32, + 0, + 30, + 0, + "ANALYSIS_MODELS" + ] + ], + "groups": [], + "config": {}, + "extra": {}, + "version": 0.4 +} \ No newline at end of file diff --git a/imports/ComfyUI_IPAdapter_plus/examples/ipadapter_ideal_faceid_config.json b/imports/ComfyUI_IPAdapter_plus/examples/ipadapter_ideal_faceid_config.json new file mode 100644 index 0000000..70df91a --- /dev/null +++ b/imports/ComfyUI_IPAdapter_plus/examples/ipadapter_ideal_faceid_config.json @@ -0,0 +1,756 @@ +{ + "last_node_id": 23, + "last_link_id": 43, + "nodes": [ + { + "id": 8, + "type": "VAEDecode", + "pos": [ + 1640, + 710 + ], + "size": { + "0": 140, + "1": 46 + }, + "flags": {}, + "order": 11, + "mode": 0, + "inputs": [ + { + "name": "samples", + "type": "LATENT", + "link": 7 + }, + { + "name": "vae", + "type": "VAE", + "link": 8 + } + ], + "outputs": [ + { + "name": "IMAGE", + "type": "IMAGE", + "links": [ + 9 + ], + "slot_index": 0 + } + ], + "properties": { + "Node name for S&R": "VAEDecode" + } + }, + { + "id": 5, + "type": "EmptyLatentImage", + "pos": [ + 870, + 1100 + ], + "size": { + "0": 315, + "1": 106 + }, + "flags": {}, + "order": 0, + "mode": 0, + "outputs": [ + { + "name": "LATENT", + "type": "LATENT", + "links": [ + 2 + ], + "slot_index": 0 + } + ], + "properties": { + "Node name for S&R": "EmptyLatentImage" + }, + "widgets_values": [ + 512, + 512, + 1 + ] + }, + { + "id": 3, + "type": "KSampler", + "pos": [ + 1280, + 710 + ], + "size": { + "0": 315, + "1": 262 + }, + "flags": {}, + "order": 10, + "mode": 0, + "inputs": [ + { + "name": "model", + "type": "MODEL", + "link": 42 + }, + { + "name": "positive", + "type": "CONDITIONING", + "link": 4 + }, + { + "name": "negative", + "type": "CONDITIONING", + "link": 6 + }, + { + "name": "latent_image", + "type": "LATENT", + "link": 2 + } + ], + "outputs": [ + { + "name": "LATENT", + "type": "LATENT", + "links": [ + 7 + ], + "slot_index": 0 + } + ], + "properties": { + "Node name for S&R": "KSampler" + }, + "widgets_values": [ + 0, + "fixed", + 30, + 6.5, + "ddpm", + "karras", + 1 + ] + }, + { + "id": 9, + "type": "SaveImage", + "pos": [ + 1830, + 700 + ], + "size": { + "0": 529.7760009765625, + "1": 582.3048095703125 + }, + "flags": {}, + "order": 12, + "mode": 0, + "inputs": [ + { + "name": "images", + "type": "IMAGE", + "link": 9 + } + ], + "properties": {}, + "widgets_values": [ + "IPAdapter" + ] + }, + { + "id": 12, + "type": "LoadImage", + "pos": [ + 450, + 240 + ], + "size": { + "0": 315, + "1": 314 + }, + "flags": {}, + "order": 1, + "mode": 0, + "outputs": [ + { + "name": "IMAGE", + "type": "IMAGE", + "links": [ + 29 + ], + "shape": 3, + "slot_index": 0 + }, + { + "name": "MASK", + "type": "MASK", + "links": null, + "shape": 3 + } + ], + "properties": { + "Node name for S&R": "LoadImage" + }, + "widgets_values": [ + "rosario_4.jpg", + "image" + ] + }, + { + "id": 7, + "type": "CLIPTextEncode", + "pos": [ + 760, + 850 + ], + "size": { + "0": 425.27801513671875, + "1": 180.6060791015625 + }, + "flags": {}, + "order": 6, + "mode": 0, + "inputs": [ + { + "name": "clip", + "type": "CLIP", + "link": 5 + } + ], + "outputs": [ + { + "name": "CONDITIONING", + "type": "CONDITIONING", + "links": [ + 6 + ], + "slot_index": 0 + } + ], + "properties": { + "Node name for S&R": "CLIPTextEncode" + }, + "widgets_values": [ + "blurry, noisy, messy, lowres, jpeg, artifacts, ill, distorted, malformed, naked" + ] + }, + { + "id": 6, + "type": "CLIPTextEncode", + "pos": [ + 760, + 620 + ], + "size": { + "0": 422.84503173828125, + "1": 164.31304931640625 + }, + "flags": {}, + "order": 5, + "mode": 0, + "inputs": [ + { + "name": "clip", + "type": "CLIP", + "link": 3 + } + ], + "outputs": [ + { + "name": "CONDITIONING", + "type": "CONDITIONING", + "links": [ + 4 + ], + "slot_index": 0 + } + ], + "properties": { + "Node name for S&R": "CLIPTextEncode" + }, + "widgets_values": [ + "closeup of a beautiful woman wearing a black dress on the seaside\n\nserene, sunset, spring, high quality, detailed, diffuse light" + ] + }, + { + "id": 4, + "type": "CheckpointLoaderSimple", + "pos": [ + 10, + 680 + ], + "size": { + "0": 315, + "1": 98 + }, + "flags": {}, + "order": 2, + "mode": 0, + "outputs": [ + { + "name": "MODEL", + "type": "MODEL", + "links": [ + 36 + ], + "slot_index": 0 + }, + { + "name": "CLIP", + "type": "CLIP", + "links": [ + 3, + 5 + ], + "slot_index": 1 + }, + { + "name": "VAE", + "type": "VAE", + "links": [ + 8 + ], + "slot_index": 2 + } + ], + "properties": { + "Node name for S&R": "CheckpointLoaderSimple" + }, + "widgets_values": [ + "sd15/realisticVisionV51_v51VAE.safetensors" + ] + }, + { + "id": 20, + "type": "IPAdapterUnifiedLoaderFaceID", + "pos": [ + 460, + 60 + ], + "size": { + "0": 315, + "1": 126 + }, + "flags": {}, + "order": 4, + "mode": 0, + "inputs": [ + { + "name": "model", + "type": "MODEL", + "link": 36 + }, + { + "name": "ipadapter", + "type": "IPADAPTER", + "link": null + } + ], + "outputs": [ + { + "name": "MODEL", + "type": "MODEL", + "links": [ + 35 + ], + "shape": 3, + "slot_index": 0 + }, + { + "name": "ipadapter", + "type": "IPADAPTER", + "links": [ + 34, + 38 + ], + "shape": 3, + "slot_index": 1 + } + ], + "properties": { + "Node name for S&R": "IPAdapterUnifiedLoaderFaceID" + }, + "widgets_values": [ + "FACEID PLUS V2", + 0.6, + "CPU" + ] + }, + { + "id": 22, + "type": "IPAdapterUnifiedLoader", + "pos": [ + 855, + 51 + ], + "size": { + "0": 315, + "1": 78 + }, + "flags": {}, + "order": 8, + "mode": 0, + "inputs": [ + { + "name": "model", + "type": "MODEL", + "link": 43 + }, + { + "name": "ipadapter", + "type": "IPADAPTER", + "link": 38 + } + ], + "outputs": [ + { + "name": "model", + "type": "MODEL", + "links": [ + 40 + ], + "shape": 3, + "slot_index": 0 + }, + { + "name": "ipadapter", + "type": "IPADAPTER", + "links": [ + 37 + ], + "shape": 3 + } + ], + "properties": { + "Node name for S&R": "IPAdapterUnifiedLoader" + }, + "widgets_values": [ + "FULL FACE - SD1.5 only (portraits stronger)" + ] + }, + { + "id": 21, + "type": "IPAdapter", + "pos": [ + 1280, + 170 + ], + "size": { + "0": 315, + "1": 166 + }, + "flags": {}, + "order": 9, + "mode": 0, + "inputs": [ + { + "name": "model", + "type": "MODEL", + "link": 40 + }, + { + "name": "ipadapter", + "type": "IPADAPTER", + "link": 37, + "slot_index": 1 + }, + { + "name": "image", + "type": "IMAGE", + "link": 41 + }, + { + "name": "attn_mask", + "type": "MASK", + "link": null + } + ], + "outputs": [ + { + "name": "MODEL", + "type": "MODEL", + "links": [ + 42 + ], + "shape": 3, + "slot_index": 0 + } + ], + "properties": { + "Node name for S&R": "IPAdapter" + }, + "widgets_values": [ + 0.4, + 0, + 1 + ] + }, + { + "id": 18, + "type": "IPAdapterFaceID", + "pos": [ + 850, + 190 + ], + "size": { + "0": 315, + "1": 298 + }, + "flags": {}, + "order": 7, + "mode": 0, + "inputs": [ + { + "name": "model", + "type": "MODEL", + "link": 35 + }, + { + "name": "ipadapter", + "type": "IPADAPTER", + "link": 34, + "slot_index": 1 + }, + { + "name": "image", + "type": "IMAGE", + "link": 29 + }, + { + "name": "image_negative", + "type": "IMAGE", + "link": null + }, + { + "name": "attn_mask", + "type": "MASK", + "link": null + }, + { + "name": "clip_vision", + "type": "CLIP_VISION", + "link": null + }, + { + "name": "insightface", + "type": "INSIGHTFACE", + "link": null + } + ], + "outputs": [ + { + "name": "MODEL", + "type": "MODEL", + "links": [ + 43 + ], + "shape": 3, + "slot_index": 0 + } + ], + "properties": { + "Node name for S&R": "IPAdapterFaceID" + }, + "widgets_values": [ + 0.8, + 2, + "linear", + "concat", + 0, + 1 + ] + }, + { + "id": 23, + "type": "LoadImage", + "pos": [ + 1280, + -230 + ], + "size": { + "0": 315, + "1": 314 + }, + "flags": {}, + "order": 3, + "mode": 0, + "outputs": [ + { + "name": "IMAGE", + "type": "IMAGE", + "links": [ + 41 + ], + "shape": 3, + "slot_index": 0 + }, + { + "name": "MASK", + "type": "MASK", + "links": null, + "shape": 3 + } + ], + "properties": { + "Node name for S&R": "LoadImage" + }, + "widgets_values": [ + "rosario.png", + "image" + ] + } + ], + "links": [ + [ + 2, + 5, + 0, + 3, + 3, + "LATENT" + ], + [ + 3, + 4, + 1, + 6, + 0, + "CLIP" + ], + [ + 4, + 6, + 0, + 3, + 1, + "CONDITIONING" + ], + [ + 5, + 4, + 1, + 7, + 0, + "CLIP" + ], + [ + 6, + 7, + 0, + 3, + 2, + "CONDITIONING" + ], + [ + 7, + 3, + 0, + 8, + 0, + "LATENT" + ], + [ + 8, + 4, + 2, + 8, + 1, + "VAE" + ], + [ + 9, + 8, + 0, + 9, + 0, + "IMAGE" + ], + [ + 29, + 12, + 0, + 18, + 2, + "IMAGE" + ], + [ + 34, + 20, + 1, + 18, + 1, + "IPADAPTER" + ], + [ + 35, + 20, + 0, + 18, + 0, + "MODEL" + ], + [ + 36, + 4, + 0, + 20, + 0, + "MODEL" + ], + [ + 37, + 22, + 1, + 21, + 1, + "IPADAPTER" + ], + [ + 38, + 20, + 1, + 22, + 1, + "IPADAPTER" + ], + [ + 40, + 22, + 0, + 21, + 0, + "MODEL" + ], + [ + 41, + 23, + 0, + 21, + 2, + "IMAGE" + ], + [ + 42, + 21, + 0, + 3, + 0, + "MODEL" + ], + [ + 43, + 18, + 0, + 22, + 0, + "MODEL" + ] + ], + "groups": [], + "config": {}, + "extra": {}, + "version": 0.4 +} \ No newline at end of file diff --git a/imports/ComfyUI_IPAdapter_plus/examples/ipadapter_negative_image.json b/imports/ComfyUI_IPAdapter_plus/examples/ipadapter_negative_image.json new file mode 100644 index 0000000..2c783bd --- /dev/null +++ b/imports/ComfyUI_IPAdapter_plus/examples/ipadapter_negative_image.json @@ -0,0 +1,956 @@ +{ + "last_node_id": 24, + "last_link_id": 49, + "nodes": [ + { + "id": 4, + "type": "CheckpointLoaderSimple", + "pos": [ + 50, + 730 + ], + "size": { + "0": 315, + "1": 98 + }, + "flags": {}, + "order": 0, + "mode": 0, + "outputs": [ + { + "name": "MODEL", + "type": "MODEL", + "links": [ + 20, + 44 + ], + "slot_index": 0 + }, + { + "name": "CLIP", + "type": "CLIP", + "links": [ + 3, + 5 + ], + "slot_index": 1 + }, + { + "name": "VAE", + "type": "VAE", + "links": [ + 8, + 42 + ], + "slot_index": 2 + } + ], + "properties": { + "Node name for S&R": "CheckpointLoaderSimple" + }, + "widgets_values": [ + "sd15/realisticVisionV51_v51VAE.safetensors" + ] + }, + { + "id": 9, + "type": "SaveImage", + "pos": [ + 1770, + 710 + ], + "size": { + "0": 529.7760009765625, + "1": 582.3048095703125 + }, + "flags": {}, + "order": 15, + "mode": 0, + "inputs": [ + { + "name": "images", + "type": "IMAGE", + "link": 9 + } + ], + "properties": {}, + "widgets_values": [ + "IPAdapter" + ] + }, + { + "id": 7, + "type": "CLIPTextEncode", + "pos": [ + 690, + 840 + ], + "size": { + "0": 425.27801513671875, + "1": 180.6060791015625 + }, + "flags": {}, + "order": 7, + "mode": 0, + "inputs": [ + { + "name": "clip", + "type": "CLIP", + "link": 5 + } + ], + "outputs": [ + { + "name": "CONDITIONING", + "type": "CONDITIONING", + "links": [ + 6, + 39 + ], + "slot_index": 0 + } + ], + "properties": { + "Node name for S&R": "CLIPTextEncode" + }, + "widgets_values": [ + "blurry, noisy, messy, lowres, jpeg, artifacts, ill, distorted, malformed" + ] + }, + { + "id": 5, + "type": "EmptyLatentImage", + "pos": [ + 801, + 1097 + ], + "size": { + "0": 315, + "1": 106 + }, + "flags": {}, + "order": 1, + "mode": 0, + "outputs": [ + { + "name": "LATENT", + "type": "LATENT", + "links": [ + 2, + 40 + ], + "slot_index": 0 + } + ], + "properties": { + "Node name for S&R": "EmptyLatentImage" + }, + "widgets_values": [ + 512, + 512, + 1 + ] + }, + { + "id": 16, + "type": "CLIPVisionLoader", + "pos": [ + 308, + 161 + ], + "size": { + "0": 315, + "1": 58 + }, + "flags": {}, + "order": 2, + "mode": 0, + "outputs": [ + { + "name": "CLIP_VISION", + "type": "CLIP_VISION", + "links": [ + 24, + 48 + ], + "shape": 3 + } + ], + "properties": { + "Node name for S&R": "CLIPVisionLoader" + }, + "widgets_values": [ + "IPAdapter_image_encoder_sd15.safetensors" + ] + }, + { + "id": 15, + "type": "IPAdapterModelLoader", + "pos": [ + 308, + 52 + ], + "size": { + "0": 315, + "1": 58 + }, + "flags": {}, + "order": 3, + "mode": 0, + "outputs": [ + { + "name": "IPADAPTER", + "type": "IPADAPTER", + "links": [ + 33, + 45 + ], + "shape": 3 + } + ], + "properties": { + "Node name for S&R": "IPAdapterModelLoader" + }, + "widgets_values": [ + "ip-adapter-plus_sd15.safetensors" + ] + }, + { + "id": 3, + "type": "KSampler", + "pos": [ + 1210, + 700 + ], + "size": { + "0": 315, + "1": 262 + }, + "flags": {}, + "order": 11, + "mode": 0, + "inputs": [ + { + "name": "model", + "type": "MODEL", + "link": 23 + }, + { + "name": "positive", + "type": "CONDITIONING", + "link": 4 + }, + { + "name": "negative", + "type": "CONDITIONING", + "link": 6 + }, + { + "name": "latent_image", + "type": "LATENT", + "link": 2 + } + ], + "outputs": [ + { + "name": "LATENT", + "type": "LATENT", + "links": [ + 7 + ], + "slot_index": 0 + } + ], + "properties": { + "Node name for S&R": "KSampler" + }, + "widgets_values": [ + 0, + "fixed", + 30, + 6.5, + "dpmpp_2m_sde_gpu", + "exponential", + 1 + ] + }, + { + "id": 8, + "type": "VAEDecode", + "pos": [ + 1575, + 705 + ], + "size": { + "0": 140, + "1": 46 + }, + "flags": {}, + "order": 13, + "mode": 0, + "inputs": [ + { + "name": "samples", + "type": "LATENT", + "link": 7 + }, + { + "name": "vae", + "type": "VAE", + "link": 8 + } + ], + "outputs": [ + { + "name": "IMAGE", + "type": "IMAGE", + "links": [ + 9 + ], + "slot_index": 0 + } + ], + "properties": { + "Node name for S&R": "VAEDecode" + } + }, + { + "id": 6, + "type": "CLIPTextEncode", + "pos": [ + 690, + 610 + ], + "size": { + "0": 422.84503173828125, + "1": 164.31304931640625 + }, + "flags": {}, + "order": 6, + "mode": 0, + "inputs": [ + { + "name": "clip", + "type": "CLIP", + "link": 3 + } + ], + "outputs": [ + { + "name": "CONDITIONING", + "type": "CONDITIONING", + "links": [ + 4, + 38 + ], + "slot_index": 0 + } + ], + "properties": { + "Node name for S&R": "CLIPTextEncode" + }, + "widgets_values": [ + "a castle on a cliff\n\nhigh quality, detailed, diffuse light" + ] + }, + { + "id": 24, + "type": "IPAdapterAdvanced", + "pos": [ + 1800, + 330 + ], + "size": { + "0": 315, + "1": 254 + }, + "flags": {}, + "order": 10, + "mode": 0, + "inputs": [ + { + "name": "model", + "type": "MODEL", + "link": 44 + }, + { + "name": "ipadapter", + "type": "IPADAPTER", + "link": 45, + "slot_index": 1 + }, + { + "name": "image", + "type": "IMAGE", + "link": 46 + }, + { + "name": "image_negative", + "type": "IMAGE", + "link": 49 + }, + { + "name": "attn_mask", + "type": "MASK", + "link": null + }, + { + "name": "clip_vision", + "type": "CLIP_VISION", + "link": 48, + "slot_index": 5 + } + ], + "outputs": [ + { + "name": "MODEL", + "type": "MODEL", + "links": [ + 37 + ], + "shape": 3, + "slot_index": 0 + } + ], + "properties": { + "Node name for S&R": "IPAdapterAdvanced" + }, + "widgets_values": [ + 0.7000000000000001, + "linear", + "concat", + 0, + 1 + ] + }, + { + "id": 20, + "type": "PrepImageForClipVision", + "pos": [ + 775, + 347 + ], + "size": [ + 210, + 106 + ], + "flags": {}, + "order": 8, + "mode": 0, + "inputs": [ + { + "name": "image", + "type": "IMAGE", + "link": 35 + } + ], + "outputs": [ + { + "name": "IMAGE", + "type": "IMAGE", + "links": [ + 36, + 46 + ], + "shape": 3, + "slot_index": 0 + } + ], + "properties": { + "Node name for S&R": "PrepImageForClipVision" + }, + "widgets_values": [ + "LANCZOS", + "top", + 0 + ] + }, + { + "id": 21, + "type": "KSampler", + "pos": [ + 2190, + 330 + ], + "size": { + "0": 315, + "1": 262 + }, + "flags": {}, + "order": 12, + "mode": 0, + "inputs": [ + { + "name": "model", + "type": "MODEL", + "link": 37 + }, + { + "name": "positive", + "type": "CONDITIONING", + "link": 38 + }, + { + "name": "negative", + "type": "CONDITIONING", + "link": 39 + }, + { + "name": "latent_image", + "type": "LATENT", + "link": 40 + } + ], + "outputs": [ + { + "name": "LATENT", + "type": "LATENT", + "links": [ + 41 + ], + "slot_index": 0 + } + ], + "properties": { + "Node name for S&R": "KSampler" + }, + "widgets_values": [ + 0, + "fixed", + 30, + 6.5, + "dpmpp_2m_sde_gpu", + "exponential", + 1 + ] + }, + { + "id": 14, + "type": "IPAdapterAdvanced", + "pos": [ + 1199, + 346 + ], + "size": { + "0": 315, + "1": 254 + }, + "flags": {}, + "order": 9, + "mode": 0, + "inputs": [ + { + "name": "model", + "type": "MODEL", + "link": 20 + }, + { + "name": "ipadapter", + "type": "IPADAPTER", + "link": 33, + "slot_index": 1 + }, + { + "name": "image", + "type": "IMAGE", + "link": 36 + }, + { + "name": "image_negative", + "type": "IMAGE", + "link": null + }, + { + "name": "attn_mask", + "type": "MASK", + "link": null + }, + { + "name": "clip_vision", + "type": "CLIP_VISION", + "link": 24, + "slot_index": 5 + } + ], + "outputs": [ + { + "name": "MODEL", + "type": "MODEL", + "links": [ + 23 + ], + "shape": 3, + "slot_index": 0 + } + ], + "properties": { + "Node name for S&R": "IPAdapterAdvanced" + }, + "widgets_values": [ + 0.7000000000000001, + "linear", + "concat", + 0, + 1 + ] + }, + { + "id": 23, + "type": "SaveImage", + "pos": [ + 2333, + 711 + ], + "size": { + "0": 529.7760009765625, + "1": 582.3048095703125 + }, + "flags": {}, + "order": 16, + "mode": 0, + "inputs": [ + { + "name": "images", + "type": "IMAGE", + "link": 43 + } + ], + "properties": {}, + "widgets_values": [ + "IPAdapter" + ] + }, + { + "id": 19, + "type": "LoadImage", + "pos": [ + 1206, + -41 + ], + "size": { + "0": 315, + "1": 314 + }, + "flags": {}, + "order": 4, + "mode": 0, + "outputs": [ + { + "name": "IMAGE", + "type": "IMAGE", + "links": [ + 49 + ], + "shape": 3, + "slot_index": 0 + }, + { + "name": "MASK", + "type": "MASK", + "links": null, + "shape": 3 + } + ], + "properties": { + "Node name for S&R": "LoadImage" + }, + "widgets_values": [ + "trees.jpg", + "image" + ] + }, + { + "id": 12, + "type": "LoadImage", + "pos": [ + 313, + 291 + ], + "size": { + "0": 315, + "1": 314 + }, + "flags": {}, + "order": 5, + "mode": 0, + "outputs": [ + { + "name": "IMAGE", + "type": "IMAGE", + "links": [ + 35 + ], + "shape": 3, + "slot_index": 0 + }, + { + "name": "MASK", + "type": "MASK", + "links": null, + "shape": 3 + } + ], + "properties": { + "Node name for S&R": "LoadImage" + }, + "widgets_values": [ + "castle.jpg", + "image" + ] + }, + { + "id": 22, + "type": "VAEDecode", + "pos": [ + 2581, + 331 + ], + "size": { + "0": 140, + "1": 46 + }, + "flags": {}, + "order": 14, + "mode": 0, + "inputs": [ + { + "name": "samples", + "type": "LATENT", + "link": 41 + }, + { + "name": "vae", + "type": "VAE", + "link": 42 + } + ], + "outputs": [ + { + "name": "IMAGE", + "type": "IMAGE", + "links": [ + 43 + ], + "slot_index": 0 + } + ], + "properties": { + "Node name for S&R": "VAEDecode" + } + } + ], + "links": [ + [ + 2, + 5, + 0, + 3, + 3, + "LATENT" + ], + [ + 3, + 4, + 1, + 6, + 0, + "CLIP" + ], + [ + 4, + 6, + 0, + 3, + 1, + "CONDITIONING" + ], + [ + 5, + 4, + 1, + 7, + 0, + "CLIP" + ], + [ + 6, + 7, + 0, + 3, + 2, + "CONDITIONING" + ], + [ + 7, + 3, + 0, + 8, + 0, + "LATENT" + ], + [ + 8, + 4, + 2, + 8, + 1, + "VAE" + ], + [ + 9, + 8, + 0, + 9, + 0, + "IMAGE" + ], + [ + 20, + 4, + 0, + 14, + 0, + "MODEL" + ], + [ + 23, + 14, + 0, + 3, + 0, + "MODEL" + ], + [ + 24, + 16, + 0, + 14, + 5, + "CLIP_VISION" + ], + [ + 33, + 15, + 0, + 14, + 1, + "IPADAPTER" + ], + [ + 35, + 12, + 0, + 20, + 0, + "IMAGE" + ], + [ + 36, + 20, + 0, + 14, + 2, + "IMAGE" + ], + [ + 37, + 24, + 0, + 21, + 0, + "MODEL" + ], + [ + 38, + 6, + 0, + 21, + 1, + "CONDITIONING" + ], + [ + 39, + 7, + 0, + 21, + 2, + "CONDITIONING" + ], + [ + 40, + 5, + 0, + 21, + 3, + "LATENT" + ], + [ + 41, + 21, + 0, + 22, + 0, + "LATENT" + ], + [ + 42, + 4, + 2, + 22, + 1, + "VAE" + ], + [ + 43, + 22, + 0, + 23, + 0, + "IMAGE" + ], + [ + 44, + 4, + 0, + 24, + 0, + "MODEL" + ], + [ + 45, + 15, + 0, + 24, + 1, + "IPADAPTER" + ], + [ + 46, + 20, + 0, + 24, + 2, + "IMAGE" + ], + [ + 48, + 16, + 0, + 24, + 5, + "CLIP_VISION" + ], + [ + 49, + 19, + 0, + 24, + 3, + "IMAGE" + ] + ], + "groups": [], + "config": {}, + "extra": {}, + "version": 0.4 +} \ No newline at end of file diff --git a/imports/ComfyUI_IPAdapter_plus/examples/ipadapter_noise_injection.json b/imports/ComfyUI_IPAdapter_plus/examples/ipadapter_noise_injection.json new file mode 100644 index 0000000..0146c03 --- /dev/null +++ b/imports/ComfyUI_IPAdapter_plus/examples/ipadapter_noise_injection.json @@ -0,0 +1,676 @@ +{ + "last_node_id": 18, + "last_link_id": 30, + "nodes": [ + { + "id": 4, + "type": "CheckpointLoaderSimple", + "pos": [ + 50, + 730 + ], + "size": { + "0": 315, + "1": 98 + }, + "flags": {}, + "order": 0, + "mode": 0, + "outputs": [ + { + "name": "MODEL", + "type": "MODEL", + "links": [ + 20 + ], + "slot_index": 0 + }, + { + "name": "CLIP", + "type": "CLIP", + "links": [ + 3, + 5 + ], + "slot_index": 1 + }, + { + "name": "VAE", + "type": "VAE", + "links": [ + 8 + ], + "slot_index": 2 + } + ], + "properties": { + "Node name for S&R": "CheckpointLoaderSimple" + }, + "widgets_values": [ + "sd15/realisticVisionV51_v51VAE.safetensors" + ] + }, + { + "id": 9, + "type": "SaveImage", + "pos": [ + 1770, + 710 + ], + "size": { + "0": 529.7760009765625, + "1": 582.3048095703125 + }, + "flags": {}, + "order": 12, + "mode": 0, + "inputs": [ + { + "name": "images", + "type": "IMAGE", + "link": 9 + } + ], + "properties": {}, + "widgets_values": [ + "IPAdapter" + ] + }, + { + "id": 7, + "type": "CLIPTextEncode", + "pos": [ + 690, + 840 + ], + "size": { + "0": 425.27801513671875, + "1": 180.6060791015625 + }, + "flags": {}, + "order": 6, + "mode": 0, + "inputs": [ + { + "name": "clip", + "type": "CLIP", + "link": 5 + } + ], + "outputs": [ + { + "name": "CONDITIONING", + "type": "CONDITIONING", + "links": [ + 6 + ], + "slot_index": 0 + } + ], + "properties": { + "Node name for S&R": "CLIPTextEncode" + }, + "widgets_values": [ + "blurry, noisy, messy, lowres, jpeg, artifacts, ill, distorted, malformed" + ] + }, + { + "id": 5, + "type": "EmptyLatentImage", + "pos": [ + 801, + 1097 + ], + "size": { + "0": 315, + "1": 106 + }, + "flags": {}, + "order": 1, + "mode": 0, + "outputs": [ + { + "name": "LATENT", + "type": "LATENT", + "links": [ + 2 + ], + "slot_index": 0 + } + ], + "properties": { + "Node name for S&R": "EmptyLatentImage" + }, + "widgets_values": [ + 512, + 512, + 1 + ] + }, + { + "id": 16, + "type": "CLIPVisionLoader", + "pos": [ + 308, + 161 + ], + "size": { + "0": 315, + "1": 58 + }, + "flags": {}, + "order": 2, + "mode": 0, + "outputs": [ + { + "name": "CLIP_VISION", + "type": "CLIP_VISION", + "links": [ + 24 + ], + "shape": 3 + } + ], + "properties": { + "Node name for S&R": "CLIPVisionLoader" + }, + "widgets_values": [ + "IPAdapter_image_encoder_sd15.safetensors" + ] + }, + { + "id": 15, + "type": "IPAdapterModelLoader", + "pos": [ + 308, + 52 + ], + "size": { + "0": 315, + "1": 58 + }, + "flags": {}, + "order": 3, + "mode": 0, + "outputs": [ + { + "name": "IPADAPTER", + "type": "IPADAPTER", + "links": [ + 21 + ], + "shape": 3 + } + ], + "properties": { + "Node name for S&R": "IPAdapterModelLoader" + }, + "widgets_values": [ + "ip-adapter-plus_sd15.safetensors" + ] + }, + { + "id": 6, + "type": "CLIPTextEncode", + "pos": [ + 690, + 610 + ], + "size": { + "0": 422.84503173828125, + "1": 164.31304931640625 + }, + "flags": {}, + "order": 5, + "mode": 0, + "inputs": [ + { + "name": "clip", + "type": "CLIP", + "link": 3 + } + ], + "outputs": [ + { + "name": "CONDITIONING", + "type": "CONDITIONING", + "links": [ + 4 + ], + "slot_index": 0 + } + ], + "properties": { + "Node name for S&R": "CLIPTextEncode" + }, + "widgets_values": [ + "in a peaceful spring morning a woman wearing a white shirt is sitting in a park on a bench\n\nhigh quality, detailed, diffuse light" + ] + }, + { + "id": 12, + "type": "LoadImage", + "pos": [ + 311, + 270 + ], + "size": { + "0": 315, + "1": 314 + }, + "flags": {}, + "order": 4, + "mode": 0, + "outputs": [ + { + "name": "IMAGE", + "type": "IMAGE", + "links": [ + 25 + ], + "shape": 3, + "slot_index": 0 + }, + { + "name": "MASK", + "type": "MASK", + "links": null, + "shape": 3 + } + ], + "properties": { + "Node name for S&R": "LoadImage" + }, + "widgets_values": [ + "girl_sitting.png", + "image" + ] + }, + { + "id": 17, + "type": "PrepImageForClipVision", + "pos": [ + 728, + 290 + ], + "size": [ + 210, + 106 + ], + "flags": {}, + "order": 7, + "mode": 0, + "inputs": [ + { + "name": "image", + "type": "IMAGE", + "link": 25 + } + ], + "outputs": [ + { + "name": "IMAGE", + "type": "IMAGE", + "links": [ + 26, + 29 + ], + "shape": 3, + "slot_index": 0 + } + ], + "properties": { + "Node name for S&R": "PrepImageForClipVision" + }, + "widgets_values": [ + "LANCZOS", + "top", + 0.15 + ] + }, + { + "id": 14, + "type": "IPAdapterAdvanced", + "pos": [ + 1351, + 214 + ], + "size": { + "0": 315, + "1": 254 + }, + "flags": {}, + "order": 9, + "mode": 0, + "inputs": [ + { + "name": "model", + "type": "MODEL", + "link": 20 + }, + { + "name": "ipadapter", + "type": "IPADAPTER", + "link": 21, + "slot_index": 1 + }, + { + "name": "image", + "type": "IMAGE", + "link": 26 + }, + { + "name": "image_negative", + "type": "IMAGE", + "link": 30 + }, + { + "name": "attn_mask", + "type": "MASK", + "link": null + }, + { + "name": "clip_vision", + "type": "CLIP_VISION", + "link": 24, + "slot_index": 5 + } + ], + "outputs": [ + { + "name": "MODEL", + "type": "MODEL", + "links": [ + 23 + ], + "shape": 3, + "slot_index": 0 + } + ], + "properties": { + "Node name for S&R": "IPAdapterAdvanced" + }, + "widgets_values": [ + 0.7000000000000001, + "linear", + "concat", + 0, + 1 + ] + }, + { + "id": 3, + "type": "KSampler", + "pos": [ + 1210, + 700 + ], + "size": { + "0": 315, + "1": 262 + }, + "flags": {}, + "order": 10, + "mode": 0, + "inputs": [ + { + "name": "model", + "type": "MODEL", + "link": 23 + }, + { + "name": "positive", + "type": "CONDITIONING", + "link": 4 + }, + { + "name": "negative", + "type": "CONDITIONING", + "link": 6 + }, + { + "name": "latent_image", + "type": "LATENT", + "link": 2 + } + ], + "outputs": [ + { + "name": "LATENT", + "type": "LATENT", + "links": [ + 7 + ], + "slot_index": 0 + } + ], + "properties": { + "Node name for S&R": "KSampler" + }, + "widgets_values": [ + 0, + "fixed", + 30, + 6.5, + "dpmpp_2m_sde_gpu", + "exponential", + 1 + ] + }, + { + "id": 18, + "type": "IPAdapterNoise", + "pos": [ + 1019, + 405 + ], + "size": [ + 210, + 106 + ], + "flags": {}, + "order": 8, + "mode": 0, + "inputs": [ + { + "name": "image_optional", + "type": "IMAGE", + "link": 29 + } + ], + "outputs": [ + { + "name": "IMAGE", + "type": "IMAGE", + "links": [ + 30 + ], + "shape": 3, + "slot_index": 0 + } + ], + "properties": { + "Node name for S&R": "IPAdapterNoise" + }, + "widgets_values": [ + "fade", + 0.3, + 5 + ] + }, + { + "id": 8, + "type": "VAEDecode", + "pos": [ + 1575, + 705 + ], + "size": { + "0": 140, + "1": 46 + }, + "flags": {}, + "order": 11, + "mode": 0, + "inputs": [ + { + "name": "samples", + "type": "LATENT", + "link": 7 + }, + { + "name": "vae", + "type": "VAE", + "link": 8 + } + ], + "outputs": [ + { + "name": "IMAGE", + "type": "IMAGE", + "links": [ + 9 + ], + "slot_index": 0 + } + ], + "properties": { + "Node name for S&R": "VAEDecode" + } + } + ], + "links": [ + [ + 2, + 5, + 0, + 3, + 3, + "LATENT" + ], + [ + 3, + 4, + 1, + 6, + 0, + "CLIP" + ], + [ + 4, + 6, + 0, + 3, + 1, + "CONDITIONING" + ], + [ + 5, + 4, + 1, + 7, + 0, + "CLIP" + ], + [ + 6, + 7, + 0, + 3, + 2, + "CONDITIONING" + ], + [ + 7, + 3, + 0, + 8, + 0, + "LATENT" + ], + [ + 8, + 4, + 2, + 8, + 1, + "VAE" + ], + [ + 9, + 8, + 0, + 9, + 0, + "IMAGE" + ], + [ + 20, + 4, + 0, + 14, + 0, + "MODEL" + ], + [ + 21, + 15, + 0, + 14, + 1, + "IPADAPTER" + ], + [ + 23, + 14, + 0, + 3, + 0, + "MODEL" + ], + [ + 24, + 16, + 0, + 14, + 5, + "CLIP_VISION" + ], + [ + 25, + 12, + 0, + 17, + 0, + "IMAGE" + ], + [ + 26, + 17, + 0, + 14, + 2, + "IMAGE" + ], + [ + 29, + 17, + 0, + 18, + 0, + "IMAGE" + ], + [ + 30, + 18, + 0, + 14, + 3, + "IMAGE" + ] + ], + "groups": [], + "config": {}, + "extra": {}, + "version": 0.4 +} \ No newline at end of file diff --git a/imports/ComfyUI_IPAdapter_plus/examples/ipadapter_simple.json b/imports/ComfyUI_IPAdapter_plus/examples/ipadapter_simple.json new file mode 100644 index 0000000..e43b058 --- /dev/null +++ b/imports/ComfyUI_IPAdapter_plus/examples/ipadapter_simple.json @@ -0,0 +1,546 @@ +{ + "last_node_id": 13, + "last_link_id": 17, + "nodes": [ + { + "id": 11, + "type": "IPAdapterUnifiedLoader", + "pos": [ + 440, + 440 + ], + "size": { + "0": 315, + "1": 78 + }, + "flags": {}, + "order": 3, + "mode": 0, + "inputs": [ + { + "name": "model", + "type": "MODEL", + "link": 10 + }, + { + "name": "ipadapter", + "type": "IPADAPTER", + "link": null + } + ], + "outputs": [ + { + "name": "model", + "type": "MODEL", + "links": [ + 11 + ], + "shape": 3, + "slot_index": 0 + }, + { + "name": "ipadapter", + "type": "IPADAPTER", + "links": [ + 12 + ], + "shape": 3, + "slot_index": 1 + } + ], + "properties": { + "Node name for S&R": "IPAdapterUnifiedLoader" + }, + "widgets_values": [ + "PLUS (high strength)" + ] + }, + { + "id": 4, + "type": "CheckpointLoaderSimple", + "pos": [ + 50, + 730 + ], + "size": { + "0": 315, + "1": 98 + }, + "flags": {}, + "order": 0, + "mode": 0, + "outputs": [ + { + "name": "MODEL", + "type": "MODEL", + "links": [ + 10 + ], + "slot_index": 0 + }, + { + "name": "CLIP", + "type": "CLIP", + "links": [ + 3, + 5 + ], + "slot_index": 1 + }, + { + "name": "VAE", + "type": "VAE", + "links": [ + 8 + ], + "slot_index": 2 + } + ], + "properties": { + "Node name for S&R": "CheckpointLoaderSimple" + }, + "widgets_values": [ + "sd15/realisticVisionV51_v51VAE.safetensors" + ] + }, + { + "id": 12, + "type": "LoadImage", + "pos": [ + 440, + 60 + ], + "size": [ + 315, + 314 + ], + "flags": {}, + "order": 1, + "mode": 0, + "outputs": [ + { + "name": "IMAGE", + "type": "IMAGE", + "links": [ + 17 + ], + "shape": 3 + }, + { + "name": "MASK", + "type": "MASK", + "links": null, + "shape": 3 + } + ], + "properties": { + "Node name for S&R": "LoadImage" + }, + "widgets_values": [ + "warrior_woman.png", + "image" + ] + }, + { + "id": 3, + "type": "KSampler", + "pos": [ + 1210, + 700 + ], + "size": { + "0": 315, + "1": 262 + }, + "flags": {}, + "order": 7, + "mode": 0, + "inputs": [ + { + "name": "model", + "type": "MODEL", + "link": 13 + }, + { + "name": "positive", + "type": "CONDITIONING", + "link": 4 + }, + { + "name": "negative", + "type": "CONDITIONING", + "link": 6 + }, + { + "name": "latent_image", + "type": "LATENT", + "link": 2 + } + ], + "outputs": [ + { + "name": "LATENT", + "type": "LATENT", + "links": [ + 7 + ], + "slot_index": 0 + } + ], + "properties": { + "Node name for S&R": "KSampler" + }, + "widgets_values": [ + 0, + "fixed", + 30, + 6.5, + "dpmpp_2m", + "karras", + 1 + ] + }, + { + "id": 6, + "type": "CLIPTextEncode", + "pos": [ + 690, + 610 + ], + "size": { + "0": 422.84503173828125, + "1": 164.31304931640625 + }, + "flags": {}, + "order": 4, + "mode": 0, + "inputs": [ + { + "name": "clip", + "type": "CLIP", + "link": 3 + } + ], + "outputs": [ + { + "name": "CONDITIONING", + "type": "CONDITIONING", + "links": [ + 4 + ], + "slot_index": 0 + } + ], + "properties": { + "Node name for S&R": "CLIPTextEncode" + }, + "widgets_values": [ + "closeup of a fierce warrior woman wearing a full armor at the end of a battle\n\nhigh quality, detailed" + ] + }, + { + "id": 10, + "type": "IPAdapter", + "pos": [ + 820, + 350 + ], + "size": { + "0": 315, + "1": 166 + }, + "flags": {}, + "order": 6, + "mode": 0, + "inputs": [ + { + "name": "model", + "type": "MODEL", + "link": 11 + }, + { + "name": "ipadapter", + "type": "IPADAPTER", + "link": 12 + }, + { + "name": "image", + "type": "IMAGE", + "link": 17, + "slot_index": 2 + }, + { + "name": "attn_mask", + "type": "MASK", + "link": null + } + ], + "outputs": [ + { + "name": "MODEL", + "type": "MODEL", + "links": [ + 13 + ], + "shape": 3, + "slot_index": 0 + } + ], + "properties": { + "Node name for S&R": "IPAdapter" + }, + "widgets_values": [ + 0.8, + 0, + 1 + ] + }, + { + "id": 9, + "type": "SaveImage", + "pos": [ + 1770, + 710 + ], + "size": [ + 529.7760009765616, + 582.3048192804504 + ], + "flags": {}, + "order": 9, + "mode": 0, + "inputs": [ + { + "name": "images", + "type": "IMAGE", + "link": 9 + } + ], + "properties": {}, + "widgets_values": [ + "IPAdapter" + ] + }, + { + "id": 7, + "type": "CLIPTextEncode", + "pos": [ + 690, + 840 + ], + "size": { + "0": 425.27801513671875, + "1": 180.6060791015625 + }, + "flags": {}, + "order": 5, + "mode": 0, + "inputs": [ + { + "name": "clip", + "type": "CLIP", + "link": 5 + } + ], + "outputs": [ + { + "name": "CONDITIONING", + "type": "CONDITIONING", + "links": [ + 6 + ], + "slot_index": 0 + } + ], + "properties": { + "Node name for S&R": "CLIPTextEncode" + }, + "widgets_values": [ + "blurry, noisy, messy, lowres, jpeg, artifacts, ill, distorted, malformed" + ] + }, + { + "id": 8, + "type": "VAEDecode", + "pos": [ + 1570, + 700 + ], + "size": [ + 140, + 46 + ], + "flags": {}, + "order": 8, + "mode": 0, + "inputs": [ + { + "name": "samples", + "type": "LATENT", + "link": 7 + }, + { + "name": "vae", + "type": "VAE", + "link": 8 + } + ], + "outputs": [ + { + "name": "IMAGE", + "type": "IMAGE", + "links": [ + 9 + ], + "slot_index": 0 + } + ], + "properties": { + "Node name for S&R": "VAEDecode" + } + }, + { + "id": 5, + "type": "EmptyLatentImage", + "pos": [ + 801, + 1097 + ], + "size": { + "0": 315, + "1": 106 + }, + "flags": {}, + "order": 2, + "mode": 0, + "outputs": [ + { + "name": "LATENT", + "type": "LATENT", + "links": [ + 2 + ], + "slot_index": 0 + } + ], + "properties": { + "Node name for S&R": "EmptyLatentImage" + }, + "widgets_values": [ + 512, + 512, + 1 + ] + } + ], + "links": [ + [ + 2, + 5, + 0, + 3, + 3, + "LATENT" + ], + [ + 3, + 4, + 1, + 6, + 0, + "CLIP" + ], + [ + 4, + 6, + 0, + 3, + 1, + "CONDITIONING" + ], + [ + 5, + 4, + 1, + 7, + 0, + "CLIP" + ], + [ + 6, + 7, + 0, + 3, + 2, + "CONDITIONING" + ], + [ + 7, + 3, + 0, + 8, + 0, + "LATENT" + ], + [ + 8, + 4, + 2, + 8, + 1, + "VAE" + ], + [ + 9, + 8, + 0, + 9, + 0, + "IMAGE" + ], + [ + 10, + 4, + 0, + 11, + 0, + "MODEL" + ], + [ + 11, + 11, + 0, + 10, + 0, + "MODEL" + ], + [ + 12, + 11, + 1, + 10, + 1, + "IPADAPTER" + ], + [ + 13, + 10, + 0, + 3, + 0, + "MODEL" + ], + [ + 17, + 12, + 0, + 10, + 2, + "IMAGE" + ] + ], + "groups": [], + "config": {}, + "extra": {}, + "version": 0.4 +} \ No newline at end of file diff --git a/imports/ComfyUI_IPAdapter_plus/examples/ipadapter_tiled.json b/imports/ComfyUI_IPAdapter_plus/examples/ipadapter_tiled.json new file mode 100644 index 0000000..48a02c8 --- /dev/null +++ b/imports/ComfyUI_IPAdapter_plus/examples/ipadapter_tiled.json @@ -0,0 +1,582 @@ +{ + "last_node_id": 18, + "last_link_id": 32, + "nodes": [ + { + "id": 4, + "type": "CheckpointLoaderSimple", + "pos": [ + 50, + 730 + ], + "size": { + "0": 315, + "1": 98 + }, + "flags": {}, + "order": 0, + "mode": 0, + "outputs": [ + { + "name": "MODEL", + "type": "MODEL", + "links": [ + 29 + ], + "slot_index": 0 + }, + { + "name": "CLIP", + "type": "CLIP", + "links": [ + 3, + 5 + ], + "slot_index": 1 + }, + { + "name": "VAE", + "type": "VAE", + "links": [ + 8 + ], + "slot_index": 2 + } + ], + "properties": { + "Node name for S&R": "CheckpointLoaderSimple" + }, + "widgets_values": [ + "sd15/realisticVisionV51_v51VAE.safetensors" + ] + }, + { + "id": 7, + "type": "CLIPTextEncode", + "pos": [ + 690, + 840 + ], + "size": { + "0": 425.27801513671875, + "1": 180.6060791015625 + }, + "flags": {}, + "order": 6, + "mode": 0, + "inputs": [ + { + "name": "clip", + "type": "CLIP", + "link": 5 + } + ], + "outputs": [ + { + "name": "CONDITIONING", + "type": "CONDITIONING", + "links": [ + 6 + ], + "slot_index": 0 + } + ], + "properties": { + "Node name for S&R": "CLIPTextEncode" + }, + "widgets_values": [ + "blurry, noisy, messy, lowres, jpeg, artifacts, ill, distorted, malformed" + ] + }, + { + "id": 8, + "type": "VAEDecode", + "pos": [ + 1570, + 700 + ], + "size": { + "0": 140, + "1": 46 + }, + "flags": {}, + "order": 9, + "mode": 0, + "inputs": [ + { + "name": "samples", + "type": "LATENT", + "link": 7 + }, + { + "name": "vae", + "type": "VAE", + "link": 8 + } + ], + "outputs": [ + { + "name": "IMAGE", + "type": "IMAGE", + "links": [ + 9 + ], + "slot_index": 0 + } + ], + "properties": { + "Node name for S&R": "VAEDecode" + } + }, + { + "id": 12, + "type": "LoadImage", + "pos": [ + 250, + 290 + ], + "size": { + "0": 315, + "1": 314 + }, + "flags": {}, + "order": 1, + "mode": 0, + "outputs": [ + { + "name": "IMAGE", + "type": "IMAGE", + "links": [ + 27 + ], + "shape": 3, + "slot_index": 0 + }, + { + "name": "MASK", + "type": "MASK", + "links": null, + "shape": 3 + } + ], + "properties": { + "Node name for S&R": "LoadImage" + }, + "widgets_values": [ + "girl_sitting.png", + "image" + ] + }, + { + "id": 6, + "type": "CLIPTextEncode", + "pos": [ + 690, + 610 + ], + "size": { + "0": 422.84503173828125, + "1": 164.31304931640625 + }, + "flags": {}, + "order": 5, + "mode": 0, + "inputs": [ + { + "name": "clip", + "type": "CLIP", + "link": 3 + } + ], + "outputs": [ + { + "name": "CONDITIONING", + "type": "CONDITIONING", + "links": [ + 4 + ], + "slot_index": 0 + } + ], + "properties": { + "Node name for S&R": "CLIPTextEncode" + }, + "widgets_values": [ + "in a peaceful spring morning a woman wearing a white shirt is sitting in a park on a bench\n\nhigh quality, detailed, diffuse light" + ] + }, + { + "id": 16, + "type": "CLIPVisionLoader", + "pos": [ + 250, + 180 + ], + "size": { + "0": 315, + "1": 58 + }, + "flags": {}, + "order": 2, + "mode": 0, + "outputs": [ + { + "name": "CLIP_VISION", + "type": "CLIP_VISION", + "links": [ + 32 + ], + "shape": 3, + "slot_index": 0 + } + ], + "properties": { + "Node name for S&R": "CLIPVisionLoader" + }, + "widgets_values": [ + "IPAdapter_image_encoder_sd15.safetensors" + ] + }, + { + "id": 5, + "type": "EmptyLatentImage", + "pos": [ + 801, + 1097 + ], + "size": { + "0": 315, + "1": 106 + }, + "flags": {}, + "order": 3, + "mode": 0, + "outputs": [ + { + "name": "LATENT", + "type": "LATENT", + "links": [ + 2 + ], + "slot_index": 0 + } + ], + "properties": { + "Node name for S&R": "EmptyLatentImage" + }, + "widgets_values": [ + 512, + 768, + 1 + ] + }, + { + "id": 3, + "type": "KSampler", + "pos": [ + 1210, + 700 + ], + "size": { + "0": 315, + "1": 262 + }, + "flags": {}, + "order": 8, + "mode": 0, + "inputs": [ + { + "name": "model", + "type": "MODEL", + "link": 30 + }, + { + "name": "positive", + "type": "CONDITIONING", + "link": 4 + }, + { + "name": "negative", + "type": "CONDITIONING", + "link": 6 + }, + { + "name": "latent_image", + "type": "LATENT", + "link": 2 + } + ], + "outputs": [ + { + "name": "LATENT", + "type": "LATENT", + "links": [ + 7 + ], + "slot_index": 0 + } + ], + "properties": { + "Node name for S&R": "KSampler" + }, + "widgets_values": [ + 2, + "fixed", + 30, + 6.5, + "ddpm", + "karras", + 1 + ] + }, + { + "id": 15, + "type": "IPAdapterModelLoader", + "pos": [ + 250, + 70 + ], + "size": { + "0": 315, + "1": 58 + }, + "flags": {}, + "order": 4, + "mode": 0, + "outputs": [ + { + "name": "IPADAPTER", + "type": "IPADAPTER", + "links": [ + 31 + ], + "shape": 3, + "slot_index": 0 + } + ], + "properties": { + "Node name for S&R": "IPAdapterModelLoader" + }, + "widgets_values": [ + "ip-adapter-plus_sd15.safetensors" + ] + }, + { + "id": 18, + "type": "IPAdapterTiled", + "pos": [ + 700, + 230 + ], + "size": { + "0": 315, + "1": 278 + }, + "flags": {}, + "order": 7, + "mode": 0, + "inputs": [ + { + "name": "model", + "type": "MODEL", + "link": 29 + }, + { + "name": "ipadapter", + "type": "IPADAPTER", + "link": 31 + }, + { + "name": "image", + "type": "IMAGE", + "link": 27 + }, + { + "name": "image_negative", + "type": "IMAGE", + "link": null + }, + { + "name": "attn_mask", + "type": "MASK", + "link": null + }, + { + "name": "clip_vision", + "type": "CLIP_VISION", + "link": 32 + } + ], + "outputs": [ + { + "name": "MODEL", + "type": "MODEL", + "links": [ + 30 + ], + "shape": 3, + "slot_index": 0 + }, + { + "name": "tiles", + "type": "IMAGE", + "links": null, + "shape": 3 + }, + { + "name": "masks", + "type": "MASK", + "links": null, + "shape": 3 + } + ], + "properties": { + "Node name for S&R": "IPAdapterTiled" + }, + "widgets_values": [ + 0.7000000000000001, + "ease in", + "concat", + 0, + 1, + 0 + ] + }, + { + "id": 9, + "type": "SaveImage", + "pos": [ + 1768, + 700 + ], + "size": { + "0": 529.7760009765625, + "1": 582.3048095703125 + }, + "flags": {}, + "order": 10, + "mode": 0, + "inputs": [ + { + "name": "images", + "type": "IMAGE", + "link": 9 + } + ], + "properties": {}, + "widgets_values": [ + "IPAdapter" + ] + } + ], + "links": [ + [ + 2, + 5, + 0, + 3, + 3, + "LATENT" + ], + [ + 3, + 4, + 1, + 6, + 0, + "CLIP" + ], + [ + 4, + 6, + 0, + 3, + 1, + "CONDITIONING" + ], + [ + 5, + 4, + 1, + 7, + 0, + "CLIP" + ], + [ + 6, + 7, + 0, + 3, + 2, + "CONDITIONING" + ], + [ + 7, + 3, + 0, + 8, + 0, + "LATENT" + ], + [ + 8, + 4, + 2, + 8, + 1, + "VAE" + ], + [ + 9, + 8, + 0, + 9, + 0, + "IMAGE" + ], + [ + 27, + 12, + 0, + 18, + 2, + "IMAGE" + ], + [ + 29, + 4, + 0, + 18, + 0, + "MODEL" + ], + [ + 30, + 18, + 0, + 3, + 0, + "MODEL" + ], + [ + 31, + 15, + 0, + 18, + 1, + "IPADAPTER" + ], + [ + 32, + 16, + 0, + 18, + 5, + "CLIP_VISION" + ] + ], + "groups": [], + "config": {}, + "extra": {}, + "version": 0.4 +} \ No newline at end of file diff --git a/imports/ComfyUI_IPAdapter_plus/examples/ipadapter_weight_types.json b/imports/ComfyUI_IPAdapter_plus/examples/ipadapter_weight_types.json new file mode 100644 index 0000000..7efe9aa --- /dev/null +++ b/imports/ComfyUI_IPAdapter_plus/examples/ipadapter_weight_types.json @@ -0,0 +1,1733 @@ +{ + "last_node_id": 37, + "last_link_id": 82, + "nodes": [ + { + "id": 4, + "type": "CheckpointLoaderSimple", + "pos": [ + 50, + 730 + ], + "size": { + "0": 315, + "1": 98 + }, + "flags": {}, + "order": 0, + "mode": 0, + "outputs": [ + { + "name": "MODEL", + "type": "MODEL", + "links": [ + 20, + 35, + 46, + 57, + 68 + ], + "slot_index": 0 + }, + { + "name": "CLIP", + "type": "CLIP", + "links": [ + 3, + 5 + ], + "slot_index": 1 + }, + { + "name": "VAE", + "type": "VAE", + "links": [ + 8, + 33, + 44, + 55, + 66 + ], + "slot_index": 2 + } + ], + "properties": { + "Node name for S&R": "CheckpointLoaderSimple" + }, + "widgets_values": [ + "sd15/realisticVisionV51_v51VAE.safetensors" + ] + }, + { + "id": 7, + "type": "CLIPTextEncode", + "pos": [ + 690, + 840 + ], + "size": { + "0": 425.27801513671875, + "1": 180.6060791015625 + }, + "flags": {}, + "order": 6, + "mode": 0, + "inputs": [ + { + "name": "clip", + "type": "CLIP", + "link": 5 + } + ], + "outputs": [ + { + "name": "CONDITIONING", + "type": "CONDITIONING", + "links": [ + 6, + 30, + 41, + 52, + 63 + ], + "slot_index": 0 + } + ], + "properties": { + "Node name for S&R": "CLIPTextEncode" + }, + "widgets_values": [ + "blurry, noisy, messy, lowres, jpeg, artifacts, ill, distorted, malformed" + ] + }, + { + "id": 5, + "type": "EmptyLatentImage", + "pos": [ + 801, + 1097 + ], + "size": { + "0": 315, + "1": 106 + }, + "flags": {}, + "order": 1, + "mode": 0, + "outputs": [ + { + "name": "LATENT", + "type": "LATENT", + "links": [ + 2, + 31, + 42, + 53, + 64 + ], + "slot_index": 0 + } + ], + "properties": { + "Node name for S&R": "EmptyLatentImage" + }, + "widgets_values": [ + 512, + 512, + 1 + ] + }, + { + "id": 16, + "type": "CLIPVisionLoader", + "pos": [ + 308, + 161 + ], + "size": { + "0": 315, + "1": 58 + }, + "flags": {}, + "order": 2, + "mode": 0, + "outputs": [ + { + "name": "CLIP_VISION", + "type": "CLIP_VISION", + "links": [ + 24, + 38, + 49, + 60, + 71 + ], + "shape": 3 + } + ], + "properties": { + "Node name for S&R": "CLIPVisionLoader" + }, + "widgets_values": [ + "IPAdapter_image_encoder_sd15.safetensors" + ] + }, + { + "id": 15, + "type": "IPAdapterModelLoader", + "pos": [ + 308, + 52 + ], + "size": { + "0": 315, + "1": 58 + }, + "flags": {}, + "order": 3, + "mode": 0, + "outputs": [ + { + "name": "IPADAPTER", + "type": "IPADAPTER", + "links": [ + 21, + 36, + 47, + 58, + 69 + ], + "shape": 3 + } + ], + "properties": { + "Node name for S&R": "IPAdapterModelLoader" + }, + "widgets_values": [ + "ip-adapter-plus_sd15.safetensors" + ] + }, + { + "id": 12, + "type": "LoadImage", + "pos": [ + 311, + 270 + ], + "size": { + "0": 315, + "1": 314 + }, + "flags": {}, + "order": 4, + "mode": 0, + "outputs": [ + { + "name": "IMAGE", + "type": "IMAGE", + "links": [ + 27, + 37, + 48, + 59, + 70 + ], + "shape": 3, + "slot_index": 0 + }, + { + "name": "MASK", + "type": "MASK", + "links": null, + "shape": 3 + } + ], + "properties": { + "Node name for S&R": "LoadImage" + }, + "widgets_values": [ + "warrior_woman.png", + "image" + ] + }, + { + "id": 3, + "type": "KSampler", + "pos": [ + 1660, + 290 + ], + "size": { + "0": 315, + "1": 262 + }, + "flags": {}, + "order": 12, + "mode": 0, + "inputs": [ + { + "name": "model", + "type": "MODEL", + "link": 23 + }, + { + "name": "positive", + "type": "CONDITIONING", + "link": 4 + }, + { + "name": "negative", + "type": "CONDITIONING", + "link": 6 + }, + { + "name": "latent_image", + "type": "LATENT", + "link": 2 + } + ], + "outputs": [ + { + "name": "LATENT", + "type": "LATENT", + "links": [ + 7 + ], + "slot_index": 0 + } + ], + "properties": { + "Node name for S&R": "KSampler" + }, + "widgets_values": [ + 0, + "fixed", + 30, + 6.5, + "dpmpp_2m", + "karras", + 1 + ] + }, + { + "id": 20, + "type": "SaveImage", + "pos": [ + 2030, + 940 + ], + "size": { + "0": 529.7760009765625, + "1": 582.3048095703125 + }, + "flags": {}, + "order": 23, + "mode": 0, + "inputs": [ + { + "name": "images", + "type": "IMAGE", + "link": 34 + } + ], + "properties": {}, + "widgets_values": [ + "IPAdapter" + ] + }, + { + "id": 18, + "type": "KSampler", + "pos": [ + 1660, + 940 + ], + "size": { + "0": 315, + "1": 262 + }, + "flags": {}, + "order": 13, + "mode": 0, + "inputs": [ + { + "name": "model", + "type": "MODEL", + "link": 28 + }, + { + "name": "positive", + "type": "CONDITIONING", + "link": 29 + }, + { + "name": "negative", + "type": "CONDITIONING", + "link": 30 + }, + { + "name": "latent_image", + "type": "LATENT", + "link": 31 + } + ], + "outputs": [ + { + "name": "LATENT", + "type": "LATENT", + "links": [ + 32 + ], + "slot_index": 0 + } + ], + "properties": { + "Node name for S&R": "KSampler" + }, + "widgets_values": [ + 0, + "fixed", + 30, + 6.5, + "dpmpp_2m", + "karras", + 1 + ] + }, + { + "id": 19, + "type": "VAEDecode", + "pos": [ + 1830, + 1280 + ], + "size": { + "0": 140, + "1": 46 + }, + "flags": {}, + "order": 18, + "mode": 0, + "inputs": [ + { + "name": "samples", + "type": "LATENT", + "link": 32 + }, + { + "name": "vae", + "type": "VAE", + "link": 33 + } + ], + "outputs": [ + { + "name": "IMAGE", + "type": "IMAGE", + "links": [ + 34 + ], + "slot_index": 0 + } + ], + "properties": { + "Node name for S&R": "VAEDecode" + } + }, + { + "id": 8, + "type": "VAEDecode", + "pos": [ + 1820, + 610 + ], + "size": { + "0": 140, + "1": 46 + }, + "flags": {}, + "order": 17, + "mode": 0, + "inputs": [ + { + "name": "samples", + "type": "LATENT", + "link": 7 + }, + { + "name": "vae", + "type": "VAE", + "link": 8 + } + ], + "outputs": [ + { + "name": "IMAGE", + "type": "IMAGE", + "links": [ + 9 + ], + "slot_index": 0 + } + ], + "properties": { + "Node name for S&R": "VAEDecode" + } + }, + { + "id": 9, + "type": "SaveImage", + "pos": [ + 2040, + 300 + ], + "size": { + "0": 529.7760009765625, + "1": 582.3048095703125 + }, + "flags": {}, + "order": 22, + "mode": 0, + "inputs": [ + { + "name": "images", + "type": "IMAGE", + "link": 9 + } + ], + "properties": {}, + "widgets_values": [ + "IPAdapter" + ] + }, + { + "id": 14, + "type": "IPAdapterAdvanced", + "pos": [ + 1290, + 250 + ], + "size": { + "0": 315, + "1": 254 + }, + "flags": {}, + "order": 7, + "mode": 0, + "inputs": [ + { + "name": "model", + "type": "MODEL", + "link": 20 + }, + { + "name": "ipadapter", + "type": "IPADAPTER", + "link": 21, + "slot_index": 1 + }, + { + "name": "image", + "type": "IMAGE", + "link": 27 + }, + { + "name": "image_negative", + "type": "IMAGE", + "link": null + }, + { + "name": "attn_mask", + "type": "MASK", + "link": null + }, + { + "name": "clip_vision", + "type": "CLIP_VISION", + "link": 24, + "slot_index": 5 + } + ], + "outputs": [ + { + "name": "MODEL", + "type": "MODEL", + "links": [ + 23 + ], + "shape": 3, + "slot_index": 0 + } + ], + "properties": { + "Node name for S&R": "IPAdapterAdvanced" + }, + "widgets_values": [ + 0.8, + "linear", + "concat", + 0, + 1 + ] + }, + { + "id": 21, + "type": "IPAdapterAdvanced", + "pos": [ + 1280, + 900 + ], + "size": { + "0": 315, + "1": 254 + }, + "flags": {}, + "order": 8, + "mode": 0, + "inputs": [ + { + "name": "model", + "type": "MODEL", + "link": 35 + }, + { + "name": "ipadapter", + "type": "IPADAPTER", + "link": 36, + "slot_index": 1 + }, + { + "name": "image", + "type": "IMAGE", + "link": 37 + }, + { + "name": "image_negative", + "type": "IMAGE", + "link": null + }, + { + "name": "attn_mask", + "type": "MASK", + "link": null + }, + { + "name": "clip_vision", + "type": "CLIP_VISION", + "link": 38, + "slot_index": 5 + } + ], + "outputs": [ + { + "name": "MODEL", + "type": "MODEL", + "links": [ + 28 + ], + "shape": 3, + "slot_index": 0 + } + ], + "properties": { + "Node name for S&R": "IPAdapterAdvanced" + }, + "widgets_values": [ + 0.8, + "ease in", + "concat", + 0, + 1 + ] + }, + { + "id": 22, + "type": "KSampler", + "pos": [ + 1660, + 1580 + ], + "size": { + "0": 315, + "1": 262 + }, + "flags": {}, + "order": 14, + "mode": 0, + "inputs": [ + { + "name": "model", + "type": "MODEL", + "link": 39 + }, + { + "name": "positive", + "type": "CONDITIONING", + "link": 40 + }, + { + "name": "negative", + "type": "CONDITIONING", + "link": 41 + }, + { + "name": "latent_image", + "type": "LATENT", + "link": 42 + } + ], + "outputs": [ + { + "name": "LATENT", + "type": "LATENT", + "links": [ + 43 + ], + "slot_index": 0 + } + ], + "properties": { + "Node name for S&R": "KSampler" + }, + "widgets_values": [ + 0, + "fixed", + 30, + 6.5, + "dpmpp_2m", + "karras", + 1 + ] + }, + { + "id": 23, + "type": "VAEDecode", + "pos": [ + 1830, + 1920 + ], + "size": { + "0": 140, + "1": 46 + }, + "flags": {}, + "order": 19, + "mode": 0, + "inputs": [ + { + "name": "samples", + "type": "LATENT", + "link": 43 + }, + { + "name": "vae", + "type": "VAE", + "link": 44 + } + ], + "outputs": [ + { + "name": "IMAGE", + "type": "IMAGE", + "links": [ + 45 + ], + "slot_index": 0 + } + ], + "properties": { + "Node name for S&R": "VAEDecode" + } + }, + { + "id": 25, + "type": "IPAdapterAdvanced", + "pos": [ + 1280, + 1540 + ], + "size": { + "0": 315, + "1": 254 + }, + "flags": {}, + "order": 9, + "mode": 0, + "inputs": [ + { + "name": "model", + "type": "MODEL", + "link": 46 + }, + { + "name": "ipadapter", + "type": "IPADAPTER", + "link": 47, + "slot_index": 1 + }, + { + "name": "image", + "type": "IMAGE", + "link": 48 + }, + { + "name": "image_negative", + "type": "IMAGE", + "link": null + }, + { + "name": "attn_mask", + "type": "MASK", + "link": null + }, + { + "name": "clip_vision", + "type": "CLIP_VISION", + "link": 49, + "slot_index": 5 + } + ], + "outputs": [ + { + "name": "MODEL", + "type": "MODEL", + "links": [ + 39 + ], + "shape": 3, + "slot_index": 0 + } + ], + "properties": { + "Node name for S&R": "IPAdapterAdvanced" + }, + "widgets_values": [ + 0.8, + "ease out", + "concat", + 0, + 1 + ] + }, + { + "id": 24, + "type": "SaveImage", + "pos": [ + 2030, + 1580 + ], + "size": { + "0": 529.7760009765625, + "1": 582.3048095703125 + }, + "flags": {}, + "order": 24, + "mode": 0, + "inputs": [ + { + "name": "images", + "type": "IMAGE", + "link": 45 + } + ], + "properties": {}, + "widgets_values": [ + "IPAdapter" + ] + }, + { + "id": 27, + "type": "VAEDecode", + "pos": [ + 3750, + 670 + ], + "size": { + "0": 140, + "1": 46 + }, + "flags": {}, + "order": 20, + "mode": 0, + "inputs": [ + { + "name": "samples", + "type": "LATENT", + "link": 54 + }, + { + "name": "vae", + "type": "VAE", + "link": 55 + } + ], + "outputs": [ + { + "name": "IMAGE", + "type": "IMAGE", + "links": [ + 56 + ], + "slot_index": 0 + } + ], + "properties": { + "Node name for S&R": "VAEDecode" + } + }, + { + "id": 28, + "type": "SaveImage", + "pos": [ + 2620, + 300 + ], + "size": { + "0": 529.7760009765625, + "1": 582.3048095703125 + }, + "flags": {}, + "order": 25, + "mode": 0, + "inputs": [ + { + "name": "images", + "type": "IMAGE", + "link": 56 + } + ], + "properties": {}, + "widgets_values": [ + "IPAdapter" + ] + }, + { + "id": 30, + "type": "KSampler", + "pos": [ + 3590, + 1000 + ], + "size": { + "0": 315, + "1": 262 + }, + "flags": {}, + "order": 16, + "mode": 0, + "inputs": [ + { + "name": "model", + "type": "MODEL", + "link": 61 + }, + { + "name": "positive", + "type": "CONDITIONING", + "link": 62 + }, + { + "name": "negative", + "type": "CONDITIONING", + "link": 63 + }, + { + "name": "latent_image", + "type": "LATENT", + "link": 64 + } + ], + "outputs": [ + { + "name": "LATENT", + "type": "LATENT", + "links": [ + 65 + ], + "slot_index": 0 + } + ], + "properties": { + "Node name for S&R": "KSampler" + }, + "widgets_values": [ + 0, + "fixed", + 30, + 6.5, + "dpmpp_2m", + "karras", + 1 + ] + }, + { + "id": 31, + "type": "VAEDecode", + "pos": [ + 3760, + 1340 + ], + "size": { + "0": 140, + "1": 46 + }, + "flags": {}, + "order": 21, + "mode": 0, + "inputs": [ + { + "name": "samples", + "type": "LATENT", + "link": 65 + }, + { + "name": "vae", + "type": "VAE", + "link": 66 + } + ], + "outputs": [ + { + "name": "IMAGE", + "type": "IMAGE", + "links": [ + 67 + ], + "slot_index": 0 + } + ], + "properties": { + "Node name for S&R": "VAEDecode" + } + }, + { + "id": 32, + "type": "SaveImage", + "pos": [ + 2610, + 940 + ], + "size": { + "0": 529.7760009765625, + "1": 582.3048095703125 + }, + "flags": {}, + "order": 26, + "mode": 0, + "inputs": [ + { + "name": "images", + "type": "IMAGE", + "link": 67 + } + ], + "properties": {}, + "widgets_values": [ + "IPAdapter" + ] + }, + { + "id": 26, + "type": "KSampler", + "pos": [ + 3590, + 350 + ], + "size": { + "0": 315, + "1": 262 + }, + "flags": {}, + "order": 15, + "mode": 0, + "inputs": [ + { + "name": "model", + "type": "MODEL", + "link": 50 + }, + { + "name": "positive", + "type": "CONDITIONING", + "link": 51 + }, + { + "name": "negative", + "type": "CONDITIONING", + "link": 52 + }, + { + "name": "latent_image", + "type": "LATENT", + "link": 53 + } + ], + "outputs": [ + { + "name": "LATENT", + "type": "LATENT", + "links": [ + 54 + ], + "slot_index": 0 + } + ], + "properties": { + "Node name for S&R": "KSampler" + }, + "widgets_values": [ + 0, + "fixed", + 30, + 6.5, + "dpmpp_2m", + "karras", + 1 + ] + }, + { + "id": 29, + "type": "IPAdapterAdvanced", + "pos": [ + 3220, + 310 + ], + "size": { + "0": 315, + "1": 254 + }, + "flags": {}, + "order": 10, + "mode": 0, + "inputs": [ + { + "name": "model", + "type": "MODEL", + "link": 57 + }, + { + "name": "ipadapter", + "type": "IPADAPTER", + "link": 58, + "slot_index": 1 + }, + { + "name": "image", + "type": "IMAGE", + "link": 59 + }, + { + "name": "image_negative", + "type": "IMAGE", + "link": null + }, + { + "name": "attn_mask", + "type": "MASK", + "link": null + }, + { + "name": "clip_vision", + "type": "CLIP_VISION", + "link": 60, + "slot_index": 5 + } + ], + "outputs": [ + { + "name": "MODEL", + "type": "MODEL", + "links": [ + 50 + ], + "shape": 3, + "slot_index": 0 + } + ], + "properties": { + "Node name for S&R": "IPAdapterAdvanced" + }, + "widgets_values": [ + 0.8, + "ease in-out", + "concat", + 0, + 1 + ] + }, + { + "id": 33, + "type": "IPAdapterAdvanced", + "pos": [ + 3210, + 960 + ], + "size": { + "0": 315, + "1": 254 + }, + "flags": {}, + "order": 11, + "mode": 0, + "inputs": [ + { + "name": "model", + "type": "MODEL", + "link": 68 + }, + { + "name": "ipadapter", + "type": "IPADAPTER", + "link": 69, + "slot_index": 1 + }, + { + "name": "image", + "type": "IMAGE", + "link": 70 + }, + { + "name": "image_negative", + "type": "IMAGE", + "link": null + }, + { + "name": "attn_mask", + "type": "MASK", + "link": null + }, + { + "name": "clip_vision", + "type": "CLIP_VISION", + "link": 71, + "slot_index": 5 + } + ], + "outputs": [ + { + "name": "MODEL", + "type": "MODEL", + "links": [ + 61 + ], + "shape": 3, + "slot_index": 0 + } + ], + "properties": { + "Node name for S&R": "IPAdapterAdvanced" + }, + "widgets_values": [ + 0.8, + "reverse in-out", + "concat", + 0, + 1 + ] + }, + { + "id": 6, + "type": "CLIPTextEncode", + "pos": [ + 690, + 610 + ], + "size": { + "0": 422.84503173828125, + "1": 164.31304931640625 + }, + "flags": {}, + "order": 5, + "mode": 0, + "inputs": [ + { + "name": "clip", + "type": "CLIP", + "link": 3 + } + ], + "outputs": [ + { + "name": "CONDITIONING", + "type": "CONDITIONING", + "links": [ + 4, + 29, + 40, + 51, + 62 + ], + "slot_index": 0 + } + ], + "properties": { + "Node name for S&R": "CLIPTextEncode" + }, + "widgets_values": [ + "closeup of a fierce warrior woman wearing a full armor at the end of a battle. cherry blossoms\n\nhigh quality, detailed" + ] + } + ], + "links": [ + [ + 2, + 5, + 0, + 3, + 3, + "LATENT" + ], + [ + 3, + 4, + 1, + 6, + 0, + "CLIP" + ], + [ + 4, + 6, + 0, + 3, + 1, + "CONDITIONING" + ], + [ + 5, + 4, + 1, + 7, + 0, + "CLIP" + ], + [ + 6, + 7, + 0, + 3, + 2, + "CONDITIONING" + ], + [ + 7, + 3, + 0, + 8, + 0, + "LATENT" + ], + [ + 8, + 4, + 2, + 8, + 1, + "VAE" + ], + [ + 9, + 8, + 0, + 9, + 0, + "IMAGE" + ], + [ + 20, + 4, + 0, + 14, + 0, + "MODEL" + ], + [ + 21, + 15, + 0, + 14, + 1, + "IPADAPTER" + ], + [ + 23, + 14, + 0, + 3, + 0, + "MODEL" + ], + [ + 24, + 16, + 0, + 14, + 5, + "CLIP_VISION" + ], + [ + 27, + 12, + 0, + 14, + 2, + "IMAGE" + ], + [ + 28, + 21, + 0, + 18, + 0, + "MODEL" + ], + [ + 29, + 6, + 0, + 18, + 1, + "CONDITIONING" + ], + [ + 30, + 7, + 0, + 18, + 2, + "CONDITIONING" + ], + [ + 31, + 5, + 0, + 18, + 3, + "LATENT" + ], + [ + 32, + 18, + 0, + 19, + 0, + "LATENT" + ], + [ + 33, + 4, + 2, + 19, + 1, + "VAE" + ], + [ + 34, + 19, + 0, + 20, + 0, + "IMAGE" + ], + [ + 35, + 4, + 0, + 21, + 0, + "MODEL" + ], + [ + 36, + 15, + 0, + 21, + 1, + "IPADAPTER" + ], + [ + 37, + 12, + 0, + 21, + 2, + "IMAGE" + ], + [ + 38, + 16, + 0, + 21, + 5, + "CLIP_VISION" + ], + [ + 39, + 25, + 0, + 22, + 0, + "MODEL" + ], + [ + 40, + 6, + 0, + 22, + 1, + "CONDITIONING" + ], + [ + 41, + 7, + 0, + 22, + 2, + "CONDITIONING" + ], + [ + 42, + 5, + 0, + 22, + 3, + "LATENT" + ], + [ + 43, + 22, + 0, + 23, + 0, + "LATENT" + ], + [ + 44, + 4, + 2, + 23, + 1, + "VAE" + ], + [ + 45, + 23, + 0, + 24, + 0, + "IMAGE" + ], + [ + 46, + 4, + 0, + 25, + 0, + "MODEL" + ], + [ + 47, + 15, + 0, + 25, + 1, + "IPADAPTER" + ], + [ + 48, + 12, + 0, + 25, + 2, + "IMAGE" + ], + [ + 49, + 16, + 0, + 25, + 5, + "CLIP_VISION" + ], + [ + 50, + 29, + 0, + 26, + 0, + "MODEL" + ], + [ + 51, + 6, + 0, + 26, + 1, + "CONDITIONING" + ], + [ + 52, + 7, + 0, + 26, + 2, + "CONDITIONING" + ], + [ + 53, + 5, + 0, + 26, + 3, + "LATENT" + ], + [ + 54, + 26, + 0, + 27, + 0, + "LATENT" + ], + [ + 55, + 4, + 2, + 27, + 1, + "VAE" + ], + [ + 56, + 27, + 0, + 28, + 0, + "IMAGE" + ], + [ + 57, + 4, + 0, + 29, + 0, + "MODEL" + ], + [ + 58, + 15, + 0, + 29, + 1, + "IPADAPTER" + ], + [ + 59, + 12, + 0, + 29, + 2, + "IMAGE" + ], + [ + 60, + 16, + 0, + 29, + 5, + "CLIP_VISION" + ], + [ + 61, + 33, + 0, + 30, + 0, + "MODEL" + ], + [ + 62, + 6, + 0, + 30, + 1, + "CONDITIONING" + ], + [ + 63, + 7, + 0, + 30, + 2, + "CONDITIONING" + ], + [ + 64, + 5, + 0, + 30, + 3, + "LATENT" + ], + [ + 65, + 30, + 0, + 31, + 0, + "LATENT" + ], + [ + 66, + 4, + 2, + 31, + 1, + "VAE" + ], + [ + 67, + 31, + 0, + 32, + 0, + "IMAGE" + ], + [ + 68, + 4, + 0, + 33, + 0, + "MODEL" + ], + [ + 69, + 15, + 0, + 33, + 1, + "IPADAPTER" + ], + [ + 70, + 12, + 0, + 33, + 2, + "IMAGE" + ], + [ + 71, + 16, + 0, + 33, + 5, + "CLIP_VISION" + ] + ], + "groups": [], + "config": {}, + "extra": {}, + "version": 0.4 +} \ No newline at end of file diff --git a/imports/ComfyUI_IPAdapter_plus/examples/ipadapter_weighted_embeds.json b/imports/ComfyUI_IPAdapter_plus/examples/ipadapter_weighted_embeds.json new file mode 100644 index 0000000..e248a44 --- /dev/null +++ b/imports/ComfyUI_IPAdapter_plus/examples/ipadapter_weighted_embeds.json @@ -0,0 +1,836 @@ +{ + "last_node_id": 18, + "last_link_id": 29, + "nodes": [ + { + "id": 4, + "type": "CheckpointLoaderSimple", + "pos": [ + 50, + 730 + ], + "size": { + "0": 315, + "1": 98 + }, + "flags": {}, + "order": 0, + "mode": 0, + "outputs": [ + { + "name": "MODEL", + "type": "MODEL", + "links": [ + 10 + ], + "slot_index": 0 + }, + { + "name": "CLIP", + "type": "CLIP", + "links": [ + 3, + 5 + ], + "slot_index": 1 + }, + { + "name": "VAE", + "type": "VAE", + "links": [ + 8 + ], + "slot_index": 2 + } + ], + "properties": { + "Node name for S&R": "CheckpointLoaderSimple" + }, + "widgets_values": [ + "sd15/realisticVisionV51_v51VAE.safetensors" + ] + }, + { + "id": 6, + "type": "CLIPTextEncode", + "pos": [ + 690, + 610 + ], + "size": { + "0": 422.84503173828125, + "1": 164.31304931640625 + }, + "flags": {}, + "order": 5, + "mode": 0, + "inputs": [ + { + "name": "clip", + "type": "CLIP", + "link": 3 + } + ], + "outputs": [ + { + "name": "CONDITIONING", + "type": "CONDITIONING", + "links": [ + 4 + ], + "slot_index": 0 + } + ], + "properties": { + "Node name for S&R": "CLIPTextEncode" + }, + "widgets_values": [ + "closeup of a fierce warrior woman wearing a full armor at the end of a battle\n\nhigh quality, detailed" + ] + }, + { + "id": 9, + "type": "SaveImage", + "pos": [ + 1770, + 710 + ], + "size": { + "0": 529.7760009765625, + "1": 582.3048095703125 + }, + "flags": {}, + "order": 13, + "mode": 0, + "inputs": [ + { + "name": "images", + "type": "IMAGE", + "link": 9 + } + ], + "properties": {}, + "widgets_values": [ + "IPAdapter" + ] + }, + { + "id": 8, + "type": "VAEDecode", + "pos": [ + 1570, + 700 + ], + "size": { + "0": 140, + "1": 46 + }, + "flags": {}, + "order": 12, + "mode": 0, + "inputs": [ + { + "name": "samples", + "type": "LATENT", + "link": 7 + }, + { + "name": "vae", + "type": "VAE", + "link": 8 + } + ], + "outputs": [ + { + "name": "IMAGE", + "type": "IMAGE", + "links": [ + 9 + ], + "slot_index": 0 + } + ], + "properties": { + "Node name for S&R": "VAEDecode" + } + }, + { + "id": 5, + "type": "EmptyLatentImage", + "pos": [ + 801, + 1097 + ], + "size": { + "0": 315, + "1": 106 + }, + "flags": {}, + "order": 1, + "mode": 0, + "outputs": [ + { + "name": "LATENT", + "type": "LATENT", + "links": [ + 2 + ], + "slot_index": 0 + } + ], + "properties": { + "Node name for S&R": "EmptyLatentImage" + }, + "widgets_values": [ + 512, + 512, + 1 + ] + }, + { + "id": 12, + "type": "LoadImage", + "pos": [ + 453, + -296 + ], + "size": { + "0": 315, + "1": 314 + }, + "flags": {}, + "order": 2, + "mode": 0, + "outputs": [ + { + "name": "IMAGE", + "type": "IMAGE", + "links": [ + 21 + ], + "shape": 3, + "slot_index": 0 + }, + { + "name": "MASK", + "type": "MASK", + "links": null, + "shape": 3 + } + ], + "properties": { + "Node name for S&R": "LoadImage" + }, + "widgets_values": [ + "warrior_woman.png", + "image" + ] + }, + { + "id": 15, + "type": "LoadImage", + "pos": [ + 458, + 70 + ], + "size": { + "0": 315, + "1": 314 + }, + "flags": {}, + "order": 3, + "mode": 0, + "outputs": [ + { + "name": "IMAGE", + "type": "IMAGE", + "links": [ + 23 + ], + "shape": 3, + "slot_index": 0 + }, + { + "name": "MASK", + "type": "MASK", + "links": null, + "shape": 3 + } + ], + "properties": { + "Node name for S&R": "LoadImage" + }, + "widgets_values": [ + "anime_illustration.png", + "image" + ] + }, + { + "id": 11, + "type": "IPAdapterUnifiedLoader", + "pos": [ + 440, + 440 + ], + "size": { + "0": 315, + "1": 78 + }, + "flags": {}, + "order": 4, + "mode": 0, + "inputs": [ + { + "name": "model", + "type": "MODEL", + "link": 10 + }, + { + "name": "ipadapter", + "type": "IPADAPTER", + "link": null + } + ], + "outputs": [ + { + "name": "model", + "type": "MODEL", + "links": [ + 19 + ], + "shape": 3, + "slot_index": 0 + }, + { + "name": "ipadapter", + "type": "IPADAPTER", + "links": [ + 20, + 22, + 27 + ], + "shape": 3, + "slot_index": 1 + } + ], + "properties": { + "Node name for S&R": "IPAdapterUnifiedLoader" + }, + "widgets_values": [ + "PLUS (high strength)" + ] + }, + { + "id": 3, + "type": "KSampler", + "pos": [ + 1210, + 700 + ], + "size": { + "0": 315, + "1": 262 + }, + "flags": {}, + "order": 11, + "mode": 0, + "inputs": [ + { + "name": "model", + "type": "MODEL", + "link": 28 + }, + { + "name": "positive", + "type": "CONDITIONING", + "link": 4 + }, + { + "name": "negative", + "type": "CONDITIONING", + "link": 6 + }, + { + "name": "latent_image", + "type": "LATENT", + "link": 2 + } + ], + "outputs": [ + { + "name": "LATENT", + "type": "LATENT", + "links": [ + 7 + ], + "slot_index": 0 + } + ], + "properties": { + "Node name for S&R": "KSampler" + }, + "widgets_values": [ + 0, + "fixed", + 30, + 6.5, + "dpmpp_2m", + "karras", + 1 + ] + }, + { + "id": 7, + "type": "CLIPTextEncode", + "pos": [ + 690, + 840 + ], + "size": { + "0": 425.27801513671875, + "1": 180.6060791015625 + }, + "flags": {}, + "order": 6, + "mode": 0, + "inputs": [ + { + "name": "clip", + "type": "CLIP", + "link": 5 + } + ], + "outputs": [ + { + "name": "CONDITIONING", + "type": "CONDITIONING", + "links": [ + 6 + ], + "slot_index": 0 + } + ], + "properties": { + "Node name for S&R": "CLIPTextEncode" + }, + "widgets_values": [ + "blurry, noisy, messy, lowres, jpeg, artifacts, ill, distorted, malformed, hat, hood, scars, blood" + ] + }, + { + "id": 17, + "type": "IPAdapterEncoder", + "pos": [ + 859, + 69 + ], + "size": [ + 210, + 118 + ], + "flags": {}, + "order": 8, + "mode": 0, + "inputs": [ + { + "name": "ipadapter", + "type": "IPADAPTER", + "link": 22 + }, + { + "name": "image", + "type": "IMAGE", + "link": 23 + }, + { + "name": "mask", + "type": "MASK", + "link": null + }, + { + "name": "clip_vision", + "type": "CLIP_VISION", + "link": null + } + ], + "outputs": [ + { + "name": "pos_embed", + "type": "EMBEDS", + "links": [ + 25 + ], + "shape": 3, + "slot_index": 0 + }, + { + "name": "neg_embed", + "type": "EMBEDS", + "links": null, + "shape": 3 + } + ], + "properties": { + "Node name for S&R": "IPAdapterEncoder" + }, + "widgets_values": [ + 1.5 + ] + }, + { + "id": 18, + "type": "IPAdapterCombineEmbeds", + "pos": [ + 1136, + -95 + ], + "size": [ + 210, + 138 + ], + "flags": {}, + "order": 9, + "mode": 0, + "inputs": [ + { + "name": "embed1", + "type": "EMBEDS", + "link": 24 + }, + { + "name": "embed2", + "type": "EMBEDS", + "link": 25 + }, + { + "name": "embed3", + "type": "EMBEDS", + "link": null + }, + { + "name": "embed4", + "type": "EMBEDS", + "link": null + }, + { + "name": "embed5", + "type": "EMBEDS", + "link": null + } + ], + "outputs": [ + { + "name": "EMBEDS", + "type": "EMBEDS", + "links": [ + 26 + ], + "shape": 3, + "slot_index": 0 + } + ], + "properties": { + "Node name for S&R": "IPAdapterCombineEmbeds" + }, + "widgets_values": [ + "average" + ] + }, + { + "id": 14, + "type": "IPAdapterEmbeds", + "pos": [ + 1143, + 160 + ], + "size": { + "0": 315, + "1": 230 + }, + "flags": {}, + "order": 10, + "mode": 0, + "inputs": [ + { + "name": "model", + "type": "MODEL", + "link": 19 + }, + { + "name": "ipadapter", + "type": "IPADAPTER", + "link": 27 + }, + { + "name": "pos_embed", + "type": "EMBEDS", + "link": 26 + }, + { + "name": "neg_embed", + "type": "EMBEDS", + "link": 29 + }, + { + "name": "attn_mask", + "type": "MASK", + "link": null + }, + { + "name": "clip_vision", + "type": "CLIP_VISION", + "link": null + } + ], + "outputs": [ + { + "name": "MODEL", + "type": "MODEL", + "links": [ + 28 + ], + "shape": 3, + "slot_index": 0 + } + ], + "properties": { + "Node name for S&R": "IPAdapterEmbeds" + }, + "widgets_values": [ + 0.8, + "linear", + 0, + 1 + ] + }, + { + "id": 16, + "type": "IPAdapterEncoder", + "pos": [ + 863, + -285 + ], + "size": [ + 210, + 118 + ], + "flags": {}, + "order": 7, + "mode": 0, + "inputs": [ + { + "name": "ipadapter", + "type": "IPADAPTER", + "link": 20 + }, + { + "name": "image", + "type": "IMAGE", + "link": 21 + }, + { + "name": "mask", + "type": "MASK", + "link": null + }, + { + "name": "clip_vision", + "type": "CLIP_VISION", + "link": null + } + ], + "outputs": [ + { + "name": "pos_embed", + "type": "EMBEDS", + "links": [ + 24 + ], + "shape": 3, + "slot_index": 0 + }, + { + "name": "neg_embed", + "type": "EMBEDS", + "links": [ + 29 + ], + "shape": 3, + "slot_index": 1 + } + ], + "properties": { + "Node name for S&R": "IPAdapterEncoder" + }, + "widgets_values": [ + 0.6 + ] + } + ], + "links": [ + [ + 2, + 5, + 0, + 3, + 3, + "LATENT" + ], + [ + 3, + 4, + 1, + 6, + 0, + "CLIP" + ], + [ + 4, + 6, + 0, + 3, + 1, + "CONDITIONING" + ], + [ + 5, + 4, + 1, + 7, + 0, + "CLIP" + ], + [ + 6, + 7, + 0, + 3, + 2, + "CONDITIONING" + ], + [ + 7, + 3, + 0, + 8, + 0, + "LATENT" + ], + [ + 8, + 4, + 2, + 8, + 1, + "VAE" + ], + [ + 9, + 8, + 0, + 9, + 0, + "IMAGE" + ], + [ + 10, + 4, + 0, + 11, + 0, + "MODEL" + ], + [ + 19, + 11, + 0, + 14, + 0, + "MODEL" + ], + [ + 20, + 11, + 1, + 16, + 0, + "IPADAPTER" + ], + [ + 21, + 12, + 0, + 16, + 1, + "IMAGE" + ], + [ + 22, + 11, + 1, + 17, + 0, + "IPADAPTER" + ], + [ + 23, + 15, + 0, + 17, + 1, + "IMAGE" + ], + [ + 24, + 16, + 0, + 18, + 0, + "EMBEDS" + ], + [ + 25, + 17, + 0, + 18, + 1, + "EMBEDS" + ], + [ + 26, + 18, + 0, + 14, + 2, + "EMBEDS" + ], + [ + 27, + 11, + 1, + 14, + 1, + "IPADAPTER" + ], + [ + 28, + 14, + 0, + 3, + 0, + "MODEL" + ], + [ + 29, + 16, + 1, + 14, + 3, + "EMBEDS" + ] + ], + "groups": [], + "config": {}, + "extra": {}, + "version": 0.4 +} \ No newline at end of file diff --git a/imports/ComfyUI_IPAdapter_plus/image_proj_models.py b/imports/ComfyUI_IPAdapter_plus/image_proj_models.py new file mode 100644 index 0000000..06df68b --- /dev/null +++ b/imports/ComfyUI_IPAdapter_plus/image_proj_models.py @@ -0,0 +1,275 @@ +import math +import torch +import torch.nn as nn +from einops import rearrange +from einops.layers.torch import Rearrange + + +# FFN +def FeedForwardImport(dim, mult=4): + inner_dim = int(dim * mult) + return nn.Sequential( + nn.LayerNorm(dim), + nn.Linear(dim, inner_dim, bias=False), + nn.GELU(), + nn.Linear(inner_dim, dim, bias=False), + ) + + +def reshape_tensor(x, heads): + bs, length, width = x.shape + # (bs, length, width) --> (bs, length, n_heads, dim_per_head) + x = x.view(bs, length, heads, -1) + # (bs, length, n_heads, dim_per_head) --> (bs, n_heads, length, dim_per_head) + x = x.transpose(1, 2) + # (bs, n_heads, length, dim_per_head) --> (bs*n_heads, length, dim_per_head) + x = x.reshape(bs, heads, length, -1) + return x + + +class PerceiverAttentionImport(nn.Module): + def __init__(self, *, dim, dim_head=64, heads=8): + super().__init__() + self.scale = dim_head**-0.5 + self.dim_head = dim_head + self.heads = heads + inner_dim = dim_head * heads + + self.norm1 = nn.LayerNorm(dim) + self.norm2 = nn.LayerNorm(dim) + + self.to_q = nn.Linear(dim, inner_dim, bias=False) + self.to_kv = nn.Linear(dim, inner_dim * 2, bias=False) + self.to_out = nn.Linear(inner_dim, dim, bias=False) + + def forward(self, x, latents): + """ + Args: + x (torch.Tensor): image features + shape (b, n1, D) + latent (torch.Tensor): latent features + shape (b, n2, D) + """ + x = self.norm1(x) + latents = self.norm2(latents) + + b, l, _ = latents.shape + + q = self.to_q(latents) + kv_input = torch.cat((x, latents), dim=-2) + k, v = self.to_kv(kv_input).chunk(2, dim=-1) + + q = reshape_tensor(q, self.heads) + k = reshape_tensor(k, self.heads) + v = reshape_tensor(v, self.heads) + + # attention + scale = 1 / math.sqrt(math.sqrt(self.dim_head)) + weight = (q * scale) @ (k * scale).transpose(-2, -1) # More stable with f16 than dividing afterwards + weight = torch.softmax(weight.float(), dim=-1).type(weight.dtype) + out = weight @ v + + out = out.permute(0, 2, 1, 3).reshape(b, l, -1) + + return self.to_out(out) + + +class ResamplerImport(nn.Module): + def __init__( + self, + dim=1024, + depth=8, + dim_head=64, + heads=16, + num_queries=8, + embedding_dim=768, + output_dim=1024, + ff_mult=4, + max_seq_len: int = 257, # CLIP tokens + CLS token + apply_pos_emb: bool = False, + num_latents_mean_pooled: int = 0, # number of latents derived from mean pooled representation of the sequence + ): + super().__init__() + self.pos_emb = nn.Embedding(max_seq_len, embedding_dim) if apply_pos_emb else None + + self.latents = nn.Parameter(torch.randn(1, num_queries, dim) / dim**0.5) + + self.proj_in = nn.Linear(embedding_dim, dim) + + self.proj_out = nn.Linear(dim, output_dim) + self.norm_out = nn.LayerNorm(output_dim) + + self.to_latents_from_mean_pooled_seq = ( + nn.Sequential( + nn.LayerNorm(dim), + nn.Linear(dim, dim * num_latents_mean_pooled), + Rearrange("b (n d) -> b n d", n=num_latents_mean_pooled), + ) + if num_latents_mean_pooled > 0 + else None + ) + + self.layers = nn.ModuleList([]) + for _ in range(depth): + self.layers.append( + nn.ModuleList( + [ + PerceiverAttentionImport(dim=dim, dim_head=dim_head, heads=heads), + FeedForwardImport(dim=dim, mult=ff_mult), + ] + ) + ) + + def forward(self, x): + if self.pos_emb is not None: + n, device = x.shape[1], x.device + pos_emb = self.pos_emb(torch.arange(n, device=device)) + x = x + pos_emb + + latents = self.latents.repeat(x.size(0), 1, 1) + + x = self.proj_in(x) + + if self.to_latents_from_mean_pooled_seq: + meanpooled_seq = masked_mean(x, dim=1, mask=torch.ones(x.shape[:2], device=x.device, dtype=torch.bool)) + meanpooled_latents = self.to_latents_from_mean_pooled_seq(meanpooled_seq) + latents = torch.cat((meanpooled_latents, latents), dim=-2) + + for attn, ff in self.layers: + latents = attn(x, latents) + latents + latents = ff(latents) + latents + + latents = self.proj_out(latents) + return self.norm_out(latents) + + +def masked_mean(t, *, dim, mask=None): + if mask is None: + return t.mean(dim=dim) + + denom = mask.sum(dim=dim, keepdim=True) + mask = rearrange(mask, "b n -> b n 1") + masked_t = t.masked_fill(~mask, 0.0) + + return masked_t.sum(dim=dim) / denom.clamp(min=1e-5) + + +class FacePerceiverResamplerImport(nn.Module): + def __init__( + self, + *, + dim=768, + depth=4, + dim_head=64, + heads=16, + embedding_dim=1280, + output_dim=768, + ff_mult=4, + ): + super().__init__() + + self.proj_in = nn.Linear(embedding_dim, dim) + self.proj_out = nn.Linear(dim, output_dim) + self.norm_out = nn.LayerNorm(output_dim) + self.layers = nn.ModuleList([]) + for _ in range(depth): + self.layers.append( + nn.ModuleList( + [ + PerceiverAttentionImport(dim=dim, dim_head=dim_head, heads=heads), + FeedForwardImport(dim=dim, mult=ff_mult), + ] + ) + ) + + def forward(self, latents, x): + x = self.proj_in(x) + for attn, ff in self.layers: + latents = attn(x, latents) + latents + latents = ff(latents) + latents + latents = self.proj_out(latents) + return self.norm_out(latents) + + +class MLPProjModelImport(nn.Module): + def __init__(self, cross_attention_dim=1024, clip_embeddings_dim=1024): + super().__init__() + + self.proj = nn.Sequential( + nn.Linear(clip_embeddings_dim, clip_embeddings_dim), + nn.GELU(), + nn.Linear(clip_embeddings_dim, cross_attention_dim), + nn.LayerNorm(cross_attention_dim) + ) + + def forward(self, image_embeds): + clip_extra_context_tokens = self.proj(image_embeds) + return clip_extra_context_tokens + +class MLPProjModelFaceIdImport(nn.Module): + def __init__(self, cross_attention_dim=768, id_embeddings_dim=512, num_tokens=4): + super().__init__() + + self.cross_attention_dim = cross_attention_dim + self.num_tokens = num_tokens + + self.proj = nn.Sequential( + nn.Linear(id_embeddings_dim, id_embeddings_dim*2), + nn.GELU(), + nn.Linear(id_embeddings_dim*2, cross_attention_dim*num_tokens), + ) + self.norm = nn.LayerNorm(cross_attention_dim) + + def forward(self, id_embeds): + x = self.proj(id_embeds) + x = x.reshape(-1, self.num_tokens, self.cross_attention_dim) + x = self.norm(x) + return x + +class ProjModelFaceIdPlusImport(nn.Module): + def __init__(self, cross_attention_dim=768, id_embeddings_dim=512, clip_embeddings_dim=1280, num_tokens=4): + super().__init__() + + self.cross_attention_dim = cross_attention_dim + self.num_tokens = num_tokens + + self.proj = nn.Sequential( + nn.Linear(id_embeddings_dim, id_embeddings_dim*2), + nn.GELU(), + nn.Linear(id_embeddings_dim*2, cross_attention_dim*num_tokens), + ) + self.norm = nn.LayerNorm(cross_attention_dim) + + self.perceiver_resampler = FacePerceiverResamplerImport( + dim=cross_attention_dim, + depth=4, + dim_head=64, + heads=cross_attention_dim // 64, + embedding_dim=clip_embeddings_dim, + output_dim=cross_attention_dim, + ff_mult=4, + ) + + def forward(self, id_embeds, clip_embeds, scale=1.0, shortcut=False): + x = self.proj(id_embeds) + x = x.reshape(-1, self.num_tokens, self.cross_attention_dim) + x = self.norm(x) + out = self.perceiver_resampler(x, clip_embeds) + if shortcut: + out = x + scale * out + return out + +class ImageProjModelImport(nn.Module): + def __init__(self, cross_attention_dim=1024, clip_embeddings_dim=1024, clip_extra_context_tokens=4): + super().__init__() + + self.cross_attention_dim = cross_attention_dim + self.clip_extra_context_tokens = clip_extra_context_tokens + self.proj = nn.Linear(clip_embeddings_dim, self.clip_extra_context_tokens * cross_attention_dim) + self.norm = nn.LayerNorm(cross_attention_dim) + + def forward(self, image_embeds): + embeds = image_embeds + x = self.proj(embeds).reshape(-1, self.clip_extra_context_tokens, self.cross_attention_dim) + x = self.norm(x) + return x diff --git a/imports/ComfyUI_IPAdapter_plus/models/legacy_directory_do_not_use.txt b/imports/ComfyUI_IPAdapter_plus/models/legacy_directory_do_not_use.txt new file mode 100644 index 0000000..e69de29 diff --git a/imports/ComfyUI_IPAdapter_plus/utils.py b/imports/ComfyUI_IPAdapter_plus/utils.py new file mode 100644 index 0000000..b1fab58 --- /dev/null +++ b/imports/ComfyUI_IPAdapter_plus/utils.py @@ -0,0 +1,228 @@ +import re +import torch +import os +import folder_paths +from comfy.clip_vision import clip_preprocess, Output +import comfy.utils +import comfy.model_management as model_management +try: + import torchvision.transforms.v2 as T +except ImportError: + import torchvision.transforms as T + +def get_clipvision_file(preset): + preset = preset.lower() + clipvision_list = folder_paths.get_filename_list("clip_vision") + + if preset.startswith("vit-g"): + pattern = '(ViT.bigG.14.*39B.b160k|ipadapter.*sdxl|sdxl.*model\.(bin|safetensors))' + else: + pattern = '(ViT.H.14.*s32B.b79K|ipadapter.*sd15|sd1.?5.*model\.(bin|safetensors))' + clipvision_file = [e for e in clipvision_list if re.search(pattern, e, re.IGNORECASE)] + + clipvision_file = folder_paths.get_full_path("clip_vision", clipvision_file[0]) if clipvision_file else None + + return clipvision_file + +def get_ipadapter_file(preset, is_sdxl): + preset = preset.lower() + ipadapter_list = folder_paths.get_filename_list("ipadapter") + is_insightface = False + lora_pattern = None + + if preset.startswith("light"): + if is_sdxl: + raise Exception("light model is not supported for SDXL") + pattern = 'sd15.light.v11\.(safetensors|bin)$' + # if light model v11 is not found, try with the old version + if not [e for e in ipadapter_list if re.search(pattern, e, re.IGNORECASE)]: + pattern = 'sd15.light\.(safetensors|bin)$' + elif preset.startswith("standard"): + if is_sdxl: + pattern = 'ip.adapter.sdxl.vit.h\.(safetensors|bin)$' + else: + pattern = 'ip.adapter.sd15\.(safetensors|bin)$' + elif preset.startswith("vit-g"): + if is_sdxl: + pattern = 'ip.adapter.sdxl\.(safetensors|bin)$' + else: + pattern = 'sd15.vit.g\.(safetensors|bin)$' + elif preset.startswith("plus ("): + if is_sdxl: + pattern = 'plus.sdxl.vit.h\.(safetensors|bin)$' + else: + pattern = 'ip.adapter.plus.sd15\.(safetensors|bin)$' + elif preset.startswith("plus face"): + if is_sdxl: + pattern = 'plus.face.sdxl.vit.h\.(safetensors|bin)$' + else: + pattern = 'plus.face.sd15\.(safetensors|bin)$' + elif preset.startswith("full"): + if is_sdxl: + raise Exception("full face model is not supported for SDXL") + pattern = 'full.face.sd15\.(safetensors|bin)$' + elif preset.startswith("faceid portrait"): + if is_sdxl: + raise Exception("portrait model is not supported for SDXL") + pattern = 'portrait.sd15\.(safetensors|bin)$' + is_insightface = True + elif preset == "faceid": + if is_sdxl: + pattern = 'faceid.sdxl\.(safetensors|bin)$' + lora_pattern = 'faceid.sdxl.lora\.safetensors$' + else: + pattern = 'faceid.sd15\.(safetensors|bin)$' + lora_pattern = 'faceid.sd15.lora\.safetensors$' + is_insightface = True + elif preset.startswith("faceid plus -"): + if is_sdxl: + raise Exception("faceid plus model is not supported for SDXL") + pattern = 'faceid.plus.sd15\.(safetensors|bin)$' + lora_pattern = 'faceid.plus.sd15.lora\.safetensors$' + is_insightface = True + elif preset.startswith("faceid plus v2"): + if is_sdxl: + pattern = 'faceid.plusv2.sdxl\.(safetensors|bin)$' + lora_pattern = 'faceid.plusv2.sdxl.lora\.safetensors$' + else: + pattern = 'faceid.plusv2.sd15\.(safetensors|bin)$' + lora_pattern = 'faceid.plusv2.sd15.lora\.safetensors$' + is_insightface = True + else: + raise Exception(f"invalid type '{preset}'") + + ipadapter_file = [e for e in ipadapter_list if re.search(pattern, e, re.IGNORECASE)] + ipadapter_file = folder_paths.get_full_path("ipadapter", ipadapter_file[0]) if ipadapter_file else None + + return ipadapter_file, is_insightface, lora_pattern + +def get_lora_file(pattern): + lora_list = folder_paths.get_filename_list("loras") + lora_file = [e for e in lora_list if re.search(pattern, e, re.IGNORECASE)] + lora_file = folder_paths.get_full_path("loras", lora_file[0]) if lora_file else None + + return lora_file + +def ipadapter_model_loader(file): + model = comfy.utils.load_torch_file(file, safe_load=True) + + if file.lower().endswith(".safetensors"): + st_model = {"image_proj": {}, "ip_adapter": {}} + for key in model.keys(): + if key.startswith("image_proj."): + st_model["image_proj"][key.replace("image_proj.", "")] = model[key] + elif key.startswith("ip_adapter."): + st_model["ip_adapter"][key.replace("ip_adapter.", "")] = model[key] + model = st_model + del st_model + + if not "ip_adapter" in model.keys() or not model["ip_adapter"]: + raise Exception("invalid IPAdapter model {}".format(file)) + + if 'plusv2' in file.lower(): + model["faceidplusv2"] = True + + return model + +def insightface_loader(provider): + try: + from insightface.app import FaceAnalysis + except ImportError as e: + raise Exception(e) + + path = os.path.join(folder_paths.models_dir, "insightface") + model = FaceAnalysis(name="buffalo_l", root=path, providers=[provider + 'ExecutionProvider',]) + model.prepare(ctx_id=0, det_size=(640, 640)) + return model + +def encode_image_masked(clip_vision, image, mask=None): + model_management.load_model_gpu(clip_vision.patcher) + image = image.to(clip_vision.load_device) + + pixel_values = clip_preprocess(image.to(clip_vision.load_device)).float() + + if mask is not None: + pixel_values = pixel_values * mask.to(clip_vision.load_device) + + out = clip_vision.model(pixel_values=pixel_values, intermediate_output=-2) + + outputs = Output() + outputs["last_hidden_state"] = out[0].to(model_management.intermediate_device()) + outputs["image_embeds"] = out[2].to(model_management.intermediate_device()) + outputs["penultimate_hidden_states"] = out[1].to(model_management.intermediate_device()) + return outputs + +def tensor_to_size(source, dest_size): + if isinstance(dest_size, torch.Tensor): + dest_size = dest_size.shape[0] + source_size = source.shape[0] + + if source_size < dest_size: + shape = [dest_size - source_size] + [1]*(source.dim()-1) + source = torch.cat((source, source[-1:].repeat(shape)), dim=0) + elif source_size > dest_size: + source = source[:dest_size] + + return source + +def min_(tensor_list): + # return the element-wise min of the tensor list. + x = torch.stack(tensor_list) + mn = x.min(axis=0)[0] + return torch.clamp(mn, min=0) + +def max_(tensor_list): + # return the element-wise max of the tensor list. + x = torch.stack(tensor_list) + mx = x.max(axis=0)[0] + return torch.clamp(mx, max=1) + +# From https://github.com/Jamy-L/Pytorch-Contrast-Adaptive-Sharpening/ +def contrast_adaptive_sharpening(image, amount): + img = T.functional.pad(image, (1, 1, 1, 1)).cpu() + + a = img[..., :-2, :-2] + b = img[..., :-2, 1:-1] + c = img[..., :-2, 2:] + d = img[..., 1:-1, :-2] + e = img[..., 1:-1, 1:-1] + f = img[..., 1:-1, 2:] + g = img[..., 2:, :-2] + h = img[..., 2:, 1:-1] + i = img[..., 2:, 2:] + + # Computing contrast + cross = (b, d, e, f, h) + mn = min_(cross) + mx = max_(cross) + + diag = (a, c, g, i) + mn2 = min_(diag) + mx2 = max_(diag) + mx = mx + mx2 + mn = mn + mn2 + + # Computing local weight + inv_mx = torch.reciprocal(mx) + amp = inv_mx * torch.minimum(mn, (2 - mx)) + + # scaling + amp = torch.sqrt(amp) + w = - amp * (amount * (1/5 - 1/8) + 1/8) + div = torch.reciprocal(1 + 4*w) + + output = ((b + d + f + h)*w + e) * div + output = torch.nan_to_num(output) + output = output.clamp(0, 1) + + return output + +def tensor_to_image(tensor): + image = tensor.mul(255).clamp(0, 255).byte().cpu() + image = image[..., [2, 1, 0]].numpy() + return image + +def image_to_tensor(image): + tensor = torch.clamp(torch.from_numpy(image).float() / 255., 0, 1) + tensor = tensor[..., [2, 1, 0]] + return tensor \ No newline at end of file diff --git a/imports/IPAdapterPlus.py b/imports/IPAdapterPlus.py deleted file mode 100644 index a9aab68..0000000 --- a/imports/IPAdapterPlus.py +++ /dev/null @@ -1,1352 +0,0 @@ -import torch -import os -import math - -import comfy.utils -import comfy.model_management -from comfy.clip_vision import clip_preprocess, Output -from comfy.ldm.modules.attention import optimized_attention -from nodes import MAX_RESOLUTION -import folder_paths - -import torch.nn as nn -from PIL import Image -import torch.nn.functional as F -import torchvision.transforms as TT - - - -# set the models directory backward compatible -GLOBAL_MODELS_DIR = os.path.join(folder_paths.models_dir, "ipadapter") -MODELS_DIR = GLOBAL_MODELS_DIR if os.path.isdir(GLOBAL_MODELS_DIR) else os.path.join(os.path.dirname(os.path.realpath(__file__)), "models") -if "ipadapter" not in folder_paths.folder_names_and_paths: - current_paths = [MODELS_DIR] -else: - current_paths, _ = folder_paths.folder_names_and_paths["ipadapter"] -folder_paths.folder_names_and_paths["ipadapter"] = (current_paths, folder_paths.supported_pt_extensions) - -INSIGHTFACE_DIR = os.path.join(folder_paths.models_dir, "insightface") - -class FacePerceiverResamplerImport(torch.nn.Module): - def __init__( - self, - *, - dim=768, - depth=4, - dim_head=64, - heads=16, - embedding_dim=1280, - output_dim=768, - ff_mult=4, - ): - super().__init__() - - self.proj_in = torch.nn.Linear(embedding_dim, dim) - self.proj_out = torch.nn.Linear(dim, output_dim) - self.norm_out = torch.nn.LayerNorm(output_dim) - self.layers = torch.nn.ModuleList([]) - for _ in range(depth): - self.layers.append( - torch.nn.ModuleList( - [ - PerceiverAttentionImport(dim=dim, dim_head=dim_head, heads=heads), - FeedForwardImport(dim=dim, mult=ff_mult), - ] - ) - ) - - def forward(self, latents, x): - x = self.proj_in(x) - for attn, ff in self.layers: - latents = attn(x, latents) + latents - latents = ff(latents) + latents - latents = self.proj_out(latents) - return self.norm_out(latents) - -class MLPProjModelImport(torch.nn.Module): - def __init__(self, cross_attention_dim=1024, clip_embeddings_dim=1024): - super().__init__() - - self.proj = torch.nn.Sequential( - torch.nn.Linear(clip_embeddings_dim, clip_embeddings_dim), - torch.nn.GELU(), - torch.nn.Linear(clip_embeddings_dim, cross_attention_dim), - torch.nn.LayerNorm(cross_attention_dim) - ) - - def forward(self, image_embeds): - clip_extra_context_tokens = self.proj(image_embeds) - return clip_extra_context_tokens - -class MLPProjModelFaceIdImport(torch.nn.Module): - def __init__(self, cross_attention_dim=768, id_embeddings_dim=512, num_tokens=4): - super().__init__() - - self.cross_attention_dim = cross_attention_dim - self.num_tokens = num_tokens - - self.proj = torch.nn.Sequential( - torch.nn.Linear(id_embeddings_dim, id_embeddings_dim*2), - torch.nn.GELU(), - torch.nn.Linear(id_embeddings_dim*2, cross_attention_dim*num_tokens), - ) - self.norm = torch.nn.LayerNorm(cross_attention_dim) - - def forward(self, id_embeds): - clip_extra_context_tokens = self.proj(id_embeds) - clip_extra_context_tokens = clip_extra_context_tokens.reshape(-1, self.num_tokens, self.cross_attention_dim) - clip_extra_context_tokens = self.norm(clip_extra_context_tokens) - return clip_extra_context_tokens - -class ProjModelFaceIdPlusImport(torch.nn.Module): - def __init__(self, cross_attention_dim=768, id_embeddings_dim=512, clip_embeddings_dim=1280, num_tokens=4): - super().__init__() - - self.cross_attention_dim = cross_attention_dim - self.num_tokens = num_tokens - - self.proj = torch.nn.Sequential( - torch.nn.Linear(id_embeddings_dim, id_embeddings_dim*2), - torch.nn.GELU(), - torch.nn.Linear(id_embeddings_dim*2, cross_attention_dim*num_tokens), - ) - self.norm = torch.nn.LayerNorm(cross_attention_dim) - - self.perceiver_resampler = FacePerceiverResamplerImport( - dim=cross_attention_dim, - depth=4, - dim_head=64, - heads=cross_attention_dim // 64, - embedding_dim=clip_embeddings_dim, - output_dim=cross_attention_dim, - ff_mult=4, - ) - - def forward(self, id_embeds, clip_embeds, scale=1.0, shortcut=False): - x = self.proj(id_embeds) - x = x.reshape(-1, self.num_tokens, self.cross_attention_dim) - x = self.norm(x) - out = self.perceiver_resampler(x, clip_embeds) - if shortcut: - out = x + scale * out - return out - -class ImageProjModelImport(nn.Module): - def __init__(self, cross_attention_dim=1024, clip_embeddings_dim=1024, clip_extra_context_tokens=4): - super().__init__() - - self.cross_attention_dim = cross_attention_dim - self.clip_extra_context_tokens = clip_extra_context_tokens - self.proj = nn.Linear(clip_embeddings_dim, self.clip_extra_context_tokens * cross_attention_dim) - self.norm = nn.LayerNorm(cross_attention_dim) - - def forward(self, image_embeds): - embeds = image_embeds - clip_extra_context_tokens = self.proj(embeds).reshape(-1, self.clip_extra_context_tokens, self.cross_attention_dim) - clip_extra_context_tokens = self.norm(clip_extra_context_tokens) - return clip_extra_context_tokens - -class To_KVImport(nn.Module): - def __init__(self, state_dict): - super().__init__() - - self.to_kvs = nn.ModuleDict() - for key, value in state_dict.items(): - self.to_kvs[key.replace(".weight", "").replace(".", "_")] = nn.Linear(value.shape[1], value.shape[0], bias=False) - self.to_kvs[key.replace(".weight", "").replace(".", "_")].weight.data = value - -def set_model_patch_replace(model, patch_kwargs, key): - to = model.model_options["transformer_options"] - if "patches_replace" not in to: - to["patches_replace"] = {} - if "attn2" not in to["patches_replace"]: - to["patches_replace"]["attn2"] = {} - if key not in to["patches_replace"]["attn2"]: - to["patches_replace"]["attn2"][key] = CrossAttentionPatchImport(**patch_kwargs) - else: - to["patches_replace"]["attn2"][key].set_new_condition(**patch_kwargs) - -def masked_tiling(image, short_side_tiles, weight=0.6, blur=0): - _, orig_height, orig_width, _ = image.shape - tile_size = 224 - - if orig_width < orig_height: - num_tiles_x = short_side_tiles - new_width = tile_size * num_tiles_x - new_height = orig_height * new_width // orig_width - num_tiles_y = new_height // tile_size - else: - num_tiles_y = short_side_tiles - new_height = tile_size * num_tiles_y - new_width = orig_width * new_height // orig_height - num_tiles_x = new_width // tile_size - - start_x = start_y = 0 - if (new_height % tile_size) >= tile_size//4: - num_tiles_y += 1 - else: - start_y = (new_height - tile_size*num_tiles_y) // 2 - - if (new_width % tile_size) >= tile_size//4: - num_tiles_x += 1 - else: - start_x = (new_width - tile_size*num_tiles_x) // 2 - - weight = 1.0 if num_tiles_x == 1 or num_tiles_y == 1 else weight - - ref_image = F.interpolate(image.permute([0,3,1,2]), size=(new_height, new_width), mode="bicubic").permute([0,2,3,1]) - - tiles = [] - attn_mask = [] - - for i in range(num_tiles_y): - for j in range(num_tiles_x): - start_height = i * tile_size + start_y - end_height = start_height + tile_size + start_y - start_width = j * tile_size + start_x - end_width = start_width + tile_size + start_x - - if end_height > new_height: - start_height = new_height - tile_size - end_height = new_height - if end_width > new_width: - start_width = new_width - tile_size - end_width = new_width - - tile = ref_image[:1, start_height:end_height, start_width:end_width, :] - tiles.append(tile.squeeze(0)) - - # create mask - mask = torch.zeros([new_height, new_width], dtype=image.dtype, device=image.device) - mask[start_height:end_height, start_width:end_width] = weight - - attn_mask.append(mask) - - image = torch.stack(tiles, dim=0) - attn_mask = torch.stack(attn_mask, dim=0) - - # If we have a lot of tiles we add bigger tiles with a higher weight to give clipvision a better idea of the overall image - if num_tiles_x != 1 and num_tiles_y != 1: - comp_tiles, comp_attn_mask = masked_tiling(ref_image, 1, 1.0, blur) - - if image.shape[1:3] != comp_tiles.shape[1:3]: - comp_tiles = F.interpolate(comp_tiles.permute([0,3,1,2]), size=(image.shape[1], image.shape[2]), mode="bicubic").permute([0,2,3,1]) - image = torch.cat([comp_tiles, image], dim=0) - - if attn_mask.shape[1:3] != comp_attn_mask.shape[1:3]: - comp_attn_mask = F.interpolate(comp_attn_mask.unsqueeze(1), size=(attn_mask.shape[1], attn_mask.shape[2]), mode="bicubic").squeeze(1) - attn_mask = torch.cat([comp_attn_mask, attn_mask], dim=0) - - if blur > 0: - attn_mask = TT.GaussianBlur(int(6*blur+1), blur)(attn_mask.unsqueeze(1)).permute([0,2,3,1]).squeeze(-1) - - return image, attn_mask - -def image_add_noise(image, noise): - image = image.permute([0,3,1,2]) - torch.manual_seed(0) # use a fixed random for reproducible results - transforms = TT.Compose([ - TT.CenterCrop(min(image.shape[2], image.shape[3])), - TT.Resize((224, 224), interpolation=TT.InterpolationMode.BICUBIC, antialias=True), - TT.ElasticTransform(alpha=75.0, sigma=noise*3.5), # shuffle the image - TT.RandomVerticalFlip(p=1.0), # flip the image to change the geometry even more - TT.RandomHorizontalFlip(p=1.0), - ]) - image = transforms(image.cpu()) - image = image.permute([0,2,3,1]) - image = image + ((0.25*(1-noise)+0.05) * torch.randn_like(image) ) # add further random noise - return image - -def zeroed_hidden_states(clip_vision, batch_size): - image = torch.zeros([batch_size, 224, 224, 3]) - comfy.model_management.load_model_gpu(clip_vision.patcher) - pixel_values = clip_preprocess(image.to(clip_vision.load_device)).float() - outputs = clip_vision.model(pixel_values=pixel_values, intermediate_output=-2) - - # we only need the penultimate hidden states - return outputs[1].to(comfy.model_management.intermediate_device()) - -def encode_image_masked(clip_vision, image, mask=None): - comfy.model_management.load_model_gpu(clip_vision.patcher) - pixel_values = clip_preprocess(image.to(clip_vision.load_device)).float() - - if mask is not None: - pixel_values = pixel_values * mask.to(clip_vision.load_device) - - out = clip_vision.model(pixel_values=pixel_values, intermediate_output=-2) - - outputs = Output() - outputs["last_hidden_state"] = out[0].to(comfy.model_management.intermediate_device()) - outputs["image_embeds"] = out[2].to(comfy.model_management.intermediate_device()) - outputs["penultimate_hidden_states"] = out[1].to(comfy.model_management.intermediate_device()) - return outputs - -def min_(tensor_list): - # return the element-wise min of the tensor list. - x = torch.stack(tensor_list) - mn = x.min(axis=0)[0] - return torch.clamp(mn, min=0) - -def max_(tensor_list): - # return the element-wise max of the tensor list. - x = torch.stack(tensor_list) - mx = x.max(axis=0)[0] - return torch.clamp(mx, max=1) - -# From https://github.com/Jamy-L/Pytorch-Contrast-Adaptive-Sharpening/ -def contrast_adaptive_sharpening(image, amount): - img = F.pad(image, pad=(1, 1, 1, 1)).cpu() - - a = img[..., :-2, :-2] - b = img[..., :-2, 1:-1] - c = img[..., :-2, 2:] - d = img[..., 1:-1, :-2] - e = img[..., 1:-1, 1:-1] - f = img[..., 1:-1, 2:] - g = img[..., 2:, :-2] - h = img[..., 2:, 1:-1] - i = img[..., 2:, 2:] - - # Computing contrast - cross = (b, d, e, f, h) - mn = min_(cross) - mx = max_(cross) - - diag = (a, c, g, i) - mn2 = min_(diag) - mx2 = max_(diag) - mx = mx + mx2 - mn = mn + mn2 - - # Computing local weight - inv_mx = torch.reciprocal(mx) - amp = inv_mx * torch.minimum(mn, (2 - mx)) - - # scaling - amp = torch.sqrt(amp) - w = - amp * (amount * (1/5 - 1/8) + 1/8) - div = torch.reciprocal(1 + 4*w) - - output = ((b + d + f + h)*w + e) * div - output = torch.nan_to_num(output) - output = output.clamp(0, 1) - - return (output) - -def tensorToNP(image): - out = torch.clamp(255. * image.detach().cpu(), 0, 255).to(torch.uint8) - out = out[..., [2, 1, 0]] - out = out.numpy() - - return out - -def NPToTensor(image): - out = torch.from_numpy(image) - out = torch.clamp(out.to(torch.float)/255., 0.0, 1.0) - out = out[..., [2, 1, 0]] - - return out - -class IPAdapterImport(nn.Module): - def __init__(self, ipadapter_model, cross_attention_dim=1024, output_cross_attention_dim=1024, clip_embeddings_dim=1024, clip_extra_context_tokens=4, is_sdxl=False, is_plus=False, is_full=False, is_faceid=False): - super().__init__() - - self.clip_embeddings_dim = clip_embeddings_dim - self.cross_attention_dim = cross_attention_dim - self.output_cross_attention_dim = output_cross_attention_dim - self.clip_extra_context_tokens = clip_extra_context_tokens - self.is_sdxl = is_sdxl - self.is_full = is_full - self.is_plus = is_plus - - if is_faceid: - self.image_proj_model = self.init_proj_faceid() - elif is_plus: - self.image_proj_model = self.init_proj_plus() - else: - self.image_proj_model = self.init_proj() - - self.image_proj_model.load_state_dict(ipadapter_model["image_proj"]) - self.ip_layers = To_KVImport(ipadapter_model["ip_adapter"]) - - def init_proj(self): - image_proj_model = ImageProjModelImport( - cross_attention_dim=self.cross_attention_dim, - clip_embeddings_dim=self.clip_embeddings_dim, - clip_extra_context_tokens=self.clip_extra_context_tokens - ) - return image_proj_model - - def init_proj_plus(self): - if self.is_full: - image_proj_model = MLPProjModelImport( - cross_attention_dim=self.cross_attention_dim, - clip_embeddings_dim=self.clip_embeddings_dim - ) - else: - image_proj_model = ResamplerImport( - dim=self.cross_attention_dim, - depth=4, - dim_head=64, - heads=20 if self.is_sdxl else 12, - num_queries=self.clip_extra_context_tokens, - embedding_dim=self.clip_embeddings_dim, - output_dim=self.output_cross_attention_dim, - ff_mult=4 - ) - return image_proj_model - - def init_proj_faceid(self): - if self.is_plus: - image_proj_model = ProjModelFaceIdPlusImport( - cross_attention_dim=self.cross_attention_dim, - id_embeddings_dim=512, - clip_embeddings_dim=1280, - num_tokens=4, - ) - else: - image_proj_model = MLPProjModelFaceIdImport( - cross_attention_dim=self.cross_attention_dim, - id_embeddings_dim=512, - num_tokens=self.clip_extra_context_tokens, - ) - return image_proj_model - - @torch.inference_mode() - def get_image_embeds(self, clip_embed, clip_embed_zeroed): - image_prompt_embeds = self.image_proj_model(clip_embed) - uncond_image_prompt_embeds = self.image_proj_model(clip_embed_zeroed) - return image_prompt_embeds, uncond_image_prompt_embeds - - @torch.inference_mode() - def get_image_embeds_faceid_plus(self, face_embed, clip_embed, s_scale, shortcut): - embeds = self.image_proj_model(face_embed, clip_embed, scale=s_scale, shortcut=shortcut) - return embeds - -class CrossAttentionPatchImport: - # forward for patching - def __init__(self, weight, ipadapter, number, cond, uncond, weight_type="original", mask=None, sigma_start=0.0, sigma_end=1.0, unfold_batch=False): - self.weights = [weight] - self.ipadapters = [ipadapter] - self.conds = [cond] - self.unconds = [uncond] - self.number = number - self.weight_type = [weight_type] - self.masks = [mask] - self.sigma_start = [sigma_start] - self.sigma_end = [sigma_end] - self.unfold_batch = [unfold_batch] - - self.k_key = str(self.number*2+1) + "_to_k_ip" - self.v_key = str(self.number*2+1) + "_to_v_ip" - - def set_new_condition(self, weight, ipadapter, number, cond, uncond, weight_type="original", mask=None, sigma_start=0.0, sigma_end=1.0, unfold_batch=False): - self.weights.append(weight) - self.ipadapters.append(ipadapter) - self.conds.append(cond) - self.unconds.append(uncond) - self.masks.append(mask) - self.weight_type.append(weight_type) - self.sigma_start.append(sigma_start) - self.sigma_end.append(sigma_end) - self.unfold_batch.append(unfold_batch) - - def __call__(self, n, context_attn2, value_attn2, extra_options): - org_dtype = n.dtype - cond_or_uncond = extra_options["cond_or_uncond"] - sigma = extra_options["sigmas"][0] if 'sigmas' in extra_options else None - sigma = sigma.item() if sigma is not None else 999999999.9 - - # extra options for AnimateDiff - ad_params = extra_options['ad_params'] if "ad_params" in extra_options else None - - q = n - k = context_attn2 - v = value_attn2 - b = q.shape[0] - qs = q.shape[1] - batch_prompt = b // len(cond_or_uncond) - out = optimized_attention(q, k, v, extra_options["n_heads"]) - _, _, lh, lw = extra_options["original_shape"] - - for weight, cond, uncond, ipadapter, mask, weight_type, sigma_start, sigma_end, unfold_batch in zip(self.weights, self.conds, self.unconds, self.ipadapters, self.masks, self.weight_type, self.sigma_start, self.sigma_end, self.unfold_batch): - if sigma > sigma_start or sigma < sigma_end: - continue - - if unfold_batch and cond.shape[0] > 1: - # Check AnimateDiff context window - if ad_params is not None and ad_params["sub_idxs"] is not None: - # if images length matches or exceeds full_length get sub_idx images - if cond.shape[0] >= ad_params["full_length"]: - cond = torch.Tensor(cond[ad_params["sub_idxs"]]) - uncond = torch.Tensor(uncond[ad_params["sub_idxs"]]) - # otherwise, need to do more to get proper sub_idxs masks - else: - # check if images length matches full_length - if not, make it match - if cond.shape[0] < ad_params["full_length"]: - cond = torch.cat((cond, cond[-1:].repeat((ad_params["full_length"]-cond.shape[0], 1, 1))), dim=0) - uncond = torch.cat((uncond, uncond[-1:].repeat((ad_params["full_length"]-uncond.shape[0], 1, 1))), dim=0) - # if we have too many remove the excess (should not happen, but just in case) - if cond.shape[0] > ad_params["full_length"]: - cond = cond[:ad_params["full_length"]] - uncond = uncond[:ad_params["full_length"]] - cond = cond[ad_params["sub_idxs"]] - uncond = uncond[ad_params["sub_idxs"]] - - # if we don't have enough reference images repeat the last one until we reach the right size - if cond.shape[0] < batch_prompt: - cond = torch.cat((cond, cond[-1:].repeat((batch_prompt-cond.shape[0], 1, 1))), dim=0) - uncond = torch.cat((uncond, uncond[-1:].repeat((batch_prompt-uncond.shape[0], 1, 1))), dim=0) - # if we have too many remove the exceeding - elif cond.shape[0] > batch_prompt: - cond = cond[:batch_prompt] - uncond = uncond[:batch_prompt] - - k_cond = ipadapter.ip_layers.to_kvs[self.k_key](cond) - k_uncond = ipadapter.ip_layers.to_kvs[self.k_key](uncond) - v_cond = ipadapter.ip_layers.to_kvs[self.v_key](cond) - v_uncond = ipadapter.ip_layers.to_kvs[self.v_key](uncond) - else: - k_cond = ipadapter.ip_layers.to_kvs[self.k_key](cond).repeat(batch_prompt, 1, 1) - k_uncond = ipadapter.ip_layers.to_kvs[self.k_key](uncond).repeat(batch_prompt, 1, 1) - v_cond = ipadapter.ip_layers.to_kvs[self.v_key](cond).repeat(batch_prompt, 1, 1) - v_uncond = ipadapter.ip_layers.to_kvs[self.v_key](uncond).repeat(batch_prompt, 1, 1) - - if weight_type.startswith("linear"): - ip_k = torch.cat([(k_cond, k_uncond)[i] for i in cond_or_uncond], dim=0) * weight - ip_v = torch.cat([(v_cond, v_uncond)[i] for i in cond_or_uncond], dim=0) * weight - else: - ip_k = torch.cat([(k_cond, k_uncond)[i] for i in cond_or_uncond], dim=0) - ip_v = torch.cat([(v_cond, v_uncond)[i] for i in cond_or_uncond], dim=0) - - if weight_type.startswith("channel"): - # code by Lvmin Zhang at Stanford University as also seen on Fooocus IPAdapter implementation - ip_v_mean = torch.mean(ip_v, dim=1, keepdim=True) - ip_v_offset = ip_v - ip_v_mean - _, _, C = ip_k.shape - channel_penalty = float(C) / 1280.0 - W = weight * channel_penalty - ip_k = ip_k * W - ip_v = ip_v_offset + ip_v_mean * W - - out_ip = optimized_attention(q, ip_k, ip_v, extra_options["n_heads"]) - if weight_type.startswith("original"): - out_ip = out_ip * weight - - if mask is not None: - # TODO: needs checking - mask_h = lh / math.sqrt(lh * lw / qs) - mask_h = int(mask_h) + int((qs % int(mask_h)) != 0) - mask_w = qs // mask_h - - # check if using AnimateDiff and sliding context window - if (mask.shape[0] > 1 and ad_params is not None and ad_params["sub_idxs"] is not None): - # if mask length matches or exceeds full_length, just get sub_idx masks, resize, and continue - if mask.shape[0] >= ad_params["full_length"]: - mask_downsample = torch.Tensor(mask[ad_params["sub_idxs"]]) - mask_downsample = F.interpolate(mask_downsample.unsqueeze(1), size=(mask_h, mask_w), mode="bicubic").squeeze(1) - # otherwise, need to do more to get proper sub_idxs masks - else: - # resize to needed attention size (to save on memory) - mask_downsample = F.interpolate(mask.unsqueeze(1), size=(mask_h, mask_w), mode="bicubic").squeeze(1) - # check if mask length matches full_length - if not, make it match - if mask_downsample.shape[0] < ad_params["full_length"]: - mask_downsample = torch.cat((mask_downsample, mask_downsample[-1:].repeat((ad_params["full_length"]-mask_downsample.shape[0], 1, 1))), dim=0) - # if we have too many remove the excess (should not happen, but just in case) - if mask_downsample.shape[0] > ad_params["full_length"]: - mask_downsample = mask_downsample[:ad_params["full_length"]] - # now, select sub_idxs masks - mask_downsample = mask_downsample[ad_params["sub_idxs"]] - # otherwise, perform usual mask interpolation - else: - mask_downsample = F.interpolate(mask.unsqueeze(1), size=(mask_h, mask_w), mode="bicubic").squeeze(1) - - # if we don't have enough masks repeat the last one until we reach the right size - if mask_downsample.shape[0] < batch_prompt: - mask_downsample = torch.cat((mask_downsample, mask_downsample[-1:, :, :].repeat((batch_prompt-mask_downsample.shape[0], 1, 1))), dim=0) - # if we have too many remove the exceeding - elif mask_downsample.shape[0] > batch_prompt: - mask_downsample = mask_downsample[:batch_prompt, :, :] - - # repeat the masks - mask_downsample = mask_downsample.repeat(len(cond_or_uncond), 1, 1) - mask_downsample = mask_downsample.view(mask_downsample.shape[0], -1, 1).repeat(1, 1, out.shape[2]) - - out_ip = out_ip * mask_downsample - - out = out + out_ip - - return out.to(dtype=org_dtype) - -class IPAdapterModelLoaderImport: - @classmethod - def INPUT_TYPES(s): - return {"required": { "ipadapter_file": (folder_paths.get_filename_list("ipadapter"), )}} - - RETURN_TYPES = ("IPADAPTER",) - FUNCTION = "load_ipadapter_model" - CATEGORY = "ipadapter" - - def load_ipadapter_model(self, ipadapter_file): - ckpt_path = folder_paths.get_full_path("ipadapter", ipadapter_file) - - model = comfy.utils.load_torch_file(ckpt_path, safe_load=True) - - if ckpt_path.lower().endswith(".safetensors"): - st_model = {"image_proj": {}, "ip_adapter": {}} - for key in model.keys(): - if key.startswith("image_proj."): - st_model["image_proj"][key.replace("image_proj.", "")] = model[key] - elif key.startswith("ip_adapter."): - st_model["ip_adapter"][key.replace("ip_adapter.", "")] = model[key] - model = st_model - - if not "ip_adapter" in model.keys() or not model["ip_adapter"]: - raise Exception("invalid IPAdapter model {}".format(ckpt_path)) - - return (model,) - -insightface_face_align = None -class InsightFaceLoaderImport: - @classmethod - def INPUT_TYPES(s): - return { - "required": { - "provider": (["CPU", "CUDA", "ROCM"], ), - }, - } - - RETURN_TYPES = ("INSIGHTFACE",) - FUNCTION = "load_insight_face" - CATEGORY = "ipadapter" - - def load_insight_face(self, provider): - try: - from insightface.app import FaceAnalysis - except ImportError as e: - raise Exception(e) - - from insightface.utils import face_align - global insightface_face_align - insightface_face_align = face_align - - model = FaceAnalysis(name="buffalo_l", root=INSIGHTFACE_DIR, providers=[provider + 'ExecutionProvider',]) - model.prepare(ctx_id=0, det_size=(640, 640)) - - return (model,) - -class IPAdapterApplyImport: - @classmethod - def INPUT_TYPES(s): - return { - "required": { - "ipadapter": ("IPADAPTER", ), - "clip_vision": ("CLIP_VISION",), - "image": ("IMAGE",), - "model": ("MODEL", ), - "weight": ("FLOAT", { "default": 1.0, "min": -1, "max": 3, "step": 0.05 }), - "noise": ("FLOAT", { "default": 0.0, "min": 0.0, "max": 1.0, "step": 0.01 }), - "weight_type": (["original", "linear", "channel penalty"], ), - "start_at": ("FLOAT", { "default": 0.0, "min": 0.0, "max": 1.0, "step": 0.001 }), - "end_at": ("FLOAT", { "default": 1.0, "min": 0.0, "max": 1.0, "step": 0.001 }), - "unfold_batch": ("BOOLEAN", { "default": False }), - }, - "optional": { - "attn_mask": ("MASK",), - } - } - - RETURN_TYPES = ("MODEL",) - FUNCTION = "apply_ipadapter" - CATEGORY = "ipadapter" - - def apply_ipadapter(self, - ipadapter, - model, - weight, - clip_vision=None, - image=None, - weight_type="original", - noise=None, - embeds=None, - attn_mask=None, - start_at=0.0, - end_at=1.0, - unfold_batch=False, - insightface=None, - faceid_v2=False, - weight_v2=False, - clip_vision_mask=None, - short_side_tiles=0, - tile_weight=0.0, - tile_blur=0, - ): - - self.dtype = torch.float16 if comfy.model_management.should_use_fp16() else torch.float32 - self.device = comfy.model_management.get_torch_device() - self.weight = weight - self.is_full = "proj.3.weight" in ipadapter["image_proj"] - self.is_portrait = "proj.2.weight" in ipadapter["image_proj"] and not "proj.3.weight" in ipadapter["image_proj"] and not "0.to_q_lora.down.weight" in ipadapter["ip_adapter"] - self.is_faceid = self.is_portrait or "0.to_q_lora.down.weight" in ipadapter["ip_adapter"] - self.is_plus = (self.is_full or "latents" in ipadapter["image_proj"] or "perceiver_resampler.proj_in.weight" in ipadapter["image_proj"]) - is_tiled = True if short_side_tiles > 0 else False - - if is_tiled: - image, attn_mask = masked_tiling(image, short_side_tiles, tile_weight, tile_blur) - - if self.is_faceid and not insightface: - raise Exception('InsightFace must be provided for FaceID models.') - - output_cross_attention_dim = ipadapter["ip_adapter"]["1.to_k_ip.weight"].shape[1] - self.is_sdxl = output_cross_attention_dim == 2048 - cross_attention_dim = 1280 if self.is_plus and self.is_sdxl and not self.is_faceid else output_cross_attention_dim - clip_extra_context_tokens = 16 if self.is_plus or self.is_portrait else 4 - - if embeds is not None: - embeds = torch.unbind(embeds) - clip_embed = embeds[0].cpu() - clip_embed_zeroed = embeds[1].cpu() - else: - if self.is_faceid: - insightface.det_model.input_size = (640,640) # reset the detection size - face_img = tensorToNP(image) - face_embed = [] - face_clipvision = [] - - for i in range(face_img.shape[0]): - for size in [(size, size) for size in range(640, 128, -64)]: - insightface.det_model.input_size = size # TODO: hacky but seems to be working - face = insightface.get(face_img[i]) - if face: - face_embed.append(torch.from_numpy(face[0].normed_embedding).unsqueeze(0)) - face_clipvision.append(NPToTensor(insightface_face_align.norm_crop(face_img[i], landmark=face[0].kps, image_size=256))) - - if 640 not in size: - print(f"\033[33mINFO: InsightFace detection resolution lowered to {size}.\033[0m") - break - else: - raise Exception('InsightFace: No face detected.') - - face_embed = torch.stack(face_embed, dim=0) - image = torch.stack(face_clipvision, dim=0) - - neg_image = image_add_noise(image, noise) if noise > 0 else None - - if self.is_plus: - clip_embed = clip_vision.encode_image(image).penultimate_hidden_states - if noise > 0: - clip_embed_zeroed = clip_vision.encode_image(neg_image).penultimate_hidden_states - else: - clip_embed_zeroed = zeroed_hidden_states(clip_vision, image.shape[0]) - - # TODO: check noise to the uncods too - face_embed_zeroed = torch.zeros_like(face_embed) - else: - clip_embed = face_embed - clip_embed_zeroed = torch.zeros_like(clip_embed) - else: - if image.shape[1] != image.shape[2]: - print("\033[33mINFO: the IPAdapter reference image is not a square, CLIPImageProcessor will resize and crop it at the center. If the main focus of the picture is not in the middle the result might not be what you are expecting.\033[0m") - - clip_embed = encode_image_masked(clip_vision, image, clip_vision_mask) - neg_image = image_add_noise(image, noise) if noise > 0 else None - - if self.is_plus: - clip_embed = clip_embed.penultimate_hidden_states - if noise > 0: - clip_embed_zeroed = clip_vision.encode_image(neg_image).penultimate_hidden_states - else: - clip_embed_zeroed = zeroed_hidden_states(clip_vision, image.shape[0]) - else: - clip_embed = clip_embed.image_embeds - if noise > 0: - clip_embed_zeroed = clip_vision.encode_image(neg_image).image_embeds - else: - clip_embed_zeroed = torch.zeros_like(clip_embed) - - clip_embeddings_dim = clip_embed.shape[-1] - - self.ipadapter = IPAdapterImport( - ipadapter, - cross_attention_dim=cross_attention_dim, - output_cross_attention_dim=output_cross_attention_dim, - clip_embeddings_dim=clip_embeddings_dim, - clip_extra_context_tokens=clip_extra_context_tokens, - is_sdxl=self.is_sdxl, - is_plus=self.is_plus, - is_full=self.is_full, - is_faceid=self.is_faceid, - ) - - self.ipadapter.to(self.device, dtype=self.dtype) - - if self.is_faceid and self.is_plus: - image_prompt_embeds = self.ipadapter.get_image_embeds_faceid_plus(face_embed.to(self.device, dtype=self.dtype), clip_embed.to(self.device, dtype=self.dtype), weight_v2, faceid_v2) - uncond_image_prompt_embeds = self.ipadapter.get_image_embeds_faceid_plus(face_embed_zeroed.to(self.device, dtype=self.dtype), clip_embed_zeroed.to(self.device, dtype=self.dtype), weight_v2, faceid_v2) - else: - image_prompt_embeds, uncond_image_prompt_embeds = self.ipadapter.get_image_embeds(clip_embed.to(self.device, dtype=self.dtype), clip_embed_zeroed.to(self.device, dtype=self.dtype)) - - image_prompt_embeds = image_prompt_embeds.to(self.device, dtype=self.dtype) - uncond_image_prompt_embeds = uncond_image_prompt_embeds.to(self.device, dtype=self.dtype) - - self.work_model = model.clone() - - if attn_mask is not None: - attn_mask = attn_mask.to(self.device) - - sigma_start = self.work_model.model.model_sampling.percent_to_sigma(start_at) - sigma_end = self.work_model.model.model_sampling.percent_to_sigma(end_at) - - if is_tiled: - for i in range(image_prompt_embeds.shape[0]): #TODO: check if we can apply one mask per image in the attention patch phase - patch_kwargs = { - "number": 0, - "weight": self.weight, - "ipadapter": self.ipadapter, - "cond": image_prompt_embeds[i].unsqueeze(0), - "uncond": uncond_image_prompt_embeds[i].unsqueeze(0), - "weight_type": weight_type, - "mask": attn_mask[i].unsqueeze(0), - "sigma_start": sigma_start, - "sigma_end": sigma_end, - "unfold_batch": unfold_batch, - } - self.apply_patch(patch_kwargs) - else: - patch_kwargs = { - "number": 0, - "weight": self.weight, - "ipadapter": self.ipadapter, - "cond": image_prompt_embeds, - "uncond": uncond_image_prompt_embeds, - "weight_type": weight_type, - "mask": attn_mask, - "sigma_start": sigma_start, - "sigma_end": sigma_end, - "unfold_batch": unfold_batch, - } - self.apply_patch(patch_kwargs) - - return (self.work_model, attn_mask, image,) - - def apply_patch(self, patch_kwargs): - if not self.is_sdxl: - for id in [1,2,4,5,7,8]: # id of input_blocks that have cross attention - set_model_patch_replace(self.work_model, patch_kwargs, ("input", id)) - patch_kwargs["number"] += 1 - for id in [3,4,5,6,7,8,9,10,11]: # id of output_blocks that have cross attention - set_model_patch_replace(self.work_model, patch_kwargs, ("output", id)) - patch_kwargs["number"] += 1 - set_model_patch_replace(self.work_model, patch_kwargs, ("middle", 0)) - else: - for id in [4,5,7,8]: # id of input_blocks that have cross attention - block_indices = range(2) if id in [4, 5] else range(10) # transformer_depth - for index in block_indices: - set_model_patch_replace(self.work_model, patch_kwargs, ("input", id, index)) - patch_kwargs["number"] += 1 - for id in range(6): # id of output_blocks that have cross attention - block_indices = range(2) if id in [3, 4, 5] else range(10) # transformer_depth - for index in block_indices: - set_model_patch_replace(self.work_model, patch_kwargs, ("output", id, index)) - patch_kwargs["number"] += 1 - for index in range(10): - set_model_patch_replace(self.work_model, patch_kwargs, ("middle", 0, index)) - patch_kwargs["number"] += 1 - -class IPAdapterTilesMaskedImport(IPAdapterApplyImport): - @classmethod - def INPUT_TYPES(s): - return { - "required": { - "ipadapter": ("IPADAPTER", ), - "clip_vision": ("CLIP_VISION",), - "image": ("IMAGE",), - "model": ("MODEL", ), - "weight": ("FLOAT", { "default": 0.7, "min": -1, "max": 3, "step": 0.05 }), - "noise": ("FLOAT", { "default": 0.0, "min": 0.0, "max": 1.0, "step": 0.01 }), - "weight_type": (["original", "linear", "channel penalty"], ), - "start_at": ("FLOAT", { "default": 0.0, "min": 0.0, "max": 1.0, "step": 0.001 }), - "end_at": ("FLOAT", { "default": 1.0, "min": 0.0, "max": 1.0, "step": 0.001 }), - "short_side_tiles": ("INT", { "default": 1, "min": 0, "max": 12, "step": 1 }), - "tile_weight": ("FLOAT", { "default": 0.6, "min": 0.0, "max": 1.0, "step": 0.05 }), - #"tile_blur": ("INT", { "default": 0, "min": 0, "max": 112, "step": 1 }), - }, - } - - RETURN_TYPES = ("MODEL",) - -class IPAdapterApplyFaceIDImport(IPAdapterApplyImport): - @classmethod - def INPUT_TYPES(s): - return { - "required": { - "ipadapter": ("IPADAPTER", ), - "clip_vision": ("CLIP_VISION",), - "insightface": ("INSIGHTFACE",), - "image": ("IMAGE",), - "model": ("MODEL", ), - "weight": ("FLOAT", { "default": 1.0, "min": -1, "max": 3, "step": 0.05 }), - "noise": ("FLOAT", { "default": 0.0, "min": 0.0, "max": 1.0, "step": 0.01 }), - "weight_type": (["original", "linear", "channel penalty"], ), - "start_at": ("FLOAT", { "default": 0.0, "min": 0.0, "max": 1.0, "step": 0.001 }), - "end_at": ("FLOAT", { "default": 1.0, "min": 0.0, "max": 1.0, "step": 0.001 }), - "faceid_v2": ("BOOLEAN", { "default": False }), - "weight_v2": ("FLOAT", { "default": 1.0, "min": -1, "max": 3, "step": 0.05 }), - "unfold_batch": ("BOOLEAN", { "default": False }), - }, - "optional": { - "attn_mask": ("MASK",), - } - } - -def prepImage(image, interpolation="LANCZOS", crop_position="center", size=(224,224), sharpening=0.0, padding=0): - _, oh, ow, _ = image.shape - output = image.permute([0,3,1,2]) - - if "pad" in crop_position: - target_length = max(oh, ow) - pad_l = (target_length - ow) // 2 - pad_r = (target_length - ow) - pad_l - pad_t = (target_length - oh) // 2 - pad_b = (target_length - oh) - pad_t - output = F.pad(output, (pad_l, pad_r, pad_t, pad_b), value=0, mode="constant") - else: - crop_size = min(oh, ow) - x = (ow-crop_size) // 2 - y = (oh-crop_size) // 2 - if "top" in crop_position: - y = 0 - elif "bottom" in crop_position: - y = oh-crop_size - elif "left" in crop_position: - x = 0 - elif "right" in crop_position: - x = ow-crop_size - - x2 = x+crop_size - y2 = y+crop_size - - # crop - output = output[:, :, y:y2, x:x2] - - # resize (apparently PIL resize is better than tourchvision interpolate) - imgs = [] - for i in range(output.shape[0]): - img = TT.ToPILImage()(output[i]) - img = img.resize(size, resample=Image.Resampling[interpolation]) - imgs.append(TT.ToTensor()(img)) - output = torch.stack(imgs, dim=0) - imgs = None # zelous GC - - if sharpening > 0: - output = contrast_adaptive_sharpening(output, sharpening) - - if padding > 0: - output = F.pad(output, (padding, padding, padding, padding), value=255, mode="constant") - - output = output.permute([0,2,3,1]) - - return output - -class PrepImageForInsightFaceImport: - @classmethod - def INPUT_TYPES(s): - return {"required": { - "image": ("IMAGE",), - "crop_position": (["center", "top", "bottom", "left", "right"],), - "sharpening": ("FLOAT", {"default": 0.0, "min": 0, "max": 1, "step": 0.05}), - "pad_around": ("BOOLEAN", { "default": True }), - }, - } - - RETURN_TYPES = ("IMAGE",) - FUNCTION = "prep_image" - - CATEGORY = "ipadapter" - - def prep_image(self, image, crop_position, sharpening=0.0, pad_around=True): - if pad_around: - padding = 30 - size = (580, 580) - else: - padding = 0 - size = (640, 640) - output = prepImage(image, "LANCZOS", crop_position, size, sharpening, padding) - - return (output, ) - -class PrepImageForClipVisionImport: - @classmethod - def INPUT_TYPES(s): - return {"required": { - "image": ("IMAGE",), - "interpolation": (["LANCZOS", "BICUBIC", "HAMMING", "BILINEAR", "BOX", "NEAREST"],), - "crop_position": (["top", "bottom", "left", "right", "center", "pad"],), - "sharpening": ("FLOAT", {"default": 0.0, "min": 0, "max": 1, "step": 0.05}), - }, - } - - RETURN_TYPES = ("IMAGE",) - FUNCTION = "prep_image" - - CATEGORY = "ipadapter" - - def prep_image(self, image, interpolation="LANCZOS", crop_position="center", sharpening=0.0): - size = (224, 224) - output = prepImage(image, interpolation, crop_position, size, sharpening, 0) - return (output, ) - -class IPAdapterEncoderImport: - @classmethod - def INPUT_TYPES(s): - return {"required": { - "clip_vision": ("CLIP_VISION",), - "image_1": ("IMAGE",), - "ipadapter_plus": ("BOOLEAN", { "default": False }), - "noise": ("FLOAT", { "default": 0.0, "min": 0.0, "max": 1.0, "step": 0.01 }), - "weight_1": ("FLOAT", { "default": 1.0, "min": 0, "max": 1.0, "step": 0.01 }), - }, - "optional": { - "image_2": ("IMAGE",), - "image_3": ("IMAGE",), - "image_4": ("IMAGE",), - "weight_2": ("FLOAT", { "default": 1.0, "min": 0, "max": 1.0, "step": 0.01 }), - "weight_3": ("FLOAT", { "default": 1.0, "min": 0, "max": 1.0, "step": 0.01 }), - "weight_4": ("FLOAT", { "default": 1.0, "min": 0, "max": 1.0, "step": 0.01 }), - } - } - - RETURN_TYPES = ("EMBEDS",) - FUNCTION = "preprocess" - CATEGORY = "ipadapter" - - def preprocess(self, clip_vision, image_1, ipadapter_plus, noise, weight_1, image_2=None, image_3=None, image_4=None, weight_2=1.0, weight_3=1.0, weight_4=1.0): - weight_1 *= (0.1 + (weight_1 - 0.1)) - weight_2 *= (0.1 + (weight_2 - 0.1)) - weight_3 *= (0.1 + (weight_3 - 0.1)) - weight_4 *= (0.1 + (weight_4 - 0.1)) - - image = image_1 - weight = [weight_1]*image_1.shape[0] - - if image_2 is not None: - if image_1.shape[1:] != image_2.shape[1:]: - image_2 = comfy.utils.common_upscale(image_2.movedim(-1,1), image.shape[2], image.shape[1], "bilinear", "center").movedim(1,-1) - image = torch.cat((image, image_2), dim=0) - weight += [weight_2]*image_2.shape[0] - if image_3 is not None: - if image.shape[1:] != image_3.shape[1:]: - image_3 = comfy.utils.common_upscale(image_3.movedim(-1,1), image.shape[2], image.shape[1], "bilinear", "center").movedim(1,-1) - image = torch.cat((image, image_3), dim=0) - weight += [weight_3]*image_3.shape[0] - if image_4 is not None: - if image.shape[1:] != image_4.shape[1:]: - image_4 = comfy.utils.common_upscale(image_4.movedim(-1,1), image.shape[2], image.shape[1], "bilinear", "center").movedim(1,-1) - image = torch.cat((image, image_4), dim=0) - weight += [weight_4]*image_4.shape[0] - - clip_embed = clip_vision.encode_image(image) - neg_image = image_add_noise(image, noise) if noise > 0 else None - - if ipadapter_plus: - clip_embed = clip_embed.penultimate_hidden_states - if noise > 0: - clip_embed_zeroed = clip_vision.encode_image(neg_image).penultimate_hidden_states - else: - clip_embed_zeroed = zeroed_hidden_states(clip_vision, image.shape[0]) - else: - clip_embed = clip_embed.image_embeds - if noise > 0: - clip_embed_zeroed = clip_vision.encode_image(neg_image).image_embeds - else: - clip_embed_zeroed = torch.zeros_like(clip_embed) - - if any(e != 1.0 for e in weight): - weight = torch.tensor(weight).unsqueeze(-1) if not ipadapter_plus else torch.tensor(weight).unsqueeze(-1).unsqueeze(-1) - clip_embed = clip_embed * weight - - output = torch.stack((clip_embed, clip_embed_zeroed)) - - return( output, ) - -class IPAdapterApplyEncodedImport(IPAdapterApplyImport): - @classmethod - def INPUT_TYPES(s): - return { - "required": { - "ipadapter": ("IPADAPTER", ), - "embeds": ("EMBEDS",), - "model": ("MODEL", ), - "weight": ("FLOAT", { "default": 1.0, "min": -1, "max": 3, "step": 0.05 }), - "weight_type": (["original", "linear", "channel penalty"], ), - "start_at": ("FLOAT", { "default": 0.0, "min": 0.0, "max": 1.0, "step": 0.001 }), - "end_at": ("FLOAT", { "default": 1.0, "min": 0.0, "max": 1.0, "step": 0.001 }), - "unfold_batch": ("BOOLEAN", { "default": False }), - }, - "optional": { - "attn_mask": ("MASK",), - } - } - -class IPAdapterSaveEmbedsImport: - def __init__(self): - self.output_dir = folder_paths.get_output_directory() - - @classmethod - def INPUT_TYPES(s): - return {"required": { - "embeds": ("EMBEDS",), - "filename_prefix": ("STRING", {"default": "embeds/IPAdapter"}) - }, - } - - RETURN_TYPES = () - FUNCTION = "save" - OUTPUT_NODE = True - CATEGORY = "ipadapter" - - def save(self, embeds, filename_prefix): - full_output_folder, filename, counter, subfolder, filename_prefix = folder_paths.get_save_image_path(filename_prefix, self.output_dir) - file = f"{filename}_{counter:05}_.ipadpt" - file = os.path.join(full_output_folder, file) - - torch.save(embeds, file) - return (None, ) - - -class IPAdapterLoadEmbedsImport: - @classmethod - def INPUT_TYPES(s): - input_dir = folder_paths.get_input_directory() - files = [os.path.relpath(os.path.join(root, file), input_dir) for root, dirs, files in os.walk(input_dir) for file in files if file.endswith('.ipadpt')] - return {"required": {"embeds": [sorted(files), ]}, } - - RETURN_TYPES = ("EMBEDS", ) - FUNCTION = "load" - CATEGORY = "ipadapter" - - def load(self, embeds): - path = folder_paths.get_annotated_filepath(embeds) - output = torch.load(path).cpu() - - return (output, ) - - -class IPAdapterBatchEmbedsImport: - @classmethod - def INPUT_TYPES(s): - return {"required": { - "embed1": ("EMBEDS",), - "embed2": ("EMBEDS",), - }} - - RETURN_TYPES = ("EMBEDS",) - FUNCTION = "batch" - CATEGORY = "ipadapter" - - def batch(self, embed1, embed2): - return (torch.cat((embed1, embed2), dim=1), ) - - - -import math - -import torch -import torch.nn as nn -from einops import rearrange -from einops.layers.torch import Rearrange - - -# FFN -def FeedForwardImport(dim, mult=4): - inner_dim = int(dim * mult) - return nn.Sequential( - nn.LayerNorm(dim), - nn.Linear(dim, inner_dim, bias=False), - nn.GELU(), - nn.Linear(inner_dim, dim, bias=False), - ) - - -def reshape_tensor(x, heads): - bs, length, width = x.shape - # (bs, length, width) --> (bs, length, n_heads, dim_per_head) - x = x.view(bs, length, heads, -1) - # (bs, length, n_heads, dim_per_head) --> (bs, n_heads, length, dim_per_head) - x = x.transpose(1, 2) - # (bs, n_heads, length, dim_per_head) --> (bs*n_heads, length, dim_per_head) - x = x.reshape(bs, heads, length, -1) - return x - - -class PerceiverAttentionImport(nn.Module): - def __init__(self, *, dim, dim_head=64, heads=8): - super().__init__() - self.scale = dim_head**-0.5 - self.dim_head = dim_head - self.heads = heads - inner_dim = dim_head * heads - - self.norm1 = nn.LayerNorm(dim) - self.norm2 = nn.LayerNorm(dim) - - self.to_q = nn.Linear(dim, inner_dim, bias=False) - self.to_kv = nn.Linear(dim, inner_dim * 2, bias=False) - self.to_out = nn.Linear(inner_dim, dim, bias=False) - - def forward(self, x, latents): - """ - Args: - x (torch.Tensor): image features - shape (b, n1, D) - latent (torch.Tensor): latent features - shape (b, n2, D) - """ - x = self.norm1(x) - latents = self.norm2(latents) - - b, l, _ = latents.shape - - q = self.to_q(latents) - kv_input = torch.cat((x, latents), dim=-2) - k, v = self.to_kv(kv_input).chunk(2, dim=-1) - - q = reshape_tensor(q, self.heads) - k = reshape_tensor(k, self.heads) - v = reshape_tensor(v, self.heads) - - # attention - scale = 1 / math.sqrt(math.sqrt(self.dim_head)) - weight = (q * scale) @ (k * scale).transpose(-2, -1) # More stable with f16 than dividing afterwards - weight = torch.softmax(weight.float(), dim=-1).type(weight.dtype) - out = weight @ v - - out = out.permute(0, 2, 1, 3).reshape(b, l, -1) - - return self.to_out(out) - - -class ResamplerImport(nn.Module): - def __init__( - self, - dim=1024, - depth=8, - dim_head=64, - heads=16, - num_queries=8, - embedding_dim=768, - output_dim=1024, - ff_mult=4, - max_seq_len: int = 257, # CLIP tokens + CLS token - apply_pos_emb: bool = False, - num_latents_mean_pooled: int = 0, # number of latents derived from mean pooled representation of the sequence - ): - super().__init__() - self.pos_emb = nn.Embedding(max_seq_len, embedding_dim) if apply_pos_emb else None - - self.latents = nn.Parameter(torch.randn(1, num_queries, dim) / dim**0.5) - - self.proj_in = nn.Linear(embedding_dim, dim) - - self.proj_out = nn.Linear(dim, output_dim) - self.norm_out = nn.LayerNorm(output_dim) - - self.to_latents_from_mean_pooled_seq = ( - nn.Sequential( - nn.LayerNorm(dim), - nn.Linear(dim, dim * num_latents_mean_pooled), - Rearrange("b (n d) -> b n d", n=num_latents_mean_pooled), - ) - if num_latents_mean_pooled > 0 - else None - ) - - self.layers = nn.ModuleList([]) - for _ in range(depth): - self.layers.append( - nn.ModuleList( - [ - PerceiverAttentionImport(dim=dim, dim_head=dim_head, heads=heads), - FeedForwardImport(dim=dim, mult=ff_mult), - ] - ) - ) - - def forward(self, x): - if self.pos_emb is not None: - n, device = x.shape[1], x.device - pos_emb = self.pos_emb(torch.arange(n, device=device)) - x = x + pos_emb - - latents = self.latents.repeat(x.size(0), 1, 1) - - x = self.proj_in(x) - - if self.to_latents_from_mean_pooled_seq: - meanpooled_seq = masked_mean(x, dim=1, mask=torch.ones(x.shape[:2], device=x.device, dtype=torch.bool)) - meanpooled_latents = self.to_latents_from_mean_pooled_seq(meanpooled_seq) - latents = torch.cat((meanpooled_latents, latents), dim=-2) - - for attn, ff in self.layers: - latents = attn(x, latents) + latents - latents = ff(latents) + latents - - latents = self.proj_out(latents) - return self.norm_out(latents) - - -def masked_mean(t, *, dim, mask=None): - if mask is None: - return t.mean(dim=dim) - - denom = mask.sum(dim=dim, keepdim=True) - mask = rearrange(mask, "b n -> b n 1") - masked_t = t.masked_fill(~mask, 0.0) - - return masked_t.sum(dim=dim) / denom.clamp(min=1e-5) - - -def prep_image(image, interpolation="LANCZOS", crop_position="center", sharpening=0.0): - _, oh, ow, _ = image.shape - output = image.permute([0,3,1,2]) - - if "pad" in crop_position: - target_length = max(oh, ow) - pad_l = (target_length - ow) // 2 - pad_r = (target_length - ow) - pad_l - pad_t = (target_length - oh) // 2 - pad_b = (target_length - oh) - pad_t - output = F.pad(output, (pad_l, pad_r, pad_t, pad_b), value=0, mode="constant") - else: - crop_size = min(oh, ow) - x = (ow-crop_size) // 2 - y = (oh-crop_size) // 2 - if "top" in crop_position: - y = 0 - elif "bottom" in crop_position: - y = oh-crop_size - elif "left" in crop_position: - x = 0 - elif "right" in crop_position: - x = ow-crop_size - - x2 = x+crop_size - y2 = y+crop_size - - # crop - output = output[:, :, y:y2, x:x2] - - # resize (apparently PIL resize is better than tourchvision interpolate) - imgs = [] - for i in range(output.shape[0]): - img = TT.ToPILImage()(output[i]) - img = img.resize((224,224), resample=Image.Resampling[interpolation]) - imgs.append(TT.ToTensor()(img)) - output = torch.stack(imgs, dim=0) - - if sharpening > 0: - output = contrast_adaptive_sharpening(output, sharpening) - - output = output.permute([0,2,3,1]) - - return (output,) \ No newline at end of file