requirements.txt

# Core dependencies (provided by ComfyUI)
# torch
# torchvision
# numpy

# Required
opencv-python>=4.7.0
scipy>=1.10.0

# ── NukeNodeMax suite ────────────────────────────────────────────────
# F7 integrity guard — used by nodes/integrity_guard.py
pipdeptree>=2.13.0
# P0/P1/P2 ProPainter bridge — install manually (not on PyPI):
#   pip install git+https://github.com/sczhou/ProPainter.git
# RAFT + RFC + Inpaint weights are auto-downloaded by propainter_bridge.py
# from the v0.1.0 GitHub release on first use.

# SAM2/2.1 model support (install from GitHub if pip install SAM-2 fails)
# pip install git+https://github.com/facebookresearch/sam2.git
safetensors>=0.4.0

# ── SAM 3.1 (independent, vendored at third_party/sam3_lib) ──────────
# Required by the vendored SAM3 reference implementation.
timm>=1.0.0
einops>=0.7.0
huggingface_hub>=0.24.0
# ftfy + regex are pulled in by the BPE tokenizer in sam3_lib.
ftfy>=6.1.0
regex>=2023.0.0
# Optional acceleration (not enforced):
#   pip install flash-attn --no-build-isolation

# Optional – ViTMatte neural matting (auto-downloads model from HuggingFace)
# Uncomment if you want the best edge refinement:
# transformers>=4.30.0
# pillow>=9.0.0

# ── Phase 4 VFX Suite (all optional) ──────────────────────────────────
# EXR I/O (Load/Save EXR nodes). OpenEXR is preferred; imageio is the
# fallback. Either is sufficient.
# OpenEXR>=1.3.10
# Imath>=3.1.9
# imageio>=2.31.0
# imageio-freeimage>=1.0  # if using imageio for EXR

# Plate Stabilizer ORB backend uses opencv-python (already required above).
# Without cv2 the FFT translation fallback is used automatically.

# colour-science is NOT required; ColorSpaceConvert ships with built-in
# matrices and OETFs. Install only if you want extra space coverage in a
# future release.
# colour-science>=0.4.4