StableFast3D Windows Portable

image::docs/screenshot.webp["Screenshot"]

link:README.zh.adoc[中文说明]

A dedicated package for running
https://github.com/Stability-AI/stable-fast-3d[Stable Fast 3D]
official ComfyUI workflow on Windows.

Update: This repo has been merged into
https://github.com/YanWenKun/Comfy3D-WinPortable/releases/tag/r6-pt25[Comfy3D-WinPortable],
a more comprehensive package.
However, StableFast3D-WinPortable is more concise and still works.

How to use

1. You need an NVIDIA GPU with at least 8GB VRAM.

2. Install Visual Studio Build Tools 2022
   (
   https://visualstudio.microsoft.com/downloads/?q=build+tools[Page]
   |
   https://aka.ms/vs/17/release/vs_BuildTools.exe[EXE]
   ).
   During the setup, select "Desktop development with C++" workload.
   You only need these two optional components:

** MSVC Build Tools (compilers and libraries)
** CMake for C++ on Windows
** If you already installed Visual Studio with C++ workload, just skip this step. (Some PyTorch extension code needs to be compiled during runtime, so the build tools are needed.)

3. Install
   https://developer.nvidia.com/cuda-12-4-1-download-archive?target_os=Windows&target_arch=x86_64&target_version=11&target_type=exe_network[CUDA Toolkit]
   with version no later than 12.4.1.
   You only need to install
   https://github.com/YanWenKun/StableFast3D-WinPortable/raw/refs/heads/main/docs/cuda-toolkit-install-selection.webp[Libraries and Compilers].

4. On Hugging Face:

** Register/Login
https://huggingface.co/login[Hugging Face].

** Go to
https://huggingface.co/stabilityai/stable-fast-3d[Stable Fast 3D repository],
fill in and agree Stability AI's License Agreement.

** Go to
https://huggingface.co/settings/tokens/new?tokenType=read[Access Tokens],
create a read-only token.

5. In the
   https://github.com/YanWenKun/StableFast3D-WinPortable/releases[StableFast3D-WinPortable/releases] page,
   download SF3D.7z, extract it to a convenient place.

6. Edit run.bat, find & replace hf_your_token
   with the read-only access token you just created in step 4.

7. (Optional) If you already have these model files cached in
   %USERPROFILE%\.cache\huggingface\hub, copy/move them to the SF3D\HuggingFaceHub folder.

** CLIP-ViT-B-32-laion2B-s34B-b79K
** dinov2-large
** stable-fast-3d

8. Run run.bat.
   ** When start complete, it will auto open http://localhost:8188/ in browser.

9. In the left side bar, find the workflow, open it, and click "Queue" button in the bottom-center of the page.

image::docs/select_workflow.webp["Select Workflow"]

File Location

The output files will be saved in ComfyUI\output.

The input files (examples) are in ComfyUI\input.