mm3-lm-adapter-training

Trains MiniMax-Music3 planner-LM LoRA adapters for album-style music cloning.

151|22|Updated Apr 19, 2026
One-click install
npx skills add https://github.com/scragnog/HOT-Step-CPP --skill mm3-lm-adapter-training-scragnog
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mm3-lm-adapter-training
Source: https://github.com/scragnog/HOT-Step-CPP/tree/main/.claude/skills/mm3-lm-adapter-training
Command: npx skills add https://github.com/scragnog/HOT-Step-CPP --skill mm3-lm-adapter-training-scragnog

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Training a MiniMax-Music3 planner-LM style adapter involves many interacting knobs (rank, optimizer, crop window, steps, captions, triggers), and wrong choices silently produce adapters that lose song structure, jumble vocals, or never end a render. This Skill encodes an ear-validated recipe so you train a working album-clone adapter on the first run instead of burning GPU hours on broken configurations. ## Core Features & Use Cases - Validated training recipe: Provides the current best ace-train mm3-lm-train flag set (HOT-PiZZA rank 128, AdamW 8e-5, whole-song 9000-frame windows, 600 steps) plus Fast/Balanced/Thorough presets matching the Training Studio. - Checkpoint selection guidance: Explains why held-out loss cannot pick the right checkpoint and how to audition the saved ladder instead. - Failure diagnosis: Covers traps like missing RVQ codes, broken f16 adapter rendering, Muon scale failures, shared-caption ending bugs, and eval-crop misconfiguration. - Use Case: You have a 12-track album dataset and want an adapter whose renders sound like another track off that record; follow the recipe block, export codes first, train Balanced, and audition checkpoints every 100 steps. ## Quick Start Ask the assistant to train an MM3 LM adapter on your dataset using the Balanced preset from this recipe and explain which checkpoint to ship.

Frequently Asked Questions about mm3-lm-adapter-training

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I train a MiniMax-Music3 LM adapter for an album clone?

Export RVQ codes with ace-train mm3-codes first, then run mm3-lm-train with HOT-PiZZA rank 128, AdamW at 8e-5, whole-song 9000-frame windows, and 600 steps. Audition checkpoints saved every 100 steps and pick by ear, not by loss.

How many steps should an MM3 LM adapter train for?

Use 300 steps for Fast, 600 for Balanced, or 900 for Thorough presets. Held-out loss bottoms out 1-8x earlier than the checkpoint that sounds right, so never pick a checkpoint by loss; beyond ~2500 steps nothing improves.

Why does my MM3 adapter training fail with no usable samples?

The trainer reads RVQ codes, not audio, so a dataset that was only captioned has none. Run ace-train mm3-codes against the dataset first to write the codes cache, then start the training run.

Should I use Muon or AdamW for MM3 LM adapter training?

Use AdamW. Muon at the default scale of 64 produces adapters with 27x larger B matrices that render digital silence, and AdamW is also 12-25% faster per step at every rank measured on a 32 GB card.

Why do MM3 adapter renders sound garbled on the f16 base?

The adapter-apply path on the mm3-lm-f16 base is defective, producing incoherent audio even for f16-trained adapters. Always render adapters on the q8_0 base and pin it before scripting renders.

What rank should I use for an MM3 LoRA adapter?

Rank 128 is the validated default: rank 64 produces gibberish lyrics because the adapter commandeers linguistic directions, while rank 256 costs 5.4 GB more VRAM with no audible gain. Higher ranks are untested for quality.