Publish canonical Surface setup and licensing documentation

Browse files

Files changed (4) hide show

README.md +78 -113
install_motionsmith_surface.bat +324 -0
motionsmith_surface.zip +2 -2
motionsmith_surface_backend_win64_0.1.0.zip.sha256 +1 -0

README.md CHANGED Viewed

@@ -1,113 +1,78 @@
-# MotionSmith Surface for Blender
-![MotionSmith Surface](/Serqan/MotionSmith-Runtime/resolve/main/blender/MotionSmith-Surface/hero.png)
-**Free AI PBR texturing and material generation inside Blender.**
-MotionSmith Surface connects Blender to a local ComfyUI backend. Generate textures for a selected mesh, or convert a reference image into a PBR material. The add-on is free; the included tools and separately downloaded models retain their own licenses.
-## Download status
-The Windows backend and add-on archives are prepared. **Upload is pending; the add-on and backend ZIPs are not available in this folder yet.** Download links will be added when the files are available.
-| Package | Contents | Approximate size |
-| --- | --- | --- |
-| `motionsmith_surface.zip` | Blender add-on, workflows, icons and live-progress dependency | 3.1 MB |
-| `motionsmith_surface_backend_win64_0.1.0.zip` | ComfyUI, required custom nodes, Python and runtime dependencies; **no model weights** | 4.2 GB ZIP / 8.7 GB extracted |
-Model downloads require additional disk space. The backend does not include personal input/output files or links to the developer's Python/model directories.
-## Requirements
-- **Windows 64-bit** and an NVIDIA GPU supported by the bundled CUDA-enabled PyTorch build.
-- **Blender 5.0 or newer** according to the add-on manifest; tested with Blender 5.2.2 LTS.
-- GPU memory requirements depend on the model, resolution and workflow. The development system uses an RTX 5070 Ti with 16 GB VRAM; this is a tested configuration, not a verified minimum.
-The prepared backend contains **ComfyUI 0.27.0**, Frontend **1.45.20**, Python **3.12.10** and PyTorch **2.8.0+cu128**. Its custom nodes are ComfyUI-UltraTex, UltraTex Modular, ComfyUI-GGUF and ComfyUI-Chord. BiRefNet background-removal nodes are provided by ComfyUI core.
-## Installation
-Once the archives are available:
-1. Extract the backend ZIP to a writable location. It contains a `comfyui` folder with its own Python runtime; no separate Python or pip installation is required.
-2. In Blender, open **Edit > Preferences > Add-ons > Install from Disk...**, select `motionsmith_surface.zip`, and enable **MotionSmith Surface**.
-3. In the add-on's **Preferences > Backend**, select the extracted `comfyui` folder. The Python executable path is filled automatically.
-4. Open **Preferences > Models**. Use the download buttons and save each file to the displayed folder and filename. Refresh the installed model list after copying the files.
-5. Open **3D Viewport > Sidebar (N) > Surface** and click **Start Server**. The default local address is `http://127.0.0.1:8188`.
-**The backend is self-contained; the models are downloaded separately.** A one-click backend downloader inside Blender is not implemented yet.
-## Models
-Paths below are relative to the backend's `comfyui/models` folder. Follow the model publisher's access and license requirements.
-| Used by | Download | Save as |
-| --- | --- | --- |
-| Texture: BASE diffusion model | [FLUX.2 Klein BASE 9B GGUF Q4_0](https://huggingface.co/unsloth/FLUX.2-klein-base-9B-GGUF/blob/main/flux-2-klein-base-9b-Q4_0.gguf) | `diffusion_models/flux-2-klein-base-9b-Q4_0.gguf` |
-| Texture: text encoder | [Qwen3 8B FP8 mixed](https://huggingface.co/Comfy-Org/flux2-klein-9B/blob/main/split_files/text_encoders/qwen_3_8b_fp8mixed.safetensors) | `text_encoders/qwen_3_8b_fp8mixed.safetensors` |
-| Texture: VAE | [FLUX.2 VAE](https://huggingface.co/Comfy-Org/flux2-dev/blob/main/split_files/vae/flux2-vae.safetensors) | `vae/flux2-vae.safetensors` |
-| Texture: albedo LoRA | [UltraTex albedo LoRA](https://www.modelscope.ai/models/Yibo-Zhang/UltraTex/resolve/master/flux2/lora/dit_lora.safetensors?view=false) | `loras/ultratex_flux2.safetensors` |
-| Texture: metallic/roughness LoRA | [UltraTex MR LoRA](https://www.modelscope.ai/models/Yibo-Zhang/UltraTex/resolve/master/flux2_mr/lora/dit_lora.safetensors?view=false) | `loras/ultratex_flux2_mr.safetensors` |
-| Texture: decoder | [UltraTex FLUX.2 decoder](https://www.modelscope.ai/models/Yibo-Zhang/UltraTex/resolve/master/flux2/decoder.pt?view=false) | `ultratex/ultratex_flux2_decoder.pt` |
-| Texture: background removal | [BiRefNet](https://huggingface.co/Comfy-Org/BiRefNet/blob/main/background_removal/birefnet.safetensors) | `background_removal/birefnet.safetensors` |
-| PBR Material | [Ubisoft Chord](https://huggingface.co/Ubisoft/ubisoft-laforge-chord/blob/main/chord_v1.safetensors) | `checkpoints/SD/chord_v1.safetensors` |
-**Rename the two UltraTex LoRA downloads and the decoder to the filenames in the table.** Both LoRA source files are named `dit_lora.safetensors`, but they are different models.
-UltraTex requires the **BASE** diffusion model. The distilled Klein 9B model is not a substitute. For the **PBR Material** page alone, only the Chord checkpoint is needed.
-## Texture
-Select a mesh in Object Mode, choose a workflow, and provide image and/or text guidance:
-- **Image Only:** uses a reference file, or a front-camera capture if no file is selected. Positive and negative prompts are not sent.
-- **Prompt + Image:** combines the reference with the positive prompt. Presets are optional; review any prompt already saved in your scene.
-- **Prompt Only:** uses text and mesh geometry without an appearance-reference image.
-Available workflows include 6 Views, 10 Views with a second refinement pass, Manual 10 Views and Low VRAM GGUF. Manual 10 Views uses its own camera/image inputs.
-**Generate Texture** sends the job to ComfyUI and applies the returned textures to the original mesh. Existing UVs can be retained, or a generated UV layout can be transferred back. Generated UV transfer requires matching geometry; topology-changing modifiers require care.
-Multi-view generation interprets the reference; it is not an exact image projection or a guarantee of matching every detail.
-## PBR Material
-Choose an image and click **Generate PBR Material**. Chord produces Base Color, Normal, Roughness, Metallic and Height maps.
-- If a UV-mapped mesh is selected in Object Mode, the material is applied to its active material slot.
-- Otherwise, a standalone material is created in Blender.
-- Base Color, Normal, Roughness and Metallic are connected to the shader. Height is included as a texture node but is **not automatically connected to displacement**.
-- This workflow uses the mesh's existing UV layout; it does not perform mesh-specific projection or UV baking.
-## Progress and cancellation
-The panel shows the current execution stage. Where ComfyUI reports step progress, it also shows the step count, a progress bar and an estimated remaining time **for that stage**, not the entire job. Stages without measurable progress do not receive a fabricated ETA.
-**Cancel** requests cancellation of the current job and stops automatic application of its result. **Check / Apply Last Result** can recover a completed result from the server history.
-## Validation status
-The prepared model-free backend was extracted to a separate directory and checked with its own Python runtime. Dependency imports, required node registration and the web interface passed. These startup checks are separate from full inference and visual-quality acceptance on a user's machine.
-## Licenses and credits
-- **MotionSmith Surface add-on:** GPL-3.0-or-later, distributed free of charge.
-- **ComfyUI and bundled dependencies:** their respective licenses; license files are retained in the backend package.
-- **UltraTex:** [official project](https://github.com/yiboz2001/UltraTex) and [ComfyUI integration](https://github.com/visualbruno/ComfyUI-UltraTex). Base models and model weights have their own terms.
-- **Chord:** [Ubisoft ComfyUI-Chord](https://github.com/ubisoft/ComfyUI-Chord), supplied under the **Ubisoft Machine Learning License (Research-Only - Copyleft)**. Free distribution of this add-on does not remove those restrictions.
-## Other MotionSmith Products
-Explore the [MotionSmith product family](https://motionsmithai.blogspot.com/):
-- **[MotionSmith AI V1](https://motionsmithai.blogspot.com/p/motionsmith-v1.html)** — Free Unreal Engine animation studio with text-to-motion generation, clip editing and retargeting.
-- **[MotionSmith AI Pro V2](https://motionsmithai.blogspot.com/p/motionsmith-pro-v2.html)** — Unreal Engine cinematic animation tools integrated with Level Sequencer.
-- **[MotionSmith Nexus](https://motionsmithai.blogspot.com/p/motionsmith-nexus.html)** — AI agent hub for Unreal Engine editor tools and workflow automation. **Coming soon.**
-- **[MotionSmith Animate for Blender](https://motionsmithai.blogspot.com/p/motionsmith-animate.html)** — Text-to-motion, rigging, retargeting and animation tools for Blender 5.2 LTS. **Coming soon.**
-- **[MotionSmith Bridge](https://motionsmithai.blogspot.com/p/motionsmith-bridge.html)** — A planned live workflow link between Blender and Unreal Engine. **Coming soon.**
-- **[MotionSmith Forge](https://motionsmithai.blogspot.com/p/motionsmith-forge.html)** — AI 3D model generation. **In development.**
-- **[MotionSmith Face](https://motionsmithai.blogspot.com/p/motionsmith-face.html)** — Facial animation tools. **In development.**
----
-**Created by Sertan Koç — OneManStudio.**

+---
+license: other
+license_name: mixed-component-licenses
+license_link: https://huggingface.co/Serqan/MotionSmith-Surface-Backend#licensing
+tags:
+  - blender
+  - comfyui
+  - pbr
+  - texturing
+  - runtime
+---
+# MotionSmith Surface — Windows Backend
+![MotionSmith Surface](https://huggingface.co/Serqan/MotionSmith-Surface-Backend/resolve/main/hero.png)
+**Canonical backend distribution for MotionSmith Surface**, the free Blender add-on for mesh texturing and image-to-PBR materials.
+Created by **Sertan Koç — OneManStudio**.
+This is a downloadable Windows runtime package, not an inference endpoint or a model checkpoint. It is separate from the [Unreal Engine MotionSmith Runtime](https://huggingface.co/Serqan/MotionSmith-Runtime).
+[Add-on source](https://github.com/webportalim/MotionSmith-Surface) · [Product page](https://motionsmithai.blogspot.com/p/motionsmith-surface.html) · [Documentation](https://motionsmithai.blogspot.com/p/motionsmith-surface-docs.html) · [Showcase](https://huggingface.co/spaces/Serqan/MotionSmith-AI-Showcase)
+## Install
+1. [Download the Blender add-on](https://huggingface.co/Serqan/MotionSmith-Surface-Backend/resolve/main/motionsmith_surface.zip?download=true). Install the ZIP through Blender Preferences → Add-ons → Install from Disk.
+2. Enable MotionSmith Surface and click **Install** in its preferences.
+3. The setup window searches local fixed disks for ComfyUI and shared model folders. It checks `extra_model_paths.yaml` and validates candidate weights by size and SHA-256. Compatible existing backends are reused; otherwise a separate Surface backend is installed.
+4. Missing files are downloaded automatically. Interrupted downloads can resume. Verified weights are hard-linked where possible or copied locally across disks.
+5. Enter the final ComfyUI Directory and Python Executable shown by setup in the add-on's Backend preferences. Save Preferences, then start the server in **N → Surface**.
+The [standalone BAT installer](https://huggingface.co/Serqan/MotionSmith-Surface-Backend/resolve/main/install_motionsmith_surface.bat?download=true) runs the same setup without opening Blender first.
+## Downloads
+| File | Purpose |
+| --- | --- |
+| [motionsmith_surface.zip](https://huggingface.co/Serqan/MotionSmith-Surface-Backend/resolve/main/motionsmith_surface.zip?download=true) | Blender add-on, including the automatic installer |
+| [install_motionsmith_surface.bat](https://huggingface.co/Serqan/MotionSmith-Surface-Backend/resolve/main/install_motionsmith_surface.bat?download=true) | Standalone automatic backend/model setup |
+| [motionsmith_surface_backend_win64_0.1.0.zip](https://huggingface.co/Serqan/MotionSmith-Surface-Backend/resolve/main/motionsmith_surface_backend_win64_0.1.0.zip?download=true) | Model-free Windows runtime; 4,211,074,697 bytes |
+| [Backend SHA-256](https://huggingface.co/Serqan/MotionSmith-Surface-Backend/resolve/main/motionsmith_surface_backend_win64_0.1.0.zip.sha256) | Checksum for the runtime archive |
+Backend SHA-256: `d04c5edcedde213d99aea5b1e68e10f1814161c14b209048f977b93daabbac11`.
+The full download is approximately **21.5 GiB** when no backend or models are present. Allow at least **35 GiB free disk space** for a fresh installation. Model weights are not inside the backend ZIP.
+## Workflows
+- **Texture:** select a mesh; use text and/or an image reference to generate views, bake UV textures and assign a material. Presets are optional.
+- **PBR Material:** use one image to estimate Base Color, Normal, Roughness, Metallic and Height. A selected UV-mapped mesh in Object Mode receives the material in its active slot; otherwise the material is created for manual assignment. Height is not connected to displacement automatically.
+- Both pages provide cancellation, current-stage progress where available, and recovery of the last completed job.
+## Runtime contents and requirements
+Windows 64-bit, Blender 5.0+ (tested with 5.2), and a compatible NVIDIA CUDA GPU. VRAM use depends on the model, workflow and resolution.
+The package includes ComfyUI 0.27.0, Python 3.12.10, PyTorch 2.8.0 + CUDA 12.8, UltraTex, modular UltraTex, Chord and GGUF node packages. No personal input/output files or model weights are included.
+## Model downloads and access
+Setup obtains weights from their publishers and saves the filenames required by the add-on. Chord can require Hugging Face sign-in, acceptance of the model terms and a Read token. Setup requests the token through hidden input without writing it to disk. Chord can be skipped while finishing Texture setup.
+## Licensing
+This repository does **not** apply a single license to every bundled component.
+- MotionSmith Surface add-on: GPL-3.0-or-later, as declared in its manifest.
+- ComfyUI: GPL-3.0; included runtime dependencies retain their own licenses and notices.
+- [ComfyUI-UltraTex](https://github.com/visualbruno/ComfyUI-UltraTex): MIT; upstream work by Yibo Zhang.
+- [UltraTex modular nodes](https://github.com/Mstafa-awad/UltraTex-ComfyUI-nodes): MIT; includes its upstream license notices.
+- [ComfyUI-GGUF](https://github.com/city96/ComfyUI-GGUF): Apache-2.0.
+- [ComfyUI-Chord](https://github.com/ubisoft/ComfyUI-Chord) **code and Chord weights**: Ubisoft Machine Learning License (Research-Only — Copyleft). Commercial use of those licensed materials is prohibited by that license. Its license and notices are retained inside the backend ZIP.
+- Separately downloaded FLUX, Qwen, BiRefNet and other weights retain their publishers' terms. Free availability does not override those terms.
+The four original Surface distribution files were copied from `Serqan/MotionSmith-Runtime/blender/MotionSmith-Surface` and verified by relative path, size and hash before updating the installer and this documentation. The original Runtime repository paths remain available for old releases; no files were moved or deleted there. The canonical location for new Surface releases is this repository.
+[More MotionSmith projects](https://motionsmithai.blogspot.com/)

install_motionsmith_surface.bat ADDED Viewed

	@@ -0,0 +1,324 @@

+@echo off
+setlocal
+title MotionSmith Surface Setup
+set "MS_SURFACE_INSTALLER=%~f0"
+powershell.exe -NoLogo -NoProfile -ExecutionPolicy Bypass -Command "$raw=[IO.File]::ReadAllText($env:MS_SURFACE_INSTALLER); $body=[regex]::Split($raw,'(?m)^# POWERSHELL_PAYLOAD\r?$')[1]; if(-not $body){exit 1}; & ([scriptblock]::Create($body))"
+set "MS_SURFACE_RESULT=%ERRORLEVEL%"
+echo.
+pause
+exit /b %MS_SURFACE_RESULT%
+# POWERSHELL_PAYLOAD
+$ErrorActionPreference = 'Stop'
+[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
+$BackendUrl = 'https://huggingface.co/Serqan/MotionSmith-Surface-Backend/resolve/main/motionsmith_surface_backend_win64_0.1.0.zip?download=true'
+$BackendHash = 'd04c5edcedde213d99aea5b1e68e10f1814161c14b209048f977b93daabbac11'
+$BackendSize = [long]4211074697
+$Models = @(
+    @('diffusion_models/flux-2-klein-base-9b-Q4_0.gguf', 'https://huggingface.co/unsloth/FLUX.2-klein-base-9B-GGUF/resolve/main/flux-2-klein-base-9b-Q4_0.gguf?download=true', [long]5616228640, '02d4c2b55b5a6d4aca65eafd0f0eabe8c1e3837391042b6879be04eb99c7e116'),
+    @('text_encoders/qwen_3_8b_fp8mixed.safetensors', 'https://huggingface.co/Comfy-Org/flux2-klein-9B/resolve/main/split_files/text_encoders/qwen_3_8b_fp8mixed.safetensors?download=true', [long]8664848742, 'abad16806e0cbabc54e0325d6565847443fe396d5f0be38bb3cd3fe75a1201d6'),
+    @('vae/flux2-vae.safetensors', 'https://huggingface.co/Comfy-Org/flux2-dev/resolve/main/split_files/vae/flux2-vae.safetensors?download=true', [long]336213556, 'd64f3a68e1cc4f9f4e29b6e0da38a0204fe9a49f2d4053f0ec1fa1ca02f9c4b5'),
+    @('loras/ultratex_flux2.safetensors', 'https://www.modelscope.ai/models/Yibo-Zhang/UltraTex/resolve/master/flux2/lora/dit_lora.safetensors?view=false', [long]478172752, '3b1915177a81bc2ab43f501355bf39113df0128e6cbc6fedf8b8621d5e06a01c'),
+    @('loras/ultratex_flux2_mr.safetensors', 'https://www.modelscope.ai/models/Yibo-Zhang/UltraTex/resolve/master/flux2_mr/lora/dit_lora.safetensors?view=false', [long]478172752, '13e94f5a30a789b1e3e76d8c96cbba5f52fb2f68411e56377f382e145da23fc1'),
+    @('ultratex/ultratex_flux2_decoder.pt', 'https://www.modelscope.ai/models/Yibo-Zhang/UltraTex/resolve/master/flux2/decoder.pt?view=false', [long]99261764, '981dc4c52481687c6da4e6211617615a2b2bcc33456e1953ee6c5478aa00025b'),
+    @('background_removal/birefnet.safetensors', 'https://huggingface.co/Comfy-Org/BiRefNet/resolve/main/background_removal/birefnet.safetensors?download=true', [long]444473596, '9ab37426bf4de0567af6b5d21b16151357149139362e6e8992021b8ce356a154'),
+    @('checkpoints/SD/chord_v1.safetensors', 'https://huggingface.co/Ubisoft/ubisoft-laforge-chord/resolve/main/chord_v1.safetensors?download=true', [long]2761211350, 'b56f48857f1d84f0d051284d0c1f3ac58ecc6e86fba15c4849789f3807dd0cc2')
+)
+function Test-Download {
+    param([string]$Path, [long]$Size, [string]$Hash)
+    if (-not (Test-Path -LiteralPath $Path -PathType Leaf)) { return $false }
+    if ((Get-Item -LiteralPath $Path).Length -ne $Size) { return $false }
+    Write-Host "Checking SHA-256: $([IO.Path]::GetFileName($Path))"
+    $stream = [IO.File]::OpenRead($Path)
+    $sha = [Security.Cryptography.SHA256]::Create()
+    try {
+        $actual = [BitConverter]::ToString($sha.ComputeHash($stream)).Replace('-', '')
+        return $actual -eq $Hash
+    } finally {
+        $stream.Dispose()
+        $sha.Dispose()
+    }
+}
+function Get-Download {
+    param([string]$Url, [string]$Path, [long]$Size, [string]$Hash, [string]$Token = '')
+    if (Test-Path -LiteralPath $Path) {
+        if (Test-Download $Path $Size $Hash) {
+            Write-Host 'Already installed and verified.' -ForegroundColor Green
+            return
+        }
+        throw "Existing file differs from this release: $Path . Move it aside before retrying; it was not overwritten."
+    }
+    $null = New-Item -ItemType Directory -Path ([IO.Path]::GetDirectoryName($Path)) -Force
+    $partial = $Path + '.part'
+    if ((Test-Path -LiteralPath $partial) -and (Get-Item -LiteralPath $partial).Length -ge $Size) {
+        if (-not (Test-Download $partial $Size $Hash)) {
+            throw "Partial download is invalid: $partial . Move it aside and run setup again."
+        }
+    } else {
+        Write-Host ('Downloading {0:N2} GiB -> {1}' -f ($Size / 1GB), $Path)
+        # Send auth through stdin, never a process argument or a credential file.
+        $curlConfig = ''
+        if ($Token) {
+            if ($Token -notmatch '^hf_[A-Za-z0-9]+$') { throw 'Invalid Hugging Face token format.' }
+            $curlConfig = 'header = "Authorization: Bearer ' + $Token + '"'
+        }
+        $httpCode = $curlConfig | & curl.exe --config - --location --fail --retry 3 --retry-delay 3 --connect-timeout 30 --speed-limit 1024 --speed-time 120 --continue-at - --progress-bar --output $partial --write-out '%{http_code}' --url $Url
+        $curlExit = $LASTEXITCODE
+        $curlConfig = $null
+        if ($curlExit -ne 0) {
+            throw "Download failed (curl $curlExit, HTTP $httpCode). Partial data was kept. Run this BAT again to resume."
+        }
+        if (-not (Test-Download $partial $Size $Hash)) {
+            throw "Download verification failed: $partial . Move this file aside before retrying."
+        }
+    }
+    Move-Item -LiteralPath $partial -Destination $Path
+    Write-Host 'Verified.' -ForegroundColor Green
+}
+function Test-Backend {
+    param([string]$Path)
+    if (-not (Test-Path -LiteralPath (Join-Path $Path 'main.py') -PathType Leaf)) { return $false }
+    if (-not (Get-BackendPython $Path)) { return $false }
+    foreach ($node in @('ComfyUI-UltraTex', 'comfyui_ultratex_modular', 'ComfyUI-Chord', 'ComfyUI-GGUF')) {
+        if (-not (Test-Path -LiteralPath (Join-Path $Path ('custom_nodes\' + $node)))) { return $false }
+    }
+    return $true
+}
+function Get-BackendPython {
+    param([string]$Path)
+    foreach ($relative in @('.venv\Scripts\python.exe', 'venv\Scripts\python.exe', '..\python_embeded\python.exe', '..\python_embedded\python.exe')) {
+        $candidate = [IO.Path]::GetFullPath((Join-Path $Path $relative))
+        if (Test-Path -LiteralPath $candidate -PathType Leaf) { return $candidate }
+    }
+    return ''
+}
+function Find-ComfyInstallations {
+    param([string[]]$Roots)
+    $found = New-Object 'System.Collections.Generic.HashSet[string]' ([StringComparer]::OrdinalIgnoreCase)
+    $modelRoots = New-Object 'System.Collections.Generic.HashSet[string]' ([StringComparer]::OrdinalIgnoreCase)
+    $queue = New-Object 'System.Collections.Generic.Queue[string]'
+    foreach ($root in $Roots) { $queue.Enqueue($root) }
+    $skip = @('Windows', '$Recycle.Bin', 'System Volume Information', 'WinSxS', 'node_modules', '.git', '.venv', 'venv', '__pycache__', 'site-packages', 'python_embeded', 'python_embedded')
+    $count = 0
+    while ($queue.Count) {
+        $directory = $queue.Dequeue()
+        $count++
+        if ($count % 500 -eq 0) { Write-Progress -Activity 'Finding ComfyUI installations (directory names only)' -Status "$count folders checked; $($found.Count) installations found" }
+        if ([IO.File]::Exists((Join-Path $directory 'main.py')) -and [IO.File]::Exists((Join-Path $directory 'folder_paths.py'))) {
+            if ($found.Add($directory)) { Write-Host "Found ComfyUI: $directory" -ForegroundColor Green }
+            $null = $modelRoots.Add((Join-Path $directory 'models'))
+            continue
+        }
+        try {
+            foreach ($child in [IO.Directory]::EnumerateDirectories($directory)) {
+                $name = [IO.Path]::GetFileName($child)
+                if ($name -match '(?i)(comfy.*model|model.*comfy|^models$|^weights$)') {
+                    $null = $modelRoots.Add($child)
+                    continue
+                }
+                if ($name -in $skip) { continue }
+                # Do not follow directory links; avoids loops and repeated disk scans.
+                if (([IO.File]::GetAttributes($child) -band [IO.FileAttributes]::ReparsePoint) -ne 0) { continue }
+                $queue.Enqueue($child)
+            }
+        } catch { continue }
+    }
+    Write-Progress -Activity 'Finding ComfyUI installations (directory names only)' -Completed
+    return @{ Installations = @($found); ModelRoots = @($modelRoots) }
+}
+function Get-ModelIndex {
+    param([string[]]$Roots, [object[]]$RequiredModels)
+    $sizes = @{}
+    foreach ($model in $RequiredModels) { $sizes[[string]$model[2]] = $true }
+    $index = @{}
+    $visited = New-Object 'System.Collections.Generic.HashSet[string]' ([StringComparer]::OrdinalIgnoreCase)
+    $queue = New-Object 'System.Collections.Generic.Queue[string]'
+    foreach ($root in $Roots) { if ([IO.Directory]::Exists($root)) { $queue.Enqueue([IO.Path]::GetFullPath($root)) } }
+    while ($queue.Count) {
+        $directory = $queue.Dequeue()
+        if (-not $visited.Add($directory)) { continue }
+        try {
+            foreach ($path in [IO.Directory]::EnumerateFiles($directory)) {
+                if ([IO.Path]::GetExtension($path) -notin @('.safetensors', '.gguf', '.pt')) { continue }
+                $file = New-Object IO.FileInfo($path)
+                $key = [string]$file.Length
+                if ($sizes.ContainsKey($key)) {
+                    if (-not $index.ContainsKey($key)) { $index[$key] = New-Object 'System.Collections.Generic.List[string]' }
+                    $index[$key].Add($path)
+                }
+            }
+            foreach ($child in [IO.Directory]::EnumerateDirectories($directory)) {
+                if (([IO.File]::GetAttributes($child) -band [IO.FileAttributes]::ReparsePoint) -eq 0) { $queue.Enqueue($child) }
+                else {
+                    # Category links are common in shared model libraries. Visit their resolved target once.
+                    $target = (Get-Item -LiteralPath $child -Force).Target
+                    if ($target) {
+                        $resolved = [string]@($target)[0]
+                        if (-not [IO.Path]::IsPathRooted($resolved)) { $resolved = Join-Path $directory $resolved }
+                        $queue.Enqueue([IO.Path]::GetFullPath($resolved))
+                    }
+                }
+            }
+        } catch { continue }
+    }
+    return $index
+}
+function Install-Model {
+    param([object[]]$Model, [string]$Target, [hashtable]$Index, [string]$Token = '')
+    if (-not (Test-Path -LiteralPath $Target)) {
+        foreach ($candidate in $Index[[string]$Model[2]]) {
+            if (Test-Download $candidate $Model[2] $Model[3]) {
+                $null = New-Item -ItemType Directory -Path ([IO.Path]::GetDirectoryName($Target)) -Force
+                try {
+                    $null = New-Item -ItemType HardLink -Path $Target -Target $candidate -ErrorAction Stop
+                    Write-Host "Reusing existing model (hard link): $candidate" -ForegroundColor Green
+                } catch {
+                    Write-Host "Reusing existing model (copy across disks): $candidate"
+                    Copy-Item -LiteralPath $candidate -Destination $Target -ErrorAction Stop
+                }
+                return
+            }
+        }
+    }
+    Get-Download $Model[1] $Target $Model[2] $Model[3] $Token
+}
+function Install-Surface {
+    $null = Get-Command curl.exe -ErrorAction Stop
+    Write-Host 'MotionSmith Surface - Backend + Models Setup' -ForegroundColor Cyan
+    Write-Host 'Full download is about 21.5 GiB. Existing verified models are reused instead.'
+    Write-Host 'The Blender add-on ZIP is installed separately in Blender.'
+    Write-Host 'Close ComfyUI before installing. No administrator access is required.'
+    Write-Host "`nScanning local fixed disks for ComfyUI and shared model folders..."
+    $drives = @([IO.DriveInfo]::GetDrives() | Where-Object { $_.IsReady -and $_.DriveType -eq 'Fixed' } | ForEach-Object { $_.RootDirectory.FullName })
+    $discovery = Find-ComfyInstallations $drives
+    $compatible = @($discovery.Installations | Where-Object { Test-Backend $_ } | Sort-Object)
+    $defaultRoot = Join-Path ([Environment]::GetFolderPath('LocalApplicationData')) 'MotionSmith\Surface'
+    if ($compatible.Count) {
+        $defaultRoot = $compatible[0]
+        Write-Host "Existing backend has the Surface nodes and Python: $defaultRoot"
+    } elseif ($discovery.Installations.Count) {
+        Write-Host 'Found ComfyUI, but required Surface nodes/Python are missing. A separate Surface backend will be installed; existing models will be reused.'
+    }
+    Write-Host "Default installation folder: $defaultRoot"
+    $chosen = Read-Host 'Press Enter for the default, or enter an installation folder / existing comfyui folder'
+    if ([string]::IsNullOrWhiteSpace($chosen)) { $chosen = $defaultRoot }
+    $installRoot = [IO.Path]::GetFullPath([Environment]::ExpandEnvironmentVariables($chosen.Trim().Trim('"')))
+    $comfy = Join-Path $installRoot 'comfyui'
+    if (Test-Backend $installRoot) { $comfy = $installRoot }
+    $null = New-Item -ItemType Directory -Path $installRoot -Force
+    Write-Host "`n[1/3] Backend" -ForegroundColor Cyan
+    if (Test-Backend $comfy) {
+        Write-Host "Using existing backend: $comfy"
+    } else {
+        if (Test-Path -LiteralPath $comfy) {
+            throw "Incomplete or different backend at $comfy . Select a new folder; no existing installation was overwritten."
+        }
+        $archive = Join-Path $installRoot 'motionsmith_surface_backend_win64_0.1.0.zip'
+        Get-Download $BackendUrl $archive $BackendSize $BackendHash
+        Write-Host 'Extracting backend. This can take several minutes...'
+        Add-Type -AssemblyName System.IO.Compression.FileSystem
+        $staging = Join-Path $installRoot ('.surface-extract-' + [Guid]::NewGuid().ToString('N'))
+        [IO.Compression.ZipFile]::ExtractToDirectory($archive, $staging)
+        $extracted = Join-Path $staging 'comfyui'
+        if (-not (Test-Backend $extracted)) { throw "Unexpected backend layout in $staging" }
+        Move-Item -LiteralPath $extracted -Destination $comfy
+        # Only remove the now-empty staging directory; never delete user content.
+        [IO.Directory]::Delete($staging, $false)
+        Write-Host 'Backend extracted.' -ForegroundColor Green
+    }
+    Write-Host "`nReading extra_model_paths.yaml and indexing model file sizes..."
+    $modelRoots = @($discovery.ModelRoots) + @((Join-Path $comfy 'models'))
+    # Parse YAML with the selected backend's PyYAML; never execute YAML tags.
+    $yamlProbe = @'
+import json, os, sys, yaml
+roots=[]
+for base in json.loads(sys.stdin.read()):
+    config=os.path.join(base, 'extra_model_paths.yaml')
+    if not os.path.isfile(config): continue
+    try:
+        with open(config, encoding='utf-8-sig') as f: doc=yaml.safe_load(f) or {}
+        for group in doc.values():
+            if not isinstance(group, dict): continue
+            prefix=os.path.expandvars(os.path.expanduser(str(group.get('base_path', base))))
+            if not os.path.isabs(prefix): prefix=os.path.join(base, prefix)
+            for key, value in group.items():
+                if key in ('base_path', 'is_default'): continue
+                for relative in (value if isinstance(value,list) else str(value).splitlines()):
+                    path=os.path.expandvars(os.path.expanduser(str(relative).strip()))
+                    if path: roots.append(os.path.normpath(os.path.join(prefix,path)))
+    except Exception as e: print('Cannot read '+config+': '+str(e),file=sys.stderr)
+print(json.dumps(roots))
+'@
+    $python = Get-BackendPython $comfy
+    $configs = @($discovery.Installations) + @($comfy)
+    $extraRootsJson = ConvertTo-Json -InputObject $configs -Compress
+    $extraRoots = $extraRootsJson | & $python -c $yamlProbe
+    if ($LASTEXITCODE -ne 0) { throw 'Could not read backend model path configuration.' }
+    $modelRoots += @($extraRoots | ConvertFrom-Json)
+    $modelIndex = Get-ModelIndex $modelRoots $Models
+    Write-Host "`n[2/3] Texture models" -ForegroundColor Cyan
+    for ($i = 0; $i -lt 7; $i++) {
+        $model = $Models[$i]
+        Write-Host ("`n[{0}/8] {1}" -f ($i + 1), $model[0])
+        $target = Join-Path (Join-Path $comfy 'models') $model[0]
+        Install-Model $model $target $modelIndex
+    }
+    Write-Host "`n[3/3] Chord PBR Material model" -ForegroundColor Cyan
+    Write-Host 'Chord uses the Ubisoft Machine Learning Research-Only license.'
+    $chord = $Models[7]
+    $target = Join-Path (Join-Path $comfy 'models') $chord[0]
+    $chordReady = $false
+    try {
+        Install-Model $chord $target $modelIndex
+        $chordReady = $true
+    } catch {
+        Write-Host $_.Exception.Message -ForegroundColor Yellow
+        Write-Host 'If access is denied, sign in and accept the model terms here:'
+        Write-Host 'https://huggingface.co/Ubisoft/ubisoft-laforge-chord'
+        Write-Host 'Then create a Read token with access to this model: https://huggingface.co/settings/tokens'
+        Write-Host 'Paste the token below (hidden), or press Enter to skip Chord for now.'
+        $secret = Read-Host 'Hugging Face token' -AsSecureString
+        if ($secret.Length -gt 0) {
+            $credential = New-Object System.Net.NetworkCredential('', $secret)
+            try {
+                Install-Model $chord $target $modelIndex $credential.Password
+                $chordReady = $true
+            } finally {
+                $credential = $null
+                $secret.Dispose()
+            }
+        } else { $secret.Dispose() }
+    }
+    Write-Host "`nTexture setup complete." -ForegroundColor Green
+    if ($chordReady) { Write-Host 'PBR Material setup complete.' -ForegroundColor Green }
+    else { Write-Host 'PBR Material NOT installed. Run setup again after obtaining Chord access.' -ForegroundColor Yellow }
+    Write-Host "`nBlender Preferences > Add-ons > MotionSmith Surface > Backend"
+    Write-Host "ComfyUI Directory: $comfy"
+    Write-Host ('Python Executable: ' + $python)
+    Write-Host 'Save Preferences, start the server, then Refresh Installed Models.'
+    Write-Host 'The verified backend ZIP is kept for reuse.'
+    if (-not $chordReady) { return 2 }
+    return 0
+}
+try {
+    $result = Install-Surface
+    exit $result
+} catch {
+    Write-Host "`nSETUP FAILED: $($_.Exception.Message)" -ForegroundColor Red
+    Write-Host 'Completed downloads and partial files were kept. Correct the issue and run this BAT again.'
+    exit 1
+}

motionsmith_surface.zip CHANGED Viewed

@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:8e09ec8a41aa93365acd315f34fe9d1998a867e94b9a6480b0820e6d3acd6c38
-size 3122246

 version https://git-lfs.github.com/spec/v1
+oid sha256:92e0ef673f9167677bb4f0e00d94640a7b80aef072a60bf412502398b52c2237
+size 3122235

motionsmith_surface_backend_win64_0.1.0.zip.sha256 ADDED Viewed

	@@ -0,0 +1 @@


1	+ d04c5edcedde213d99aea5b1e68e10f1814161c14b209048f977b93daabbac11 motionsmith_surface_backend_win64_0.1.0.zip