ComfyUI Node
VRGDG LTX Audio Only LoRA Train Chunk
Runs one LTX-2.3 audio-only LoRA training chunk using musubi-tuner on spoken dialogue or music clips.
VRGDG LTX Audio Only LoRA Train Chunk
- model
- audio
- model
- latest_state_path
- log_path
- dataset_audio_dir
- output_name
- completed_steps
- total_target_steps
◄workspace_dir►
◄run_nameLTXAudioChunkRun►
◄output_nameLTXAudioChunkRun►
◄audio_profilevoice_test►
◄use_profile_defaultstrue►
◄audio_only_target_resolution64►
◄audio_only_target_fps25.0►
◄audio_only_sequence_resolution64►
◄steps_per_run100►
◄total_target_steps800►
◄network_dim16►
◄network_alpha16►
◄blocks_to_swap2►
◄lora_target_presetaudio►
◄fp8_basetrue►
◄fp8_scaledtrue►
◄ltx2_audio_only_modeltrue►
◄clear_memory_before_gemmatrue►
◄gemma_recovery_modefalse►
◄learning_rate_preset1e-4►
◄learning_rate0.0001►
◄num_repeats2►
◄audio_bucket_strategypad►
◄audio_bucket_interval2.0►
◄cache_strategyauto►
◄copy_latest_to_comfy_lorastrue►
◄keep_only_comfy_lorafalse►
◄strength_model1.00►
◄create_captionsfalse►
◄caption_text►
◄add_trigger_wordfalse►
◄trigger_text►
◄musubi_rootA:/MUSUBI/musubi-tuner-ltx2►
◄ltx2_checkpointA:/MUSUBI/models/ltx/ltx-2.3-22b-dev.safetensors►
◄gemma_rootA:/MUSUBI/models/gemma3►
◄gemma_load_in_4bitfalse►
◄audio_directory►
CategoryVRGDG/Training
Inputs (39)
| Name | Type | Default | Description |
|---|---|---|---|
| model | MODEL | Base model to return downstream with the latest trained LoRA optionally applied. | |
| workspace_dir | STRING | Working folder for cache, logs, config files, checkpoints, and training state. | |
| run_name | STRING | LTXAudioChunkRun | Name prefix used for the log file. |
| output_name | STRING | LTXAudioChunkRun | Name prefix used for saved LoRA files and state folders. |
| audio_profile | COMBO | voice_test | voice_test is a short spoken-dialogue sanity check. voice is the spoken-dialogue preset. music uses a larger temporal budget and more capacity. voice_fast and voice_balanced are legacy aliases. |
| use_profile_defaults | BOOLEAN | true | When enabled, the selected profile controls the audio recipe bundle instead of the manual fields below. |
| audio_only_target_resolution | INT | 6432–4096 | Square target resolution used for audio-only latent geometry. |
| audio_only_target_fps | FLOAT | 25.01–240 | Target FPS used to derive frame count from audio duration during caching. |
| audio_only_sequence_resolution | INT | 640–8192 | Virtual sequence resolution used for shifted_logit_normal in audio mode. Set 0 to use cached virtual geometry. |
| steps_per_run | INT | 1001–100000 | How many steps to train before saving and stopping this chunk. |
| total_target_steps | INT | 8001–1000000 | Total training budget across all chunks. |
| network_dim | INT | 161–2048 | LoRA rank. |
| network_alpha | INT | 161–2048 | LoRA alpha. |
| blocks_to_swap | INT | 20–64 | How many transformer blocks to offload to CPU. |
| lora_target_preset | COMBO | audio | audio is the intended preset for audio-only training. |
| fp8_base | BOOLEAN | true | Use the FP8 base-model loading path. |
| fp8_scaled | BOOLEAN | true | Quantize non-FP8 checkpoints into FP8 at load time. |
| ltx2_audio_only_model | BOOLEAN | true | Force loading the physically audio-only transformer variant. Keep this on for audio-only training. |
| clear_memory_before_gemma | BOOLEAN | true | Unloads ComfyUI models and clears memory before Gemma caching. |
| gemma_recovery_mode | BOOLEAN | false | Experimental. If enabled, the node will try alternate Gemma cache settings after the normal path fails. |
| learning_rate_preset | COMBO | 1e-4 | Quick preset for the training learning rate. |
| learning_rate | FLOAT | 0.00011e-8–1 | Custom learning rate used only when the preset is set to Custom. |
| num_repeats | INT | 21–1000 | How many times each audio-caption pair is repeated in the dataset. |
| audio_bucket_strategy | COMBO | pad | Audio duration bucketing strategy. |
| audio_bucket_interval | FLOAT | 2.00.1–120 | Audio bucket step size in seconds. |
| cache_strategy | COMBO | auto | Auto rebuilds cache only when the node detects it is missing or stale. |
| copy_latest_to_comfy_loras | BOOLEAN | true | Copies the latest Comfy-compatible LoRA into the ComfyUI loras folder after training. |
| keep_only_comfy_lora | BOOLEAN | false | Deletes the standard .safetensors LoRA files after a matching .comfy.safetensors file exists. |
| strength_model | FLOAT | 1.00-100–100 | Strength used if the node applies the latest LoRA back onto the output model. |
| create_captions | BOOLEAN | false | Creates missing .txt caption files automatically from the caption_text field. |
| caption_text | STRING | Fallback caption text used when a source audio clip has no caption file. | |
| add_trigger_word | BOOLEAN | false | Prepends trigger_text to every caption. |
| trigger_text | STRING | Trigger word or phrase to prepend to captions when add_trigger_word is enabled. | |
| musubi_root | STRING | A:/MUSUBI/musubi-tuner-ltx2 | Root folder of your musubi-tuner-ltx2 install. |
| ltx2_checkpoint | STRING | A:/MUSUBI/models/ltx/ltx-2.3-22b-dev.safetensors | Path to the base LTX checkpoint used for caching and training. |
| gemma_root | STRING | A:/MUSUBI/models/gemma3 | Folder containing the Gemma model files used for text encoder caching. |
| gemma_load_in_4bit | BOOLEAN | false | Loads Gemma in 4-bit mode instead of 8-bit. |
| audioopt | AUDIO | Optional connected AUDIO input. If provided, it is copied into a managed audio dataset folder and used instead of audio_directory. | |
| audio_directoryopt | STRING | Optional folder containing audio files with matching .txt captions. Leave empty if you connect an AUDIO input. |
Outputs (7)
| Name | Type | Description |
|---|---|---|
| model | MODEL | — |
| latest_state_path | STRING | — |
| log_path | STRING | — |
| dataset_audio_dir | STRING | — |
| output_name | STRING | — |
| completed_steps | INT | — |
| total_target_steps | INT | — |