Download and Install MotionSmith Surface in Blender

MotionSmith Surface has two setup pieces: the Blender add-on and a local ComfyUI environment. Install the add-on first, then let the setup check whether your machine already has a compatible backend and models.

Server & Target Mesh in the Blender Surface sidebar
The Surface sidebar’s backend and target-mesh controls.

Download the correct files

Open the official Surface download hub and select the versioned Blender add-on ZIP. The Windows backend archive is a separate runtime package. The install tool can reuse a compatible environment and obtain missing model files as needed. The version 0.1.1 release documentation lists about 21.5 GiB for a full fresh download and at least 35 GiB of free space for installation.

The documented platform is Windows 64-bit with a compatible NVIDIA CUDA GPU and Blender 5.0 or later. Use the current release notes to verify the distribution and the version of Blender it was tested with.

PBR Material panel in the Blender Surface sidebar
The PBR Material panel in the Blender Surface sidebar.

Install and connect

  1. In Blender Preferences, open Add-ons and choose Install from Disk. Select the add-on ZIP and enable MotionSmith Surface.
  2. Open the add-on preferences and choose Install. The setup checks existing ComfyUI and model locations before downloading missing files. Decide which workflow you want first. Chord can be skipped while you complete Texture setup.
  3. Use the final ComfyUI Directory and Python Executable shown by setup in the add-on’s Backend preferences. Save Preferences, open the Surface sidebar and start the server.
  4. Watch the connection status. Select one UV-mapped test mesh and run the smallest useful job for the workflow you installed. Inspect the result in a simple scene before using a production asset.
How to Install MotionSmith Surface Add-On in Blender | Complete Setup Guide. A walkthrough of installing the Surface Blender add-on. Watch on YouTube.

If a model asks for access

Some models require you to sign in with Hugging Face, accept their terms and provide a Read token to setup. Follow the upstream access requirements and the license notes in the release hub. For a stalled connection or missing file, use the Surface setup and panel documentation, then contact MotionSmith Support with the first failing step.

Comments