jdopensource/JoyAI-Image-Edit-ComfyUI

JoyAI-Image-Edit (ComfyUI)

Repackaged single-file weights of jdopensource/JoyAI-Image-Edit-Diffusers for ComfyUI's standard model-folder layout. Keys, filenames and directory layout follow the Comfy-Org packaging convention used by Qwen-Image-Edit_ComfyUI and Wan_2.1_ComfyUI_repackaged — drop the files into ComfyUI/models/ and they load natively.

Files

File	Size	Goes into	Component
split_files/diffusion_models/joyai_image_edit_bf16.safetensors	~32 GB	ComfyUI/models/diffusion_models/	JoyImageEditTransformer3DModel (bf16)
split_files/text_encoders/qwen_3vl_8b_joyimage_bf16.safetensors	~17 GB	ComfyUI/models/text_encoders/	Qwen3-VL-8B text encoder, JoyImage-finetuned (bf16)
split_files/vae/wan_2.1_vae.safetensors	~250 MB	ComfyUI/models/vae/	Wan 2.1 VAE (shared with Wan / Qwen-Image; bf16)

The VAE is the standard Wan 2.1 VAE — bit-identical to Comfy-Org/Wan_2.1_ComfyUI_repackaged/split_files/vae/wan_2.1_vae.safetensors. If you already have it from Wan or Qwen-Image, you can skip the VAE here.

Quick start

# Download into ComfyUI/models/ (skips split_files/ wrapper):
hf download jdopensource/JoyAI-Image-Edit-ComfyUI \
  --include "split_files/*" \
  --local-dir /path/to/ComfyUI/models \
  --local-dir-use-symlinks False

# Or fetch each file individually into the matching model folder.

Requirements

Native JoyImageEdit support is in flight upstream against Comfy-Org/ComfyUI. Until the PR lands, install ComfyUI from the JoyAI fork's branch:

git clone https://github.com/jd-opensource/JoyAI-Image.git
# follow the ComfyUI branch instructions in JoyAI-Image/README.md

When the upstream PR merges, plain comfyanonymous/ComfyUI will detect and load these files with no extra setup.

Key namespaces

For developers / quantizers — the top-level state-dict prefixes in each file:

• diffusion_models: raw transformer keys (double_blocks.*, condition_embedder.*, img_in.*, proj_out.*, norm_out.*). No model.diffusion_model. wrapper. Auto-detected by ComfyUI's model_detection.py.
• text_encoders: HF Qwen3-VL keys (model.language_model.*, model.visual.*, lm_head.*). ComfyUI strips the model. wrappers internally.
• vae: standard Comfy-Org Wan 2.1 VAE keys (encoder.{conv1,downsamples,middle}.*, decoder.{conv1,upsamples,middle,head}.*, plus top-level conv1.*/conv2.* for the post-quant projections).

Links

• Source code & nodes: github.com/jd-opensource/JoyAI-Image
• Diffusers weights: jdopensource/JoyAI-Image-Edit-Diffusers
• GGUF quantizations (community): huangfeice/JoyAI-Image-Edit-Diffusers-GGUF
• License: Apache 2.0