Files

T

Add MOSS LoRA loading support and compatibility validation

Implementation details:
- Add managed MOSS LoRA discovery and Hugging Face install flow under models/TTS/moss_tts/loras
- Wire PEFT adapter loading through the MOSS engine, adapter, cache, generation info, and unified model interface
- Validate adapter base-model compatibility before loading to prevent huge PEFT mismatch errors
- Raise real ComfyUI popup errors for MOSS LoRA/base model mismatches instead of generic engine creation failures
- Patch bundled MOSS Delay and TTSD classes for PEFT generation compatibility
- Upgrade installer requirement handling so outdated packages like peft are upgraded automatically
- Document the MOSS LoRA folder contract and update MOSS metadata

2026-05-23 17:42:01 -03:00

2.2 KiB

Raw Permalink Blame History

MOSS LoRA Guide

This guide defines the local adapter layout and loading behavior for MOSS-TTS LoRA adapters in TTS Audio Suite.

Local Folder Layout

MOSS LoRA adapters should live under:

ComfyUI/models/TTS/moss_tts/loras/

Each adapter must have its own folder:

ComfyUI/models/TTS/moss_tts/loras/
  MyNorwegianLoRA/
    adapter_config.json
    adapter_model.safetensors

Recommended structure:

<adapter_name>/
  adapter_config.json
  adapter_model.safetensors

Also accepted:

<adapter_name>/
  adapter_config.json
  adapter_model.bin

Required Files

Each adapter folder must contain:

adapter_config.json
one adapter weights file:
- adapter_model.safetensors preferred
- or adapter_model.bin

Extra files are allowed, for example:

README.md
training metadata
tokenizer notes

What Is Not Supported

Do not place loose adapter files directly inside:

ComfyUI/models/TTS/moss_tts/loras/

This is not a supported layout:

loras/
  adapter_config.json
  some_weights.safetensors

This is also not supported:

loras/
  MyLoRA.safetensors

One adapter must always be one folder.

Engine Node Behavior

The MOSS engine node supports two adapter paths:

Local LoRA dropdown
- lists valid adapter folders discovered under models/TTS/moss_tts/loras
Advanced override field
- accepts:
  - a local adapter folder path
  - a Hugging Face repo id

If you enter a Hugging Face repo id, TTS Audio Suite installs it into:

ComfyUI/models/TTS/moss_tts/loras/<owner__repo>/

Then it loads the adapter from that local folder.

Why This Layout Exists

TTS Audio Suite does not use Hugging Face cache as the final managed storage location for MOSS LoRAs.

This layout keeps adapters:

visible in the MOSS dropdown
stored inside the normal TTS model tree
ready for future training output
separate from ComfyUI diffusion LoRA folders

Training Output Standard

Future MOSS training should write adapters in exactly this format:

ComfyUI/models/TTS/moss_tts/loras/<run_name>/
  adapter_config.json
  adapter_model.safetensors

That keeps training, manual installs, and inference all using the same contract.

2.2 KiB Raw Permalink Blame History