Claude
97561c0219
New script: comfyui-install-ipadapter.sh - Installs cubiq/ComfyUI_IPAdapter_plus custom nodes - Downloads CLIP Vision encoders and IP-Adapter models (SDXL/SD1.5) - Optional --faceid flag for stronger face identity lock - Skips already-downloaded files, pulls updates on re-run - Prints wiring diagram and example prompts after install README: - Add "IP-Adapter: same face, different settings" section with task table, install commands, workflow guide, weight tuning - Clarify IP-Adapter = ComfyUI direct (not from OWUI chat) - Add both new scripts to the file listing table https://claude.ai/code/session_01PtYTPherSJaxDEVPgF6Nxu
207 lines
10 KiB
Bash
Executable File
207 lines
10 KiB
Bash
Executable File
#!/usr/bin/env bash
|
||
# Install IP-Adapter custom nodes + models into ComfyUI's Docker container
|
||
# Enables: same face/different settings, age up/down, emotion changes, style transfer
|
||
#
|
||
# Usage:
|
||
# ./comfyui-install-ipadapter.sh — install for SDXL (recommended)
|
||
# ./comfyui-install-ipadapter.sh --sd15 — install for SD 1.5
|
||
# ./comfyui-install-ipadapter.sh --all — install both SDXL + SD 1.5
|
||
# ./comfyui-install-ipadapter.sh --faceid — also install FaceID (better face lock)
|
||
set -euo pipefail
|
||
|
||
RED='\033[0;31m'; GREEN='\033[0;32m'; YELLOW='\033[1;33m'
|
||
CYAN='\033[0;36m'; BOLD='\033[1m'; NC='\033[0m'
|
||
info() { echo -e "${CYAN}[..]${NC} $*"; }
|
||
ok() { echo -e "${GREEN}[OK]${NC} $*"; }
|
||
warn() { echo -e "${YELLOW}[!!]${NC} $*"; }
|
||
die() { echo -e "${RED}[XX]${NC} $*" >&2; exit 1; }
|
||
|
||
# ── parse args ──────────────────────────────────────────────────────────────
|
||
INSTALL_SD15=false
|
||
INSTALL_SDXL=true
|
||
INSTALL_FACEID=false
|
||
|
||
for arg in "$@"; do
|
||
case "$arg" in
|
||
--sd15) INSTALL_SD15=true; INSTALL_SDXL=false ;;
|
||
--all) INSTALL_SD15=true; INSTALL_SDXL=true ;;
|
||
--faceid) INSTALL_FACEID=true ;;
|
||
--help|-h)
|
||
echo -e "${BOLD}Usage:${NC} $0 [--sd15] [--all] [--faceid]"
|
||
echo ""
|
||
echo " Installs IP-Adapter custom nodes and models into ComfyUI."
|
||
echo " Enables reference-image workflows: same face in different"
|
||
echo " settings, age changes, emotions, style transfer."
|
||
echo ""
|
||
echo " Options:"
|
||
echo " --sd15 Install SD 1.5 models (instead of SDXL)"
|
||
echo " --all Install both SDXL + SD 1.5 models"
|
||
echo " --faceid Also install FaceID models (better face lock,"
|
||
echo " requires insightface — adds ~1GB)"
|
||
echo ""
|
||
echo " Default: SDXL models only (~2.5GB download)"
|
||
exit 0
|
||
;;
|
||
esac
|
||
done
|
||
|
||
# ── check container ─────────────────────────────────────────────────────────
|
||
if ! docker ps --format '{{.Names}}' 2>/dev/null | grep -q '^comfyui$'; then
|
||
if docker ps -a --format '{{.Names}}' 2>/dev/null | grep -q '^comfyui$'; then
|
||
warn "ComfyUI container is stopped. Starting it..."
|
||
docker start comfyui
|
||
sleep 5
|
||
else
|
||
die "ComfyUI container not found. Is the AI stack running?"
|
||
fi
|
||
fi
|
||
|
||
# ── helper: download into container ─────────────────────────────────────────
|
||
# Usage: dl_model <url> <container_path>
|
||
dl_model() {
|
||
local url="$1" dest="$2"
|
||
local filename; filename=$(basename "$dest")
|
||
if docker exec comfyui test -f "$dest" 2>/dev/null; then
|
||
ok "Already exists: $filename"
|
||
return 0
|
||
fi
|
||
local dir; dir=$(dirname "$dest")
|
||
docker exec comfyui mkdir -p "$dir"
|
||
info "Downloading $filename..."
|
||
if ! docker exec comfyui wget -q --show-progress -O "$dest" "$url" 2>&1; then
|
||
# wget --show-progress not always available
|
||
docker exec comfyui wget -q -O "$dest" "$url"
|
||
fi
|
||
ok "Downloaded $filename"
|
||
}
|
||
|
||
HF_IPA="https://huggingface.co/h94/IP-Adapter/resolve/main"
|
||
MODELS="/opt/ComfyUI/models"
|
||
|
||
# ── Step 1: Install custom nodes ────────────────────────────────────────────
|
||
echo ""
|
||
echo -e "${BOLD}━━━ IP-Adapter Installation for ComfyUI ━━━${NC}"
|
||
echo ""
|
||
|
||
info "Installing ComfyUI_IPAdapter_plus custom nodes..."
|
||
if docker exec comfyui test -d /opt/ComfyUI/custom_nodes/ComfyUI_IPAdapter_plus 2>/dev/null; then
|
||
info "Custom nodes already installed — pulling updates..."
|
||
docker exec comfyui bash -c "cd /opt/ComfyUI/custom_nodes/ComfyUI_IPAdapter_plus && git pull -q"
|
||
ok "Custom nodes updated"
|
||
else
|
||
docker exec comfyui bash -c "cd /opt/ComfyUI/custom_nodes && git clone --depth 1 https://github.com/cubiq/ComfyUI_IPAdapter_plus.git"
|
||
ok "Custom nodes installed"
|
||
fi
|
||
|
||
# Install Python dependencies if requirements.txt exists
|
||
if docker exec comfyui test -f /opt/ComfyUI/custom_nodes/ComfyUI_IPAdapter_plus/requirements.txt 2>/dev/null; then
|
||
info "Installing Python dependencies..."
|
||
docker exec comfyui pip install -q -r /opt/ComfyUI/custom_nodes/ComfyUI_IPAdapter_plus/requirements.txt 2>/dev/null || true
|
||
fi
|
||
|
||
# ── Step 2: CLIP Vision models (required by all variants) ───────────────────
|
||
echo ""
|
||
info "Downloading CLIP Vision encoders..."
|
||
|
||
dl_model \
|
||
"https://huggingface.co/h94/IP-Adapter/resolve/main/models/image_encoder/model.safetensors" \
|
||
"$MODELS/clip_vision/CLIP-ViT-H-14-laion2B-s32B-b79K.safetensors"
|
||
|
||
if $INSTALL_SDXL; then
|
||
dl_model \
|
||
"https://huggingface.co/h94/IP-Adapter/resolve/main/sdxl_models/image_encoder/model.safetensors" \
|
||
"$MODELS/clip_vision/CLIP-ViT-bigG-14-laion2B-39B-b160k.safetensors"
|
||
fi
|
||
|
||
# ── Step 3: IP-Adapter models ──────────────────────────────────────────────
|
||
echo ""
|
||
docker exec comfyui mkdir -p "$MODELS/ipadapter"
|
||
|
||
if $INSTALL_SDXL; then
|
||
info "Downloading SDXL IP-Adapter models..."
|
||
dl_model "$HF_IPA/sdxl_models/ip-adapter-plus_sdxl_vit-h.safetensors" \
|
||
"$MODELS/ipadapter/ip-adapter-plus_sdxl_vit-h.safetensors"
|
||
dl_model "$HF_IPA/sdxl_models/ip-adapter-plus-face_sdxl_vit-h.safetensors" \
|
||
"$MODELS/ipadapter/ip-adapter-plus-face_sdxl_vit-h.safetensors"
|
||
fi
|
||
|
||
if $INSTALL_SD15; then
|
||
info "Downloading SD 1.5 IP-Adapter models..."
|
||
dl_model "$HF_IPA/models/ip-adapter-plus_sd15.safetensors" \
|
||
"$MODELS/ipadapter/ip-adapter-plus_sd15.safetensors"
|
||
dl_model "$HF_IPA/models/ip-adapter-plus-face_sd15.safetensors" \
|
||
"$MODELS/ipadapter/ip-adapter-plus-face_sd15.safetensors"
|
||
fi
|
||
|
||
# ── Step 4 (optional): FaceID models ───────────────────────────────────────
|
||
if $INSTALL_FACEID; then
|
||
echo ""
|
||
info "Installing FaceID dependencies (insightface, onnxruntime)..."
|
||
docker exec comfyui pip install -q insightface onnxruntime 2>/dev/null \
|
||
|| warn "Could not install insightface — FaceID nodes may not work"
|
||
|
||
HF_FACEID="https://huggingface.co/h94/IP-Adapter-FaceID/resolve/main"
|
||
info "Downloading FaceID models..."
|
||
|
||
if $INSTALL_SDXL; then
|
||
dl_model "$HF_FACEID/ip-adapter-faceid-plusv2_sdxl.bin" \
|
||
"$MODELS/ipadapter/ip-adapter-faceid-plusv2_sdxl.bin"
|
||
fi
|
||
if $INSTALL_SD15; then
|
||
dl_model "$HF_FACEID/ip-adapter-faceid-plusv2_sd15.bin" \
|
||
"$MODELS/ipadapter/ip-adapter-faceid-plusv2_sd15.bin"
|
||
fi
|
||
|
||
# FaceID LoRAs (required for FaceID models)
|
||
docker exec comfyui mkdir -p "$MODELS/loras"
|
||
if $INSTALL_SDXL; then
|
||
dl_model "$HF_FACEID/ip-adapter-faceid-plusv2_sdxl_lora.safetensors" \
|
||
"$MODELS/loras/ip-adapter-faceid-plusv2_sdxl_lora.safetensors"
|
||
fi
|
||
if $INSTALL_SD15; then
|
||
dl_model "$HF_FACEID/ip-adapter-faceid-plusv2_sd15_lora.safetensors" \
|
||
"$MODELS/loras/ip-adapter-faceid-plusv2_sd15_lora.safetensors"
|
||
fi
|
||
fi
|
||
|
||
# ── Done ────────────────────────────────────────────────────────────────────
|
||
echo ""
|
||
echo -e "${GREEN}━━━ Installation complete! ━━━${NC}"
|
||
echo ""
|
||
echo -e "${BOLD}Restart ComfyUI to load new nodes:${NC}"
|
||
echo " docker restart comfyui"
|
||
echo ""
|
||
echo -e "${BOLD}Then open ComfyUI at http://localhost:8188 and try it:${NC}"
|
||
echo ""
|
||
echo " Basic reference image (style/scene transfer):"
|
||
echo " ┌──────────────────────────────────────────────────────────────────┐"
|
||
echo " │ [Load Checkpoint]──→[Load Image]──→[IPAdapter Unified Loader] │"
|
||
echo " │ │ │ │"
|
||
echo " │ ├── MODEL ──────────────→ [IPAdapter Apply] → [KSampler]│"
|
||
echo " │ └── CLIP → [CLIP Text Encode]──→ positive ──→ │"
|
||
echo " │ \"a castle at sunset\" │"
|
||
echo " └──────────────────────────────────────────────────────────────────┘"
|
||
echo ""
|
||
echo " 1. Add nodes: right-click → Add Node → ipadapter"
|
||
echo " 2. ${BOLD}IPAdapter Unified Loader${NC}: set preset to '${BOLD}PLUS FACE (portrait)${NC}'"
|
||
echo " 3. ${BOLD}Load Image${NC}: upload your reference photo"
|
||
echo " 4. ${BOLD}IPAdapter Apply${NC}: connect model + image, set weight 0.7–1.0"
|
||
echo " 5. Text prompt controls the new scene: \"elderly, sitting in cafe, smiling\""
|
||
echo ""
|
||
echo -e "${BOLD}What each preset does:${NC}"
|
||
echo " PLUS — general style/scene transfer"
|
||
echo " PLUS FACE — preserves face likeness (best for your use case)"
|
||
if $INSTALL_FACEID; then
|
||
echo " FACEID PLUSV2 — strongest face lock (uses insightface for detection)"
|
||
fi
|
||
echo ""
|
||
echo -e "${BOLD}Example prompts with a reference face:${NC}"
|
||
echo " • \"same person, elderly, wise expression, studio lighting\""
|
||
echo " • \"same person as a child, playing in a park, happy\""
|
||
echo " • \"same person, crying, dramatic lighting, black and white\""
|
||
echo " • \"same person, oil painting style, renaissance setting\""
|
||
echo ""
|
||
echo -e "${YELLOW}Note:${NC} This works directly in ComfyUI. Open WebUI's ComfyUI integration"
|
||
echo " only sends text prompts — it can't attach a reference image."
|
||
echo " For chat-based image gen (without reference images), use LoRAs instead."
|