Merge branch 'linux' of https://github.com/techjarves/Local-AI-Image-Generator into linux

# Conflicts:
#	scripts/serve.cjs

README.md

@@ -1,6 +1,6 @@
 # 🖼️ Local AI Image Generator
 
-### An easy, zero-setup Stable Diffusion GUI for Windows and Linux. Run GGUF & Safetensors models offline without Python configuration.
+### An easy, zero-setup Stable Diffusion GUI for Windows, Linux, and macOS. Run GGUF & Safetensors models offline without Python configuration.
 
 
 
@@ -22,7 +22,7 @@
 ---
 
 ## 📖 Overview
-**Local AI Image Generator** is a zero-configuration, portable desktop environment for running Stable Diffusion (Safetensors/GGUF/CKPT) offline on Windows and Linux. Double-clicking `start.bat` (Windows) or running `./start.sh` (Linux) automatically handles dependency setup, GPU backend matching, and launches a high-performance local web workspace.
+**Local AI Image Generator** is a zero-configuration, portable desktop environment for running Stable Diffusion (Safetensors/GGUF/CKPT) offline on Windows, Linux, and macOS. Double-clicking `start.bat` (Windows) or running `./start.sh` (Linux/macOS) automatically handles dependency setup, GPU backend matching, and launches a high-performance local web workspace.
 
 ---
 
@@ -40,11 +40,17 @@
 3. **Add Models:** Drop `.safetensors`, `.gguf`, or `.ckpt` weights into `app/models/` (or download them via the **Model Manager** tab in the UI).
 4. **Generate:** Open `http://localhost:1420` in your browser, select your model, and write a prompt.
 
+### macOS
+1. **Check compatibility:** The prebuilt macOS backend is for **Apple Silicon (M1 or newer)** and uses **Metal** GPU acceleration.
+2. **Launch:** Open Terminal in the project folder and run **`./start.sh`** (downloads portable Node.js and the pre-compiled Metal backend on first run).
+3. **Add Models:** Drop `.safetensors`, `.gguf`, or `.ckpt` weights into `app/models/` (or download them via the **Model Manager** tab in the UI).
+4. **Generate:** Open `http://localhost:1420` in your browser, select your model, and write a prompt.
+
 ---
 
 ## ✨ Features
 *   **100% Offline & Private:** Inference runs completely locally on your hardware.
-*   **Auto-Detected GPU Acceleration:** Configures **CUDA** for Nvidia cards, **ROCm** for AMD cards, and **Vulkan** for AMD/Intel/NVIDIA fallback.
+*   **Auto-Detected GPU Acceleration:** Configures **CUDA** for Nvidia cards, **ROCm** for AMD cards, **Vulkan** for AMD/Intel/NVIDIA fallback, and **Metal** for Apple Silicon Macs.
 *   **Zero System Footprint:** Node.js is sandboxed inside the folder. No global environment paths are altered.
 *   **Integrated Model Manager:** Paste a Hugging Face URL to download weights directly, or drag-and-drop local weight files to import them.
 *   **Real-time Telemetry:** Monitor RAM, VRAM, CPU, and GPU load directly in the UI.
@@ -56,16 +62,16 @@
 ```
 local-ai-image-generator/
 ├── start.bat                  # Main double-click entrypoint (Windows)
-├── start.sh                   # Main terminal entrypoint (Linux)
+├── start.sh                   # Main terminal entrypoint (Linux/macOS)
 ├── PLAN.md                    # Linux port implementation plan
 ├── LICENSE                    # MIT Open Source license
 ├── .gitignore
 ├── README.md                  
 ├── scripts/
 │   ├── setup.ps1              # Automated GPU-detect and environment installer (Windows)
-│   ├── setup.sh               # Automated GPU-detect and environment installer (Linux)
+│   ├── setup.sh               # Automated GPU-detect and environment installer (Linux/macOS)
 │   ├── reset.ps1              # Cleans runtime environments (Windows)
-│   ├── reset.sh               # Cleans runtime environments (Linux)
+│   ├── reset.sh               # Cleans runtime environments (Linux/macOS)
 │   └── serve.cjs              # UI web server and backend lifecycle manager
 └── app/
     ├── frontend/              # UI source code (Vite + React)
@@ -95,9 +101,17 @@ local-ai-image-generator/
 | **Intel Arc / integrated** | Vulkan | CPU | Cross-vendor Vulkan support. |
 | **Integrated / None** | CPU | — | Runs on logical CPU threads (slow). |
 
+### macOS
+
+| Hardware | Primary | Fallback | Notes |
+| :--- | :--- | :--- | :--- |
+| **Apple Silicon (M1 or newer)** | Metal | CPU | Uses the official Darwin arm64 stable-diffusion.cpp backend. |
+| **Intel Mac** | Source build required | CPU | Official prebuilt macOS backend is Apple Silicon only. |
+
 **System requirements:**
 - **glibc 2.38 or newer** is required for the prebuilt Linux backends (Ubuntu 24.04, Fedora 40+, etc.).
 - The setup script will warn you if your glibc is older. You can still run setup, but the prebuilt backends will not start.
+- **Apple Silicon (M1 or newer)** is required for the prebuilt macOS Metal backend.
 
 **Linux setup modes:**
 - **Default (`./start.sh`)**: Downloads CPU + Vulkan backends (~120–150 MB).
@@ -118,10 +132,11 @@ Typical generation times for an image with **20 steps** (e.g. 512x512 resolution
 ---
 
 ## 🛠️ Troubleshooting
-*   **Reset Environment:** If a build fails or you want to clear dependencies, run `scripts/reset.ps1` (Windows) or `scripts/reset.sh` (Linux). (This preserves your models and generated images).
+*   **Reset Environment:** If a build fails or you want to clear dependencies, run `scripts/reset.ps1` (Windows) or `scripts/reset.sh` (Linux/macOS). (This preserves your models and generated images).
 *   **Port Conflicts:** The frontend uses `1420` by default. The backend tries `8080` first, then automatically falls back to a free port if `8080` is already busy.
 *   **Linux backends fail to start with `GLIBC_2.38' not found`:** The prebuilt binaries require glibc 2.38+ (Ubuntu 24.04). Upgrade your distribution or build stable-diffusion.cpp from source (see below).
 *   **Linux ROCm not loading:** Make sure your AMD GPU and kernel are compatible with ROCm 7.13. The app will automatically fall back to Vulkan if ROCm cannot initialize.
+*   **Windows exits with code `3221225781`:** This is `0xC0000135`, which means Windows could not load a required backend DLL. For AMD/Intel Vulkan, update the GPU driver with Vulkan support, then rerun setup so `app/backend/win/vulkan/` is repaired. For NVIDIA CUDA, update the NVIDIA driver and rerun setup so CUDA runtime DLLs are restored.
 *   **Generation shows "server is not responding or crashed":** The backend process exited. Check the terminal where you ran `./start.sh` for the exact error (common causes are glibc mismatch, missing Vulkan drivers, or out-of-memory).
 
 ---
@@ -130,11 +145,14 @@ Typical generation times for an image with **20 steps** (e.g. 512x512 resolution
 
 If your distribution has an older glibc than 2.38, or you want a CUDA backend on Linux, you can build `stable-diffusion.cpp` directly on your machine. The resulting binary will be linked against your system's glibc and will not have the compatibility issues of the prebuilt releases.
 
+For macOS, the included `scripts/build_from_source.sh` builds the Metal backend and copies it to `app/backend/mac/sd`.
+
 ### Requirements
 - `git`, `cmake`, `make` (or `ninja`), and a C++17 compiler (`g++` / `clang++`).
 - For **CUDA**: the NVIDIA CUDA toolkit (`nvcc`) must be on your `PATH`.
 - For **Vulkan**: the Vulkan SDK / loader and a compatible driver.
 - For **ROCm**: AMD ROCm development libraries.
+- For **macOS Metal**: Apple Command Line Tools or Xcode.
 
 ### Build commands
 
@@ -157,8 +175,11 @@ cmake .. -DSD_VULKAN=ON -DSD_BUILD_SHARED_LIBS=ON -DCMAKE_BUILD_TYPE=Release
 # ROCm
 cmake .. -DSD_HIPBLAS=ON -DSD_BUILD_SHARED_LIBS=ON -DCMAKE_BUILD_TYPE=Release
 
+# macOS Metal
+cmake .. -DSD_METAL=ON -DSD_BUILD_SHARED_LIBS=ON -DCMAKE_BUILD_TYPE=Release
+
 # 3. Build
-cmake --build . --config Release -j$(nproc)
+cmake --build . --config Release -j$(getconf _NPROCESSORS_ONLN 2>/dev/null || sysctl -n hw.ncpu)
 
 # 4. Copy the binaries into this project
 cp bin/sd* /path/to/Local-AI-Image-Generator/app/backend/linux/<backend>/

app/frontend/package-lock.json

@@ -1554,9 +1554,9 @@
       }
     },
     "node_modules/electron-to-chromium": {
-      "version": "1.5.369",
-      "resolved": "https://registry.npmjs.org/electron-to-chromium/-/electron-to-chromium-1.5.369.tgz",
-      "integrity": "sha512-XM22K9FNaaCOvMMrBn1caIc8v0g6+pKt660ZbfQqUZvfil0hEzr8ZoiY7VcSLGM3L/x3rz5PqZrk+bKOOmVM9w==",
+      "version": "1.5.370",
+      "resolved": "https://registry.npmjs.org/electron-to-chromium/-/electron-to-chromium-1.5.370.tgz",
+      "integrity": "sha512-D5tSHJReAb/Kf3Hu9F/GO4lJuSWzEWHwvQ/kKSUP7pimNgvxkSKj+gUQhHpKKACwrin7rS3byU7IxreF56rl5g==",
       "dev": true,
       "license": "ISC"
     },

scripts/build_from_source.sh

@@ -1,7 +1,7 @@
 #!/usr/bin/env bash
 #
 # Local AI Image Generator - Compile backends from source
-# For systems with GLIBC < 2.38 (e.g. Ubuntu 22.04)
+# For Linux systems with GLIBC < 2.38 or macOS systems that need a local Metal build.
 #
 
 set -euo pipefail
@@ -9,8 +9,14 @@ set -euo pipefail
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 ROOT_DIR="$(dirname "$SCRIPT_DIR")"
 APP_DIR="$ROOT_DIR/app"
-BACKEND_DIR="$APP_DIR/backend/linux"
+PLATFORM="$(uname -s)"
+if [ "$PLATFORM" = "Darwin" ]; then
+    BACKEND_DIR="$APP_DIR/backend/mac"
+else
+    BACKEND_DIR="$APP_DIR/backend/linux"
+fi
 BUILD_DIR="$APP_DIR/tools/build-sd"
+JOBS="$(getconf _NPROCESSORS_ONLN 2>/dev/null || sysctl -n hw.ncpu 2>/dev/null || echo 4)"
 
 # Pinned release tag
 PINNED_TAG="master-685-19bdfe2"
@@ -35,12 +41,36 @@ git fetch origin
 git checkout -f "$PINNED_TAG"
 git submodule update --init --recursive
 
+if [ "$PLATFORM" = "Darwin" ]; then
+    echo ""
+    echo "=== Building macOS Metal Backend ==="
+    rm -rf build-metal && mkdir build-metal && cd build-metal
+    cmake .. -DSD_METAL=ON -DSD_BUILD_SHARED_LIBS=ON -DCMAKE_BUILD_TYPE=Release
+    cmake --build . --config Release -j"$JOBS"
+
+    echo "Copying macOS Metal backend..."
+    mkdir -p "$BACKEND_DIR"
+    if [ -f bin/sd-server ]; then
+        cp bin/sd-server "$BACKEND_DIR/sd"
+    elif [ -f bin/sd ]; then
+        cp bin/sd "$BACKEND_DIR/sd"
+    else
+        echo "ERROR: bin/sd-server or bin/sd was not found!"
+        exit 1
+    fi
+    find . -name "*.dylib" -exec cp {} "$BACKEND_DIR/" \; 2>/dev/null || true
+    chmod +x "$BACKEND_DIR/sd"
+    echo ""
+    echo "=== macOS Metal build completed successfully! ==="
+    exit 0
+fi
+
 # 2. Build CPU Backend
 echo ""
 echo "=== Building CPU Backend ==="
 rm -rf build-cpu && mkdir build-cpu && cd build-cpu
 cmake .. -DSD_BUILD_SHARED_LIBS=ON -DCMAKE_BUILD_TYPE=Release
-cmake --build . --config Release -j$(nproc)
+cmake --build . --config Release -j"$JOBS"
 
 echo "Copying CPU binaries..."
 mkdir -p "$BACKEND_DIR/cpu"
@@ -61,6 +91,10 @@ SO_PATH=$(find . -name "libstable-diffusion.so" | head -n 1)
 if [ -n "$SO_PATH" ]; then
     cp "$SO_PATH" "$BACKEND_DIR/cpu/"
     echo "Copied libstable-diffusion.so to CPU directory."
+    chmod +x "$BACKEND_DIR/cpu/sd-cpu" "$BACKEND_DIR/cpu/sd-server-cpu" 2>/dev/null || true
+    if [ -f "$BACKEND_DIR/cpu/sd-cli-cpu" ]; then
+        chmod +x "$BACKEND_DIR/cpu/sd-cli-cpu" 2>/dev/null || true
+    fi
 else
     echo "WARNING: libstable-diffusion.so not found for CPU build!"
 fi
@@ -71,7 +105,7 @@ echo ""
 echo "=== Building Vulkan Backend ==="
 if rm -rf build-vulkan && mkdir build-vulkan && cd build-vulkan && \
    cmake .. -DSD_VULKAN=ON -DSD_BUILD_SHARED_LIBS=ON -DCMAKE_BUILD_TYPE=Release && \
-   cmake --build . --config Release -j$(nproc); then
+   cmake --build . --config Release -j"$JOBS"; then
 
     echo "Copying Vulkan binaries..."
     mkdir -p "$BACKEND_DIR/vulkan"
@@ -94,6 +128,10 @@ if rm -rf build-vulkan && mkdir build-vulkan && cd build-vulkan && \
     else
         echo "WARNING: libstable-diffusion.so not found for Vulkan build!"
     fi
+    chmod +x "$BACKEND_DIR/vulkan/sd-vulkan" "$BACKEND_DIR/vulkan/sd-server-vulkan" 2>/dev/null || true
+    if [ -f "$BACKEND_DIR/vulkan/sd-cli-vulkan" ]; then
+        chmod +x "$BACKEND_DIR/vulkan/sd-cli-vulkan" 2>/dev/null || true
+    fi
 else
     echo "WARNING: Vulkan backend build failed. Bypassing Vulkan backend compilation..."
 fi
@@ -102,7 +140,7 @@ echo ""
 echo "=== Building CUDA Backend ==="
 rm -rf build-cuda && mkdir build-cuda && cd build-cuda
 cmake .. -DSD_CUDA=ON -DSD_BUILD_SHARED_LIBS=ON -DCMAKE_BUILD_TYPE=Release
-cmake --build . --config Release -j$(nproc)
+cmake --build . --config Release -j"$JOBS"
 
 echo "Copying CUDA binaries..."
 mkdir -p "$BACKEND_DIR/cuda"
@@ -122,6 +160,10 @@ SO_PATH_CUDA=$(find . -name "libstable-diffusion.so" | head -n 1)
 if [ -n "$SO_PATH_CUDA" ]; then
     cp "$SO_PATH_CUDA" "$BACKEND_DIR/cuda/"
     echo "Copied libstable-diffusion.so to CUDA directory."
+    chmod +x "$BACKEND_DIR/cuda/sd-cuda" "$BACKEND_DIR/cuda/sd-server-cuda" 2>/dev/null || true
+    if [ -f "$BACKEND_DIR/cuda/sd-cli-cuda" ]; then
+        chmod +x "$BACKEND_DIR/cuda/sd-cli-cuda" 2>/dev/null || true
+    fi
 else
     echo "WARNING: libstable-diffusion.so not found for CUDA build!"
 fi

scripts/reset.sh

@@ -1,6 +1,6 @@
 #!/usr/bin/env bash
 #
-# Local AI Image Generator - Linux Reset Script
+# Local AI Image Generator - Linux/macOS Reset Script
 # Resets portable app dependencies/builds while preserving user models and outputs.
 #
 

scripts/serve.cjs

@@ -28,10 +28,10 @@ const BACKEND_PATHS = {
   cuda: path.join(ROOT, "app", "backend", "win", "cuda", "sd-cuda.exe"),
   vulkan: path.join(ROOT, "app", "backend", "win", "vulkan", "sd-vulkan.exe"),
   mac: path.join(ROOT, "app", "backend", "mac", "sd"),
-  linuxCpu: path.join(ROOT, "app", "backend", "linux", "cpu", "sd-cpu"),
-  linuxVulkan: path.join(ROOT, "app", "backend", "linux", "vulkan", "sd-vulkan"),
-  linuxRocm: path.join(ROOT, "app", "backend", "linux", "rocm", "sd-rocm"),
-  linuxCuda: path.join(ROOT, "app", "backend", "linux", "cuda", "sd-cuda"),
+  linuxCpu: path.join(ROOT, "app", "backend", "linux", "cpu", "sd-server-cpu"),
+  linuxVulkan: path.join(ROOT, "app", "backend", "linux", "vulkan", "sd-server-vulkan"),
+  linuxRocm: path.join(ROOT, "app", "backend", "linux", "rocm", "sd-server-rocm"),
+  linuxCuda: path.join(ROOT, "app", "backend", "linux", "cuda", "sd-server-cuda"),
 };
 let BACKEND_PATH = "";
 const backendSupportsFlags = {};
@@ -189,6 +189,21 @@ function getGpuInfo() {
     }
   }
 
+  if (osPlatform === "darwin") {
+    try {
+      const output = execSync(
+        "system_profiler SPDisplaysDataType | awk -F': ' '/Chipset Model|Vendor/ {print $2; exit}'",
+        { encoding: "utf8", stdio: ["ignore", "pipe", "ignore"] },
+      ).trim();
+      if (output) {
+        cachedGpuInfo = { name: output };
+        return cachedGpuInfo;
+      }
+    } catch (_) {}
+    cachedGpuInfo = { name: "Apple Metal GPU" };
+    return cachedGpuInfo;
+  }
+
   cachedGpuInfo = { name: "Unavailable" };
   return cachedGpuInfo;
 }
@@ -589,8 +604,14 @@ function getBackendOptions() {
   const rocmInstalled = osPlatform === "linux" && fs.existsSync(BACKEND_PATHS.linuxRocm);
   const rocmAvailable = rocmInstalled && hasAmdGpu() && backendAccepts(BACKEND_PATHS.linuxRocm, "rocm");
   const cpuInstalled = osPlatform === "linux" && fs.existsSync(BACKEND_PATHS.linuxCpu);
+  const metalInstalled = osPlatform === "darwin" && fs.existsSync(BACKEND_PATHS.mac);
+  // Darwin release binaries are Metal builds. Treat an installed macOS backend
+  // as Metal-capable so the UI does not default to CPU if a probe flag changes
+  // upstream.
+  const metalAvailable = metalInstalled;
 
   const options = [{ id: "cpu", label: "CPU", available: true }];
+  if (metalAvailable) options.push({ id: "metal", label: "Metal GPU", available: true });
   if (vulkanAvailable) options.push({ id: "vulkan", label: "Vulkan GPU", available: true });
   if (rocmAvailable) options.push({ id: "rocm", label: "ROCm GPU (AMD)", available: true });
   if (cudaAvailable) options.push({ id: "cuda", label: "CUDA GPU", available: true });
@@ -605,9 +626,14 @@ function getBackendOptions() {
   if (rocmInstalled && !rocmAvailable) {
     unavailable.push({ id: "rocm", label: "ROCm GPU (AMD)", reason: "Installed, but ROCm backend validation failed." });
   }
+  if (metalInstalled && !metalAvailable) {
+    unavailable.push({ id: "metal", label: "Metal GPU", reason: "Installed, but Metal backend validation failed." });
+  }
 
   let defaultBackend = "cpu";
-  if (cudaAvailable) {
+  if (metalAvailable) {
+    defaultBackend = "metal";
+  } else if (cudaAvailable) {
     const gpuName = String(getGpuInfo().name).toLowerCase();
     const isGtxCard = gpuName.includes("gtx");
     if (isGtxCard && vulkanAvailable) {
@@ -627,6 +653,7 @@ function getBackendOptions() {
     cudaAvailable,
     vulkanAvailable,
     rocmAvailable,
+    metalAvailable,
     defaultBackendType: defaultBackend,
   };
   return cachedBackendOptions;
@@ -635,17 +662,22 @@ function getBackendOptions() {
 function backendAccepts(binaryPath, backendName) {
   if (!binaryPath || !fs.existsSync(binaryPath)) return false;
   try {
+    const cliBackendName = backendName === "metal" ? "metal0" : backendName;
     const probeArgs = [
-      "--backend", backendName,
-      "--params-backend", backendName,
+      "--backend", cliBackendName,
+      "--params-backend", cliBackendName,
       "--model", path.join(MODELS, "__backend_probe_missing__.safetensors"),
       "--listen-port", "18082",
     ];
     const spawnEnv = { ...process.env };
     if (osPlatform === "linux") {
-      const extraLibs = [path.dirname(binaryPath)];
+      const dir = path.dirname(binaryPath);
       const existing = spawnEnv.LD_LIBRARY_PATH || "";
-      spawnEnv.LD_LIBRARY_PATH = extraLibs.join(":") + (existing ? ":" + existing : "");
+      spawnEnv.LD_LIBRARY_PATH = dir + (existing ? ":" + existing : "");
+    } else if (osPlatform === "darwin") {
+      const dir = path.dirname(binaryPath);
+      const existing = spawnEnv.DYLD_LIBRARY_PATH || "";
+      spawnEnv.DYLD_LIBRARY_PATH = dir + (existing ? ":" + existing : "");
     }
     let result = spawnSync(binaryPath, probeArgs, { env: spawnEnv, encoding: "utf8", timeout: 5000 });
     let output = `${result.stdout || ""}\n${result.stderr || ""}`;
@@ -664,7 +696,7 @@ function backendAccepts(binaryPath, backendName) {
     }
 
     const lower = output.toLowerCase();
-    if (lower.includes("backend config failed") || output.includes(`backend '${backendName}' was not found`)) {
+    if (lower.includes("backend config failed") || output.includes(`backend '${backendName}' was not found`) || output.includes(`backend '${cliBackendName}' was not found`)) {
       return false;
     }
     // Reject binaries that fail at the dynamic linker / glibc level.
@@ -704,7 +736,11 @@ function selectBackendPath(useGpu, backendType = "auto") {
     if (fs.existsSync(BACKEND_PATHS.linuxCpu)) return BACKEND_PATHS.linuxCpu;
     return BACKEND_PATH;
   }
-  // macOS fallback
+  if (osPlatform === "darwin") {
+    if (fs.existsSync(BACKEND_PATHS.mac)) return BACKEND_PATHS.mac;
+    return BACKEND_PATH;
+  }
+  // generic fallback
   if (fs.existsSync(BACKEND_PATHS.mac)) return BACKEND_PATHS.mac;
   return BACKEND_PATH;
 }
@@ -722,6 +758,7 @@ function getBackendMode(backendPath, useGpu, backendType = "auto") {
   if (name.includes("cuda")) return "CUDA GPU";
   if (name.includes("rocm")) return "ROCm GPU";
   if (name.includes("vulkan")) return "Vulkan GPU";
+  if (osPlatform === "darwin" || backendType === "metal") return "Metal GPU";
   return "GPU";
 }
 
@@ -887,6 +924,11 @@ async function startBackend(settings = {}) {
       args.push("--backend", "rocm0", "--params-backend", "rocm0");
     }
     args.push("--rng", "cpu", "--sampler-rng", "cpu");
+  } else if (requestedBackend === "metal") {
+    if (supportsFlags) {
+      args.push("--backend", "metal0", "--params-backend", "metal0");
+    }
+    args.push("--rng", "cpu", "--sampler-rng", "cpu");
   }
 
   if (currentSettings.vaeTiling) {
@@ -914,6 +956,10 @@ async function startBackend(settings = {}) {
       const existing = spawnEnv.LD_LIBRARY_PATH || "";
       spawnEnv.LD_LIBRARY_PATH = extraLibs.join(":") + (existing ? ":" + existing : "");
     }
+  } else if (osPlatform === "darwin") {
+    const existing = spawnEnv.DYLD_LIBRARY_PATH || "";
+    const backendDir = path.dirname(BACKEND_PATHS.mac);
+    spawnEnv.DYLD_LIBRARY_PATH = backendDir + (existing ? ":" + existing : "");
   }
 
   console.log("  [backend] Starting:", path.basename(backendPath), args.join(" "));
@@ -1008,6 +1054,11 @@ async function startBackend(settings = {}) {
       backendLoadState.device = deviceMatch[1].trim();
       currentSettings.backendDevice = backendLoadState.device;
     }
+    const metalDeviceMatch = cleanOutput.match(/GPU name:\s*([^\r\n]+)/);
+    if (metalDeviceMatch) {
+      backendLoadState.device = metalDeviceMatch[1].trim();
+      currentSettings.backendDevice = backendLoadState.device;
+    }
     if (cleanOutput.includes("ggml_cuda_init")) {
       backendLoadState.backendMode = "CUDA GPU";
       currentSettings.backendMode = "CUDA GPU";
@@ -1020,6 +1071,10 @@ async function startBackend(settings = {}) {
       backendLoadState.backendMode = "ROCm GPU";
       currentSettings.backendMode = "ROCm GPU";
     }
+    if (cleanOutput.includes("ggml_metal")) {
+      backendLoadState.backendMode = "Metal GPU";
+      currentSettings.backendMode = "Metal GPU";
+    }
     if (cleanOutput.includes("[ERROR]")) {
       const nextError = describeBackendError(cleanOutput.trim(), currentSettings.model);
       const hasSpecificFileError = String(backendError || "").includes("incomplete or corrupted");
@@ -1035,7 +1090,7 @@ async function startBackend(settings = {}) {
     console.log("  [backend] exited with code", code);
     if (code !== null && code !== 0) {
       if (!backendError) {
-        backendError = `exited with code ${code}`;
+        backendError = describeBackendExitCode(code, currentSettings.backendBinary || BACKEND_PATH);
       }
     }
     backendLoadState.active = false;
@@ -1390,6 +1445,30 @@ function describeBackendError(rawError, modelPath) {
   return `${raw}\n\nThe backend could not create the model context. Common causes are a corrupt/incomplete model file, unsupported checkpoint type, or not enough free RAM/VRAM. Delete and re-download the model, then try CPU or Vulkan mode at 512x512.`;
 }
 
+function describeBackendExitCode(code, backendPath) {
+  const numericCode = Number(code);
+  if (osPlatform === "win32" && numericCode === 3221225781) {
+    const backendName = path.basename(backendPath || BACKEND_PATH || "backend");
+    const lowerBackend = backendName.toLowerCase();
+    const isVulkan = lowerBackend.includes("vulkan");
+    const isCuda = lowerBackend.includes("cuda");
+    const likelyMissing = isVulkan
+      ? "the Vulkan runtime/driver DLL, such as vulkan-1.dll"
+      : isCuda
+        ? "a CUDA runtime DLL or NVIDIA driver component"
+        : "a required backend DLL";
+    const driverHint = isVulkan
+      ? "Install or update the GPU vendor driver with Vulkan support, then run setup again so the Vulkan backend folder is repaired."
+      : isCuda
+        ? "Install or update the NVIDIA driver, then run setup again so the CUDA backend folder is repaired."
+        : "Update the GPU driver, then run setup again so the backend folder is repaired.";
+
+    return `exited with code ${code} (0xC0000135: required DLL not found).\n\nWindows could not start ${backendName} because ${likelyMissing} is missing or not loadable. ${driverHint}\n\nIf you are using an AMD/Intel GPU, update the AMD/Intel graphics driver first. If the GPU is too old for the current Vulkan backend, switch the backend to CPU.`;
+  }
+
+  return `exited with code ${code}`;
+}
+
 function getModelInfo(filename) {
   const safeFilename = path.basename(filename || "");
   const stats = fs.statSync(path.join(MODELS, safeFilename));
@@ -1830,7 +1909,7 @@ const server = http.createServer(async (req, res) => {
   });
 });
 
-server.listen(PORT_FRONTEND, "127.0.0.1", () => {
+server.listen(PORT_FRONTEND, "0.0.0.0", () => {
   console.log("");
   console.log("  ============================================================");
   console.log("   LOCAL AI IMAGE GENERATOR  |  Running");

scripts/setup.sh

@@ -1,6 +1,6 @@
 #!/usr/bin/env bash
 #
-# Local AI Image Generator - Linux Setup Script
+# Local AI Image Generator - Linux/macOS Setup Script
 # Self-contained: no apt/yum/pacman, no global Node.js install.
 #
 
@@ -11,18 +11,40 @@ ROOT_DIR="$(dirname "$SCRIPT_DIR")"
 APP_DIR="$ROOT_DIR/app"
 FRONTEND_DIR="$APP_DIR/frontend"
 TOOLS_DIR="$APP_DIR/tools"
-NODE_DIR="$TOOLS_DIR/node-linux"
+DIST_DIR="$APP_DIR/dist"
+PLATFORM="$(uname -s)"
+ARCH="$(uname -m)"
+
+if [[ "$PLATFORM" == "Darwin" ]]; then
+  PLATFORM_LABEL="macOS"
+  NODE_DIR="$TOOLS_DIR/node-mac"
+  BACKEND_DIR="$APP_DIR/backend/mac"
+else
+  PLATFORM_LABEL="Linux"
+  NODE_DIR="$TOOLS_DIR/node-linux"
+  BACKEND_DIR="$APP_DIR/backend/linux"
+fi
+
 NODE_BIN="$NODE_DIR/bin/node"
 NPM_BIN="$NODE_DIR/bin/npm"
-DIST_DIR="$APP_DIR/dist"
-BACKEND_DIR="$APP_DIR/backend/linux"
 
 # Release pins
 SD_RELEASE="master-685-19bdfe2"
 SD_SHORT_HASH="${SD_RELEASE##*-}"
 SD_BASE_URL="https://github.com/leejet/stable-diffusion.cpp/releases/download/$SD_RELEASE"
 NODE_VERSION="22.12.0"
-NODE_TARBALL="node-v${NODE_VERSION}-linux-x64.tar.xz"
+
+if [[ "$PLATFORM" == "Darwin" ]]; then
+  if [[ "$ARCH" == "arm64" ]]; then
+    NODE_PLATFORM_ARCH="darwin-arm64"
+  else
+    NODE_PLATFORM_ARCH="darwin-x64"
+  fi
+  NODE_TARBALL="node-v${NODE_VERSION}-${NODE_PLATFORM_ARCH}.tar.gz"
+else
+  NODE_PLATFORM_ARCH="linux-x64"
+  NODE_TARBALL="node-v${NODE_VERSION}-${NODE_PLATFORM_ARCH}.tar.xz"
+fi
 NODE_URL="https://nodejs.org/dist/v${NODE_VERSION}/$NODE_TARBALL"
 
 # Flags
@@ -36,7 +58,7 @@ print_header() {
   clear 2>/dev/null || true
   echo ""
   echo "  ============================================================"
-  echo "   LOCAL AI IMAGE GENERATOR  -  Linux First-Time Setup"
+  echo "   LOCAL AI IMAGE GENERATOR  -  $PLATFORM_LABEL First-Time Setup"
   echo "   100% Self-Contained  |  No System Install Required"
   echo "  ============================================================"
   echo ""
@@ -180,15 +202,39 @@ copy_binaries_from_extracted() {
   find "$extracted_dir" -type f -name "*.so" -exec cp {} "$dest_dir/" \; 2>/dev/null || true
 }
 
+copy_macos_backend_from_extracted() {
+  local extracted_dir="$1" dest_dir="$2"
+  local target="$dest_dir/sd"
+  local server_bin=""
+  local cli_bin=""
+
+  server_bin="$(find "$extracted_dir" -type f -name "sd-server" | head -n 1)"
+  cli_bin="$(find "$extracted_dir" -type f \( -name "sd" -o -name "sd-cli" \) | head -n 1)"
+
+  if [[ -n "$server_bin" ]]; then
+    cp "$server_bin" "$target"
+  elif [[ -n "$cli_bin" ]]; then
+    cp "$cli_bin" "$target"
+  else
+    print_fail "No sd-server, sd, or sd-cli binary was found in the macOS backend archive."
+    return 1
+  fi
+
+  find "$extracted_dir" -type f \( -name "*.dylib" -o -name "*.metallib" \) -exec cp {} "$dest_dir/" \; 2>/dev/null || true
+  chmod +x "$target" 2>/dev/null || true
+}
+
 # ════════════════════════════════════════════════════════════════════════════
 print_header
 
-check_glibc
+if [[ "$PLATFORM" == "Linux" ]]; then
+  check_glibc
+fi
 
 TOTAL_STEPS=4
 
 # ── Step 1: Portable Node.js ────────────────────────────────────────────────
-print_step 1 $TOTAL_STEPS "Setting up portable Node.js (app/tools/node-linux/)"
+print_step 1 $TOTAL_STEPS "Setting up portable Node.js ($NODE_DIR/)"
 
 if [[ -x "$NODE_BIN" && -x "$NPM_BIN" ]]; then
   VERSION=$("$NODE_BIN" --version)
@@ -201,7 +247,7 @@ else
   extract_tarxz "$NODE_TAR_PATH" "$TOOLS_DIR" "Node.js"
   rm -f "$NODE_TAR_PATH"
 
-  EXTRACTED_DIR="$(find "$TOOLS_DIR" -maxdepth 1 -type d -name 'node-v*-linux-x64' | head -n 1)"
+  EXTRACTED_DIR="$(find "$TOOLS_DIR" -maxdepth 1 -type d -name "node-v*-${NODE_PLATFORM_ARCH}" | head -n 1)"
   if [[ -d "$EXTRACTED_DIR" ]]; then
     rm -rf "$NODE_DIR"
     mv "$EXTRACTED_DIR" "$NODE_DIR"
@@ -217,14 +263,35 @@ else
 fi
 
 # ── Step 2: stable-diffusion.cpp Backends ───────────────────────────────────
-VENDOR="$(detect_gpu_vendor)"
-print_step 2 $TOTAL_STEPS "Detecting GPU vendor: ${VENDOR:-none}"
-
 mkdir -p "$BACKEND_DIR"
 
+if [[ "$PLATFORM" == "Darwin" ]]; then
+  print_step 2 $TOTAL_STEPS "Setting up stable-diffusion.cpp Metal backend (app/backend/mac/)"
+  if [[ "$ARCH" != "arm64" ]]; then
+    print_fail "The official macOS backend binary is Apple Silicon only (arm64)."
+    print_info "Intel Macs need a local source build with Metal/OpenBLAS and a matching app/backend/mac/sd binary."
+    exit 1
+  fi
+
+  MAC_BACKEND="$BACKEND_DIR/sd"
+  if [[ -x "$MAC_BACKEND" ]]; then
+    print_ok "macOS Metal backend already ready."
+  else
+    MAC_ZIP="$TOOLS_DIR/sd-mac-metal.zip"
+    download_file "$SD_BASE_URL/sd-master-${SD_SHORT_HASH}-bin-Darwin-macOS-15.7.7-arm64.zip" "$MAC_ZIP" "stable-diffusion.cpp Metal Backend (macOS arm64)"
+    extract_zip "$MAC_ZIP" "$BACKEND_DIR/extracted" "macOS Metal Backend"
+    rm -f "$MAC_ZIP"
+    copy_macos_backend_from_extracted "$BACKEND_DIR/extracted" "$BACKEND_DIR"
+    rm -rf "$BACKEND_DIR/extracted"
+    print_ok "macOS Metal backend installed."
+  fi
+else
+  VENDOR="$(detect_gpu_vendor)"
+  print_step 2 $TOTAL_STEPS "Detecting GPU vendor: ${VENDOR:-none}"
+
 # CPU backend (always)
 CPU_BACKEND_DIR="$BACKEND_DIR/cpu"
-if [[ ! -f "$CPU_BACKEND_DIR/sd-cpu" ]]; then
+if [[ ! -f "$CPU_BACKEND_DIR/sd-cpu" || ! -f "$CPU_BACKEND_DIR/sd-server-cpu" ]]; then
   mkdir -p "$CPU_BACKEND_DIR"
   CPU_ZIP="$TOOLS_DIR/sd-cpu.zip"
   download_file "$SD_BASE_URL/sd-master-${SD_SHORT_HASH}-bin-Linux-Ubuntu-24.04-x86_64.zip" "$CPU_ZIP" "stable-diffusion.cpp CPU Backend (Linux x86_64)"
@@ -232,15 +299,15 @@ if [[ ! -f "$CPU_BACKEND_DIR/sd-cpu" ]]; then
   rm -f "$CPU_ZIP"
   copy_binaries_from_extracted "$CPU_BACKEND_DIR/extracted" "$CPU_BACKEND_DIR" "sd-cpu" "sd-server-cpu"
   rm -rf "$CPU_BACKEND_DIR/extracted"
-  chmod +x "$CPU_BACKEND_DIR/sd-cpu" 2>/dev/null || true
   print_ok "CPU backend installed."
 else
   print_ok "CPU backend already ready."
 fi
+chmod +x "$CPU_BACKEND_DIR/sd-cpu" "$CPU_BACKEND_DIR/sd-server-cpu" 2>/dev/null || true
 
 # Vulkan backend (always - cross-vendor GPU fallback)
 VULKAN_BACKEND_DIR="$BACKEND_DIR/vulkan"
-if [[ ! -f "$VULKAN_BACKEND_DIR/sd-vulkan" ]]; then
+if [[ ! -f "$VULKAN_BACKEND_DIR/sd-vulkan" || ! -f "$VULKAN_BACKEND_DIR/sd-server-vulkan" ]]; then
   mkdir -p "$VULKAN_BACKEND_DIR"
   VULKAN_ZIP="$TOOLS_DIR/sd-vulkan.zip"
   download_file "$SD_BASE_URL/sd-master-${SD_SHORT_HASH}-bin-Linux-Ubuntu-24.04-x86_64-vulkan.zip" "$VULKAN_ZIP" "stable-diffusion.cpp Vulkan Backend (Linux x86_64)"
@@ -248,16 +315,16 @@ if [[ ! -f "$VULKAN_BACKEND_DIR/sd-vulkan" ]]; then
   rm -f "$VULKAN_ZIP"
   copy_binaries_from_extracted "$VULKAN_BACKEND_DIR/extracted" "$VULKAN_BACKEND_DIR" "sd-vulkan" "sd-server-vulkan"
   rm -rf "$VULKAN_BACKEND_DIR/extracted"
-  chmod +x "$VULKAN_BACKEND_DIR/sd-vulkan" 2>/dev/null || true
   print_ok "Vulkan backend installed."
 else
   print_ok "Vulkan backend already ready."
 fi
+chmod +x "$VULKAN_BACKEND_DIR/sd-vulkan" "$VULKAN_BACKEND_DIR/sd-server-vulkan" 2>/dev/null || true
 
 # ROCm backend (optional --max-perf, or auto-detected AMD)
 ROCM_BACKEND_DIR="$BACKEND_DIR/rocm"
 if [[ $MAX_PERF -eq 1 ]] && [[ "$VENDOR" == "amd" || "$VENDOR" == "" ]]; then
-  if [[ ! -f "$ROCM_BACKEND_DIR/sd-rocm" ]]; then
+  if [[ ! -f "$ROCM_BACKEND_DIR/sd-rocm" || ! -f "$ROCM_BACKEND_DIR/sd-server-rocm" ]]; then
     mkdir -p "$ROCM_BACKEND_DIR"
     ROCM_ZIP="$TOOLS_DIR/sd-rocm.zip"
     print_warn "ROCm backend is ~1.2 GB. This may take a while..."
@@ -266,11 +333,11 @@ if [[ $MAX_PERF -eq 1 ]] && [[ "$VENDOR" == "amd" || "$VENDOR" == "" ]]; then
     rm -f "$ROCM_ZIP"
     copy_binaries_from_extracted "$ROCM_BACKEND_DIR/extracted" "$ROCM_BACKEND_DIR" "sd-rocm" "sd-server-rocm"
     rm -rf "$ROCM_BACKEND_DIR/extracted"
-    chmod +x "$ROCM_BACKEND_DIR/sd-rocm" 2>/dev/null || true
     print_ok "ROCm backend installed."
   else
     print_ok "ROCm backend already ready."
   fi
+  chmod +x "$ROCM_BACKEND_DIR/sd-rocm" "$ROCM_BACKEND_DIR/sd-server-rocm" 2>/dev/null || true
 fi
 
 # CUDA backend on Linux is intentionally disabled.
@@ -284,6 +351,7 @@ if [[ $MAX_PERF -eq 1 ]] && [[ "$VENDOR" == "nvidia" ]]; then
   print_info "Linux CUDA backend is disabled pending a reliable upstream binary."
   print_info "NVIDIA GPUs on Linux will use the Vulkan backend instead."
 fi
+fi
 
 # ── Step 3: npm install ─────────────────────────────────────────────────────
 print_step 3 $TOTAL_STEPS "Installing frontend dependencies (app/frontend/)"
@@ -320,7 +388,7 @@ echo "   Setup complete! Run ./start.sh to launch."
 echo "  ============================================================"
 echo ""
 
-if [[ $MAX_PERF -eq 0 ]] && [[ "$VENDOR" == "nvidia" || "$VENDOR" == "amd" ]]; then
+if [[ "$PLATFORM" == "Linux" && $MAX_PERF -eq 0 ]] && [[ "$VENDOR" == "nvidia" || "$VENDOR" == "amd" ]]; then
   echo "  Tip: For maximum GPU performance, re-run with:"
   echo "       ./scripts/setup.sh --max-perf"
   echo ""

start.sh

@@ -1,15 +1,25 @@
 #!/usr/bin/env bash
 #
-# Local AI Image Generator - Linux Launcher
+# Local AI Image Generator - Linux/macOS Launcher
 # Double-click or run: ./start.sh
-# Use --max-perf to enable ROCm/CUDA backend downloads on first setup.
+# Use --max-perf to enable ROCm backend downloads on Linux first setup.
 #
 
 set -euo pipefail
 
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 APP_DIR="$SCRIPT_DIR/app"
-NODE_DIR="$APP_DIR/tools/node-linux"
+PLATFORM="$(uname -s)"
+if [[ "$PLATFORM" == "Darwin" ]]; then
+  NODE_DIR="$APP_DIR/tools/node-mac"
+  BACKEND_PATH="$APP_DIR/backend/mac/sd"
+  PLATFORM_LABEL="macOS"
+else
+  NODE_DIR="$APP_DIR/tools/node-linux"
+  BACKEND_PATH="$APP_DIR/backend/linux/vulkan/sd-vulkan"
+  CPU_BACKEND_PATH="$APP_DIR/backend/linux/cpu/sd-cpu"
+  PLATFORM_LABEL="Linux"
+fi
 NODE_BIN="$NODE_DIR/bin/node"
 DIST_INDEX="$APP_DIR/dist/index.html"
 SETUP_SCRIPT="$SCRIPT_DIR/scripts/setup.sh"
@@ -38,15 +48,23 @@ if [[ ! -f "$DIST_INDEX" ]]; then
   SETUP_REASON="Frontend build is missing."
 fi
 
-# At minimum we need CPU or Vulkan backend on Linux
-if [[ ! -f "$APP_DIR/backend/linux/cpu/sd-cpu" && ! -f "$APP_DIR/backend/linux/vulkan/sd-vulkan" ]]; then
-  SETUP_REASON="No Linux backend binary is installed."
+if [[ "$PLATFORM" == "Darwin" ]]; then
+  if [[ ! -x "$BACKEND_PATH" ]]; then
+    SETUP_REASON="No macOS Metal backend binary is installed."
+  fi
+else
+  # At minimum we need CPU or Vulkan backend on Linux, and both CLI and server binaries must be executable
+  CPU_SERVER_PATH="$APP_DIR/backend/linux/cpu/sd-server-cpu"
+  VULKAN_SERVER_PATH="$APP_DIR/backend/linux/vulkan/sd-server-vulkan"
+  if [[ ! -x "$CPU_BACKEND_PATH" || ! -x "$CPU_SERVER_PATH" ]] && [[ ! -x "$BACKEND_PATH" || ! -x "$VULKAN_SERVER_PATH" ]]; then
+    SETUP_REASON="Linux backend binaries are missing or not executable."
+  fi
 fi
 
 if [[ -n "$SETUP_REASON" ]]; then
   echo ""
   echo "  ============================================================"
-  echo "   LOCAL AI IMAGE GENERATOR  |  $SETUP_MODE"
+  echo "   LOCAL AI IMAGE GENERATOR  |  $PLATFORM_LABEL $SETUP_MODE"
   echo "  ============================================================"
   echo ""
   if [[ "$SETUP_MODE" == "First-Time Setup" ]]; then
@@ -98,7 +116,10 @@ SERVER_PID=$!
 sleep 2
 
 # Open browser
-if command -v xdg-open >/dev/null 2>&1; then
+if [[ "$PLATFORM" == "Darwin" ]] && command -v open >/dev/null 2>&1; then
+  echo "  Opening browser at http://localhost:${FRONTEND_PORT}"
+  open "http://localhost:${FRONTEND_PORT}" >/dev/null 2>&1 &
+elif command -v xdg-open >/dev/null 2>&1; then
   echo "  Opening browser at http://localhost:${FRONTEND_PORT}"
   xdg-open "http://localhost:${FRONTEND_PORT}" >/dev/null 2>&1 &
 else