# Hanzo Studio custom-node packs -- pinned, reproducible, first-class "hanzo packages".
#
# Format:  <dir_name>  <git_url>  <commit_sha>  <spdx_license>   # friendly-ref
#
# Installed by scripts/install_custom_nodes.sh (invoked in the Docker image build
# and runnable locally) so the studio.hanzo.ai image ships the same packs the
# local GB10 worker runs. Upstream packs import comfy.* / subclass io.ComfyNode /
# expose comfy_entrypoint -- studio_compat aliases those to the studio.* names at
# boot and the loader honors comfy_entrypoint, so packs run UNMODIFIED (no fork,
# no source edits). Python deps: custom_nodes-requirements.txt (+ -constraints.txt).
#
# Pinned to immutable commit SHAs. To bump a pack: replace its SHA + re-run the
# installer (patch-bump; never blind-track HEAD). All licenses are OSI (GPL/AGPL/
# MIT/Apache) -- none are non-commercial.

ComfyUI-Impact-Pack          https://github.com/ltdrdata/ComfyUI-Impact-Pack.git           429d0159ad429e64d2b3916e6e7be9c22d025c3c  GPL-3.0     # 8.28
ComfyUI-Impact-Subpack       https://github.com/ltdrdata/ComfyUI-Impact-Subpack.git        50c7b71a6a224734cc9b21963c6d1926816a97f1  AGPL-3.0    # 1.3.4  Ultralytics detectors
ComfyUI_IPAdapter_plus       https://github.com/cubiq/ComfyUI_IPAdapter_plus.git           a0f451a5113cf9becb0847b92884cb10cbdec0ef  GPL-3.0     # HEAD 2025-04-14
comfyui_controlnet_aux       https://github.com/Fannovel16/comfyui_controlnet_aux.git      e8b689a513c3e6b63edc44066560ca5919c0576e  Apache-2.0  # HEAD 2026-04-13
ComfyUI_UltimateSDUpscale    https://github.com/ssitu/ComfyUI_UltimateSDUpscale.git        a5547db9e1d07d3318bb21e9e9c474f4c1e9c8df  GPL-3.0     # HEAD 2026-06-22
ComfyUI-Frame-Interpolation  https://github.com/Fannovel16/ComfyUI-Frame-Interpolation.git 26545cc2dd95bc3d27f056016300673bdeee78f5  MIT         # HEAD 2026-03-29
ComfyUI-VideoHelperSuite     https://github.com/Kosinkadink/ComfyUI-VideoHelperSuite.git   4ee72c065db22c9d96c2427954dc69e7b908444b  GPL-3.0     # HEAD 2026-05-14
rgthree-comfy                https://github.com/rgthree/rgthree-comfy.git                  27b4f4cdcf3b127c29d5d8135ac1536ecbd4c383  MIT         # HEAD 2026-06-20
ComfyUI-Custom-Scripts       https://github.com/pythongosssss/ComfyUI-Custom-Scripts.git   609f3afaa74b2f88ef9ce8d939626065e3247469  MIT         # HEAD 2026-02-12
ComfyUI-KJNodes              https://github.com/kijai/ComfyUI-KJNodes.git                  e27a505b3ba6ce42687fe00500deda103d9d6071  GPL-3.0     # HEAD 2026-07-01
cg-use-everywhere            https://github.com/chrisgoringe/cg-use-everywhere.git         632ed7bb51bb18ceb03ccaefe1f34be8bd416500  Apache-2.0  # HEAD 2026-06-22
ComfyUI-segment-anything-2   https://github.com/kijai/ComfyUI-segment-anything-2.git       0c35fff5f382803e2310103357b5e985f5437f32  Apache-2.0  # HEAD 2025-09-28  SAM2
comfyui_segment_anything     https://github.com/storyicon/comfyui_segment_anything.git     ab6395596399d5048639cdab7e44ec9fae857a93  Apache-2.0  # HEAD  GroundingDINO+SAM
ComfyUI-Inpaint-CropAndStitch https://github.com/lquesada/ComfyUI-Inpaint-CropAndStitch.git 3617559bcb9d15ff60b24c6800701402eb2cd478  GPL-3.0     # 2026-05-25  seam-invisible masked inpaint (couture_best dep)

# --- BAKEOFF-ONLY (cloned for the garment-swap bake-off; NOT auto-installed) ----
# ComfyUI-CatvtonFluxWrapper  https://github.com/lujiazho/ComfyUI-CatvtonFluxWrapper.git  06558c42c539397af8e4d221ddccea870de72d1f  (no LICENSE file)
#   CatVTON-Flux diffusers wrapper. Hardcodes the GATED black-forest-labs/FLUX.1-Fill-dev
#   diffusers repo + CC-BY-NC CatVTON LoRA, so it won't load without HF auth. The winning
#   workflow (couture_best.json) reproduces CatVTON's in-context transfer with CORE nodes
#   + the catvton_flux_lora_alpha weights via LoraLoaderModelOnly, so this pack is NOT a
#   runtime dependency. Kept as a record of what was evaluated.

# --- QUARANTINED (not installed; kept here as a record) -------------------------
# was-node-suite-comfyui  https://github.com/WASasquatch/was-node-suite-comfyui.git  ea935d1044ae5a26efa54ebeb18fe9020af49a45  MIT
#   Reason: hard `from numba import jit` at import; numba has no release supporting
#   the studio venv's NumPy 2.5 ("Numba needs NumPy 2.4 or less"). Re-enabling would
#   require downgrading NumPy (forbidden -- breaks the cu130 torch stack) or waiting
#   for a numba release that supports NumPy 2.5. Revisit then. License (MIT) is fine.

# --- 3D generation + texturing (image->3D mesh / gaussian-splat, PBR texture bake) ---
# Packs install NODE/MODEL CODE ONLY -- all permissive (MIT/Apache). Model WEIGHTS are
# NOT shipped here: each downloads its own weights at runtime from the model's source.
# Where those weights are non-open, the friendly-ref NOTES it -- bring your own license.
# The software runs whatever you point it at; it just tells you the terms. No gate.
ComfyUI-3D-Pack              https://github.com/MrForExample/ComfyUI-3D-Pack.git           9e8096e50c5bcf35e1f3e34c6ae06216101f8a11  MIT         # TripoSR+InstantMesh+gaussian-splat+mesh/texture export (weights per-model, mostly MIT/Apache)
Comfy3D_Pre_Builds           https://github.com/MrForExample/Comfy3D_Pre_Builds.git        d31ef4c84dfa47d789cc5e4af04992763e4e9fbd  MIT         # prebuilt native deps for ComfyUI-3D-Pack (nvdiffrast/pytorch3d)
ComfyUI-Flowty-TripoSR       https://github.com/flowtyone/ComfyUI-Flowty-TripoSR.git       a0c94ac60a7cc062604f61aeeea6d0d493521de3  MIT         # fast image->3D mesh; TripoSR weights MIT
TRELLIS.2                    https://github.com/microsoft/TRELLIS.2.git                    75fbf0183001ed9876c8dbb35de6b68552ee08bd  MIT         # Microsoft TRELLIS.2 image->3D (SLAT + RFT), best-in-class; weights MIT
Pixal3D                      https://github.com/TencentARC/Pixal3D.git                     cdbb2bbffbf4e6f298b5f2af3d1d76a8d823d2af  MIT         # TencentARC Pixal3D pixel-aligned image->3D (TRELLIS.2 core + DinoV3 + MoGe); MIT weights, commercial-clean
ComfyUI-Hunyuan3DWrapper     https://github.com/kijai/ComfyUI-Hunyuan3DWrapper.git         2609efa38f6a98292476f714839b7c1e5f9b699a  Apache-2.0  # node code Apache; NOTICE: Hunyuan3D *weights* = Tencent Community License (no commercial EU/UK/KR, 100M-MAU cap) -- bring your own license

# --- music + song generation (text/lyrics -> full song w/ vocals + accompaniment) ---
# Same rule: NODE CODE ONLY (permissive); model WEIGHTS download at runtime, BYO-license
# where non-open. ACE-Step = the commercial-clean pick (Apache weights). LeVo (Tencent AI
# Lab, best-quality per its paper) has an unsettled weights license -> noted, bring your own.
ComfyUI_ACE-Step            https://github.com/billwuhao/ComfyUI_ACE-Step.git             d4c2dc104a6977c83c9406b62464102c757a879c  Apache-2.0  # ACE-Step 3.5B text->music foundation model; node Apache + weights Apache-2.0 (commercial-clean)

# --- video generation (text/image -> video) ---
ComfyUI-WanVideoWrapper     https://github.com/kijai/ComfyUI-WanVideoWrapper.git          088128b224242e110d3906c6750e9a3a348a659b  Apache-2.0  # WAN 2.1/2.2 t2v+i2v; node Apache + WAN weights Apache-2.0 (commercial-clean)
ComfyUI-LTXVideo            https://github.com/Lightricks/ComfyUI-LTXVideo.git            aceeae9635f6d493f2893ba3c411a1c36031788a  Apache-2.0  # LTX-Video fast t2v/i2v; node Apache, weights OpenRAIL-M (open, use-restrictions apply)
ComfyUI-CogVideoXWrapper    https://github.com/kijai/ComfyUI-CogVideoXWrapper.git         fdb8abd2790b5459ddc7066c31861bb0b62e988b  Apache-2.0  # CogVideoX t2v/i2v; node Apache, CogVideoX-2b Apache (5b = custom CogVideoX license, check)
ComfyUI-HunyuanVideoWrapper https://github.com/kijai/ComfyUI-HunyuanVideoWrapper.git      fcbd6729a9b0b8ff6037c598bbada4a6bdc6d967  Apache-2.0  # node Apache; NOTICE: HunyuanVideo *weights* = Tencent Community License (no commercial EU/UK/KR) -- bring your own license

# --- voice / TTS (text -> speech, voice clone) ---
comfyui-kokoro              https://github.com/stavsap/comfyui-kokoro.git                 cfb59b5605b351e196182c836f0b48c1a784e52f  MIT         # Kokoro-82M TTS; node MIT + weights Apache-2.0 (commercial-clean, fast)
ComfyUI_ChatterBox_Voice    https://github.com/ShmuelRonen/ComfyUI_ChatterBox_Voice.git   6e5fc4e268656235c50e1e791f6b5d7afe615677  MIT         # Resemble Chatterbox TTS + voice clone; node MIT + weights MIT (commercial-clean)
ComfyUI-F5-TTS              https://github.com/niknah/ComfyUI-F5-TTS.git                  da9776ac5ba04f2d0b837f7dc6d5684499f3ba0b  MIT         # node MIT; NOTICE: F5-TTS *weights* = CC-BY-NC-4.0 (NON-COMMERCIAL) -- bring your own license for commercial

# --- infra: run GGUF-quantized diffusion/LLM models in-workflow (memory-efficient) ---
ComfyUI-GGUF               https://github.com/city96/ComfyUI-GGUF.git                    6ea2651e7df66d7585f6ffee804b20e92fb38b8a  Apache-2.0  # GGUF-quantized model loader (Flux/SD/video in low VRAM); Apache

# --- foley / sound-effects (text->SFX, video->audio) — the named gap ---
ComfyUI-MMAudio             https://github.com/kijai/ComfyUI-MMAudio.git                  8eaeb72edc3aaf2059b57f2d96a1f6f689f19ae2  Apache-2.0  # MMAudio video->audio / text->SFX (Sony, CVPR2025); node Apache, NOTICE: weights CC-BY-NC-4.0 -- BYO-license for commercial
ComfyUI-AudioLDM            https://github.com/sanbuphy/ComfyUI-AudioLDM.git              d1edf02527f1cdc5c037842ffed1a2b564aa52fc  MIT         # AudioLDM2 text->audio/SFX; node MIT, NOTICE: weights CC-BY-NC-SA-4.0 -- BYO-license for commercial

# --- audio source separation (music -> stems: vocals/drums/bass) ---
audio-separation-nodes      https://github.com/christian-byrne/audio-separation-nodes-comfyui.git  ac339561973f0c1e56db2f9d40f11b0fddda6763  MIT  # Demucs-based stem separation (vocals/drums/bass/other); node MIT + Demucs weights MIT (commercial-clean)

# --- voice/TTS (production, commercial-clean additions) ---
ComfyUI-VibeVoice           https://github.com/wildminder/ComfyUI-VibeVoice.git           99a98031d79e07f279a7aa6d01ce89042e8bba26  MIT         # Microsoft VibeVoice long-form conversational TTS; node + weights MIT (commercial-clean)

# --- image gen: text-render + photorealism (permissive alternatives to FLUX) ---
ComfyUI-KwaiKolorsWrapper    https://github.com/kijai/ComfyUI-KwaiKolorsWrapper.git        6fc1cd9d20bb7537facf180e5494b486b9710e24  Apache-2.0  # Kwai Kolors t2i photorealism; node + weights Apache-2.0 (commercial-clean)

# --- video gen: permissive Apache alternatives ---
ComfyUI-MochiWrapper         https://github.com/kijai/ComfyUI-MochiWrapper.git             e1bd05240ac31b72166e9d952c75dd5735352311  Apache-2.0  # Genmo Mochi-1 t2v high-quality; node + weights Apache-2.0 (commercial-clean)
ComfyUI-PyramidFlowWrapper   https://github.com/kijai/ComfyUI-PyramidFlowWrapper.git       426e3653048575dd1d1d49763a1e02fcfccf5078  Apache-2.0  # Pyramid-Flow t2v transformer-flow; node Apache, NOTICE: weights custom license -- verify for commercial

# --- music: long-form lyrics->song (Apache) ---
ComfyUI_DiffRhythm           https://github.com/billwuhao/ComfyUI_DiffRhythm.git           2601a33e58fd49c63451f82db6a1c70b7b1f09fe  Apache-2.0  # DiffRhythm full-length lyrics->song (non-autoregressive, fast); node + weights Apache-2.0

# --- voice: streaming + emotional TTS (Apache) ---
CosyVoice-ComfyUI            https://github.com/AIFSH/CosyVoice-ComfyUI.git                67e650c761cd5306a4a06bc050196b84ab592aa3  Apache-2.0  # Alibaba CosyVoice2 real-time streaming + emotional TTS + zero-shot clone; node + weights Apache-2.0
