Skip to content

HuggingFace

Vladimir Mandic edited this page Nov 10, 2025 · 3 revisions

HuggingFace

Automatic Model Download

Manual model download from HuggingFace is supported in SD.Next, but not preferred way as SD.Next has a built-in model downloader.

You can simply type the model repo id in the model selection dropdown and SD.Next will search for it and download it automatically into the correct folder.

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

Manual Model Download

When downloading models manually from HuggingFace using either of the methods below, please ensure that you place the downloaded model files into the correct directory as specified in your SD.Next configuration under the Diffusers models path

Prefferred method

for manually downloading a model from hugginface to your local directory:

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

This will automatically create folder structure as expected by sdnext for huggingface models

Note

hf command cli guide

Important

You must set folder to a correct Diffusers folder as specified in your SD.Next config

Example:

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

Which downloaded the model into /sdnext/models/Diffusers/models--Laxhar--noobai-XL-Vpred-1.0/ folder
And model becomes visible in sdnext under name noobai-XL-Vpred-1.0

Alternative method

You can do full download as-is using any tool For example: browser, git lfs, wget, curl, hf cli, etc.

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 full path to the model folder directly and that name is what SD.Next will use to identify the model
Model folder should not be prefixed with models--<author>-- as per standard HuggingFace folder structure as to indicate to SD.Next that this is a manually downloaded model and should be treated as such
Folder name MUST contain original model name as on HuggingFace to allow SD.Next to match model type and select correct loader for it

Example:

  • Ok: /sdnext/models/Diffusers/noobai-XL-Vpred-1.0-my-version
  • Not ok: /sdnext/models/Diffusers/my-version

Clone this wiki locally