HuggingFace

Automatic Model Download

Manual model download from Hugging Face is supported, but SD.Next includes a built-in downloader and that is the preferred path.

Type the model repo ID in the model selection dropdown and SD.Next will search for it and download it into the correct folder.

Example: Type Laxhar/noobai-XL-Vpred-1.0 in the model selection dropdown.

Manual Model Download

If you download models manually, place files in the correct directory from your SD.Next config under the Diffusers models path.

Preferred method

For manual download from Hugging Face into your local diffusers directory:

hf download --cache-dir <path-to-sdnext-diffusers-folder> <author>/<repo-id-on-huggingface>

This creates the folder structure expected by SD.Next for Hugging Face models.

Note

hf command CLI guide

[!IMPORTANT] You must set the path to the correct Diffusers folder from your SD.Next config.

Example:

hf download --cache-dir /sdnext/models/Diffusers/ Laxhar/noobai-XL-Vpred-1.0

This downloads the model into /sdnext/models/Diffusers/models--Laxhar--noobai-XL-Vpred-1.0/. The model then appears in SD.Next as noobai-XL-Vpred-1.0.

Alternative method

You can also do a full download as-is with any tool, for example browser, git lfs, wget, curl, or hf CLI.

Example using hf CLI:

hf download --local-dir /sdnext/models/Diffusers/noobai-XL-Vpred-1.0 Laxhar/noobai-XL-Vpred-1.0

Important

In this case, you specify the full model folder path directly, and that folder name is what SD.Next uses to identify the model. The folder should not use the models--<author>-- prefix used by standard Hugging Face cache layout, because SD.Next uses this to distinguish manually downloaded models. Folder name must contain the original model name from Hugging Face so SD.Next can match model type and select the correct loader.

Example: - OK: /sdnext/models/Diffusers/noobai-XL-Vpred-1.0-my-version - Not OK: /sdnext/models/Diffusers/my-version