Add IP-Adapter install script and reference-image workflow docs

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

README.md

@@ -67,6 +67,8 @@ sudo systemctl status local-ai
 | `configure-storage.sh` | 239 | Storage/mount configuration helper. Run separately if you have a secondary drive for AI data. |
 | `kiwix_download.sh` | 198 | Downloads ZIM files (Wikipedia, Stack Overflow, etc.) for offline use. Run separately — files are large. |
 | `invokeai-import-lora.sh` | 85 | Copies a LoRA `.safetensors` file into InvokeAI's Docker model volume. |
+| `comfyui-import-lora.sh` | 97 | Copies a LoRA into ComfyUI and prints workflow setup instructions. |
+| `comfyui-install-ipadapter.sh` | 185 | Installs IP-Adapter nodes + models into ComfyUI for reference-image workflows (same face, different settings). |
 
 ### Which setup script should I use?
 
@@ -377,6 +379,60 @@ Switch between them in **Admin → Settings → Images → Import Workflow**. Th
 
 Mismatched architectures will produce errors or garbage output.
 
+### IP-Adapter: same face, different settings (reference image workflows)
+
+IP-Adapter lets you upload a reference photo and generate new images that preserve the face/subject while changing everything else — age, emotion, setting, art style. This is different from LoRAs (which bake in a trained style). IP-Adapter works from a single image with no training needed.
+
+#### What you can do
+
+| Task | How | Example prompt |
+|------|-----|----------------|
+| Different setting | Reference face + new scene | "same person, sitting in a cafe in Paris" |
+| Age up/down | Reference face + age prompt | "same person as an elderly man" or "same person as a child" |
+| Emotions | Reference face + emotion | "same person, laughing" or "same person, crying" |
+| Art style | Reference face + style | "same person, oil painting, renaissance style" |
+| Pose change | Reference face + pose | "same person, looking over shoulder, dramatic lighting" |
+
+#### Quick install
+
+```bash
+./comfyui-install-ipadapter.sh              # SDXL models (~2.5GB)
+./comfyui-install-ipadapter.sh --faceid     # + FaceID for stronger face lock
+./comfyui-install-ipadapter.sh --all        # SDXL + SD 1.5 models
+```
+
+Then restart ComfyUI: `docker restart comfyui`
+
+#### Basic workflow in ComfyUI
+
+1. Open `http://<ip>:8188`
+2. Add nodes: right-click → Add Node → ipadapter
+3. Wire up:
+   ```
+   [Load Checkpoint] → MODEL → [IPAdapter Apply] → [KSampler] → [VAE Decode] → [Save Image]
+                      → CLIP → [CLIP Text Encode] → positive →
+   [Load Image (your photo)] → [IPAdapter Unified Loader] → ipadapter →
+   ```
+4. **IPAdapter Unified Loader**: set preset to `PLUS FACE (portrait)`
+5. **IPAdapter Apply**: set weight 0.7–1.0 (higher = more faithful to reference)
+6. Text prompt: describe the new scene/emotion/age
+7. Click **Queue Prompt**
+
+#### Adjusting face fidelity
+
+| Weight | Effect |
+|--------|--------|
+| 0.5–0.6 | Loose reference — inspired by the face but not a match |
+| 0.7–0.8 | Good balance — recognizable face, creative freedom in scene |
+| 0.9–1.0 | Strong lock — very close to reference face |
+| FaceID preset | Strongest — uses face detection for identity lock |
+
+#### Important: ComfyUI only (not from Open WebUI chat)
+
+IP-Adapter workflows require uploading a reference image to ComfyUI. Open WebUI's image generation integration only sends text prompts — it can't attach reference images. For this use case, work directly in ComfyUI at `http://<ip>:8188`.
+
+For text-only image generation from Open WebUI chat, use [LoRA workflows](#using-loras-with-open-webui-workflow-per-style) instead.
+
 ### Setup: AUTOMATIC1111 (alternative)
 
 If you prefer AUTOMATIC1111 over ComfyUI:

comfyui-install-ipadapter.sh

@@ -0,0 +1,206 @@
+#!/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."