Skip to content

Local UI to run and train LLMs and diffusion models. Supports GGUF, MLX, Qwen3.8, DeepSeek-V4.1, MiniMax-H3, Gemma 4, FLUX and more.

14.9 KB
Raw Blame
# SPDX-License-Identifier: AGPL-3.0-only
# Copyright 2023-present Daniel Han-Chen & the Unsloth team. All rights reserved.

import os
import types

import pytest
from real_accelerator import has_real_cuda

torch = pytest.importorskip("torch")
transformers = pytest.importorskip("transformers")
if not hasattr(transformers, "DiffusionGemmaForBlockDiffusion"):
    pytest.skip("transformers without DiffusionGemma", allow_module_level = True)

from unsloth.models.diffusion_gemma_objective import DIFFUSION_GEMMA_PROFILE
from unsloth.models.diffusion_profiles import resolve_diffusion_profile

TINY = "trl-internal-testing/tiny-DiffusionGemmaForBlockDiffusion"
TRL_EXAMPLE = os.environ.get("UNSLOTH_TRL_DIFFUSION_GEMMA_EXAMPLE")


@pytest.fixture(scope = "module")
def model():
    m = transformers.DiffusionGemmaForBlockDiffusion.from_pretrained(TINY, dtype = torch.float32)
    m._unsloth_diffusion_eos_token_id = 1
    return m.train()


def _batch(
    vocab,
    canvas,
    max_length = 80,
    rows = None,
):
    g = torch.Generator().manual_seed(0)
    if rows is None:
        rows = [(5, 10), (7, canvas * 2 + 3), (4, max_length - 4)]
    input_ids = torch.zeros(len(rows), max_length, dtype = torch.long)
    attention_mask = torch.zeros_like(input_ids)
    labels = torch.full_like(input_ids, -100)
    for i, (p, r) in enumerate(rows):
        n = p + r
        input_ids[i, :n] = torch.randint(10, vocab, (n,), generator = g)
        attention_mask[i, :n] = 1
        labels[i, p:n] = input_ids[i, p:n]
    return {"input_ids": input_ids, "attention_mask": attention_mask, "labels": labels}


def _args(**kw):
    base = dict(
        max_length = 80,
        diffusion_eps = None,
        diffusion_self_conditioning_p = None,
        diffusion_encoder_ar_weight = None,
        diffusion_prediction_type = None,
    )
    base.update(kw)
    return types.SimpleNamespace(**base)


def test_profile_resolves(model):
    assert resolve_diffusion_profile(model.config) is DIFFUSION_GEMMA_PROFILE


def test_canvas_reaches_the_decoder(model):
    # The notebook passed canvas_ids, which forward() silently swallows; decoder_input_ids must change the logits.
    cfg = model.config
    ids = torch.randint(10, 1000, (1, 8))
    a = torch.randint(10, 1000, (1, cfg.canvas_length))
    b = torch.randint(10, 1000, (1, cfg.canvas_length))
    with torch.no_grad():
        la = model(input_ids = ids, decoder_input_ids = a).logits
        lb = model(input_ids = ids, decoder_input_ids = b).logits
    assert not torch.allclose(la, lb)


def test_loss_finite_and_metrics(model):
    batch = _batch(model.config.text_config.vocab_size, model.config.canvas_length)
    torch.manual_seed(0)
    loss, _, metrics = DIFFUSION_GEMMA_PROFILE.compute_loss(model, batch, _args())
    assert torch.isfinite(loss)
    assert set(metrics) == {"diffusion_loss", "encoder_ar_loss", "mean_t"}


@pytest.mark.skipif(
    TRL_EXAMPLE is None, reason = "set UNSLOTH_TRL_DIFFUSION_GEMMA_EXAMPLE to TRL's example file"
)
@pytest.mark.parametrize("prediction_type", ["mean", "mean_loo"])
def test_parity_with_trl_reference(model, prediction_type):
    source = open(TRL_EXAMPLE, encoding = "utf-8").read()
    source = source.replace(
        "from trl.trainer.utils import maybe_gather_lm_head_ctx",
        "import contextlib\nmaybe_gather_lm_head_ctx = lambda *a: contextlib.nullcontext()",
    )
    if prediction_type == "mean_loo":
        # mean_loo lifts one logit by ~log(K / (1 - alpha)); fp32 F.cross_entropy over the 262k vocab is then
        # ~6e-7 off the fp64 logit gradient (our chunked CE ~1e-8). Score the reference in fp64 instead.
        source = source.replace(
            "import torch.nn.functional as F",
            "import torch.nn.functional as _F\n"
            "class F:\n"
            "    def __getattr__(self, name): return getattr(_F, name)\n"
            "    @staticmethod\n"
            "    def cross_entropy(x, *a, **k): return _F.cross_entropy(x.double(), *a, **k).float()\n"
            "F = F()",
        )
    namespace = {"__name__": "trl_example"}
    exec(compile(source, TRL_EXAMPLE, "exec"), namespace)
    reference = namespace["DiffusionGemmaSFTTrainer"]
    cfg = model.config
    fake = types.SimpleNamespace(
        args = types.SimpleNamespace(max_length = 80),
        canvas_length = cfg.canvas_length,
        vocab_size = cfg.text_config.vocab_size,
        final_logit_softcapping = cfg.text_config.final_logit_softcapping,
        eos_token_id = 1,
        model_prediction_type = prediction_type,
        model = model,
        eps = reference.eps,
        self_conditioning_p = reference.self_conditioning_p,
    )
    batch = _batch(cfg.text_config.vocab_size, cfg.canvas_length)
    params = [p for p in model.parameters() if p.requires_grad]

    def run(fn):
        model.zero_grad(set_to_none = True)
        torch.manual_seed(1234)
        loss = fn()
        loss.backward()
        return loss.detach(), [None if p.grad is None else p.grad.clone() for p in params]

    ref_loss, ref_grads = run(lambda: reference.compute_loss(fake, model, batch))
    our_loss, our_grads = run(
        lambda: DIFFUSION_GEMMA_PROFILE.compute_loss(
            model, batch, _args(diffusion_prediction_type = prediction_type)
        )[0]
    )
    torch.testing.assert_close(our_loss, ref_loss, rtol = 1e-6, atol = 1e-6)
    for a, b in zip(our_grads, ref_grads):
        if a is None or b is None:
            assert a is None and b is None
        else:
            # Right-aligned prefix cache slots reorder the attention sums: ~1.5e-7 apart on near-zero grads.
            torch.testing.assert_close(a, b, rtol = 1e-5, atol = 1e-6)


def test_tied_encoder_decoder_lora_merge_is_refused():
    from peft import LoraConfig, get_peft_model

    from unsloth.models.diffusion import _refuse_tied_lora_merge

    m = transformers.DiffusionGemmaForBlockDiffusion.from_pretrained(TINY, dtype = torch.float32)
    enc = m.model.encoder.language_model.layers[0].self_attn.q_proj
    dec = m.model.decoder.layers[0].self_attn.q_proj
    assert enc is not dec and enc.weight.data_ptr() == dec.weight.data_ptr()
    m = get_peft_model(
        m, LoraConfig(r = 4, target_modules = DIFFUSION_GEMMA_PROFILE.lora_target_modules)
    )
    m = _refuse_tied_lora_merge(m)
    with pytest.raises(RuntimeError, match = "share base weights"):
        m.merge_and_unload()


def test_untied_lora_merge_still_allowed():
    from peft import LoraConfig, get_peft_model

    from unsloth.models.diffusion import _refuse_tied_lora_merge

    m = transformers.AutoModelForCausalLM.from_pretrained(
        "trl-internal-testing/tiny-Qwen3ForCausalLM"
    )
    m = _refuse_tied_lora_merge(
        get_peft_model(m, LoraConfig(r = 4, target_modules = ["q_proj", "v_proj"]))
    )
    assert "merge_and_unload" not in vars(m)
    m.merge_and_unload()


class _DistributedLike(torch.nn.Module):
    """DDP / FSDP expose neither config nor heads; only forward reaches the module."""

    def __init__(self, inner):
        super().__init__()
        self.module = inner

    def forward(self, **kwargs):
        return self.module(**kwargs)


def test_loss_through_distributed_wrapper(model):
    batch = _batch(model.config.text_config.vocab_size, model.config.canvas_length)
    torch.manual_seed(0)
    plain = DIFFUSION_GEMMA_PROFILE.compute_loss(model, batch, _args())[0]
    torch.manual_seed(0)
    wrapped = DIFFUSION_GEMMA_PROFILE.compute_loss(_DistributedLike(model), batch, _args())[0]
    torch.testing.assert_close(wrapped, plain)


class _ScatteringDataParallel(torch.nn.DataParallel):
    """nn.DataParallel's contract without GPUs: tensors split on dim 0, every other object shared by all replicas."""

    def __init__(
        self,
        inner,
        replicas = 2,
    ):
        torch.nn.Module.__init__(self)
        self.module = inner
        self.replicas = replicas

    def forward(self, **kwargs):
        rows = next(v for v in kwargs.values() if torch.is_tensor(v)).shape[0]
        bounds = torch.arange(rows).chunk(self.replicas)
        outs = [
            self.module(
                **{
                    k: v[b[0] : b[-1] + 1]
                    if torch.is_tensor(v) and v.dim() and v.shape[0] == rows
                    else v
                    for k, v in kwargs.items()
                }
            )
            for b in bounds
        ]
        return types.SimpleNamespace(
            logits = torch.cat([o.logits for o in outs]),
            encoder_last_hidden_state = torch.cat([o.encoder_last_hidden_state for o in outs]),
        )


def test_loss_through_data_parallel_scatter(model):
    # Each replica must decode from a cache holding its own rows, not one built for the whole batch.
    batch = _batch(model.config.text_config.vocab_size, model.config.canvas_length)
    torch.manual_seed(0)
    plain = DIFFUSION_GEMMA_PROFILE.compute_loss(model, batch, _args())[0]
    torch.manual_seed(0)
    wrapped = DIFFUSION_GEMMA_PROFILE.compute_loss(_ScatteringDataParallel(model), batch, _args())[
        0
    ]
    torch.testing.assert_close(wrapped, plain)
    assert not model._forward_pre_hooks and not model._forward_hooks


@pytest.mark.parametrize("attn", ["eager", "sdpa"])
def test_decoder_sees_the_prefix_window_inference_sees(attn):
    # The encoder runs on the whole sequence, but sliding decoder layers must keep the window ending at the
    # sampled block, as inference does after encoding only the prefix.
    cfg = transformers.AutoConfig.from_pretrained(TINY)
    cfg.text_config.sliding_window = 8
    m = transformers.DiffusionGemmaForBlockDiffusion.from_pretrained(
        TINY, config = cfg, dtype = torch.float32, attn_implementation = attn
    ).train()
    m._unsloth_diffusion_eos_token_id = 1
    rows = [(5, 100), (40, 70), (3, 20), (60, 60)]
    batch = _batch(cfg.text_config.vocab_size, cfg.canvas_length, max_length = 120, rows = rows)
    seen = {}
    forward = m.forward

    def spy(**kw):
        out = forward(**kw)
        seen.update(kw = kw, logits = out.logits.detach())
        return out

    m.forward = spy
    torch.manual_seed(5)
    DIFFUSION_GEMMA_PROFILE.compute_loss(
        m, batch, _args(max_length = 120, diffusion_self_conditioning_p = 0.0)
    )
    del m.forward
    kw = seen["kw"]
    encoder_len = kw["decoder_position_ids"][:, 0].tolist()
    assert max(encoder_len) > cfg.text_config.sliding_window
    with torch.no_grad():
        for i, n in enumerate(encoder_len):
            ref = m(
                input_ids = batch["input_ids"][i : i + 1, :n],
                decoder_input_ids = kw["decoder_input_ids"][i : i + 1],
                decoder_position_ids = kw["decoder_position_ids"][i : i + 1],
            ).logits
            torch.testing.assert_close(seen["logits"][i : i + 1], ref, rtol = 1e-5, atol = 1e-5)


def test_row_without_supervised_tokens_adds_no_canvas_loss(model):
    batch = _batch(model.config.text_config.vocab_size, model.config.canvas_length, rows = [(6, 0)])
    torch.manual_seed(0)
    _, _, metrics = DIFFUSION_GEMMA_PROFILE.compute_loss(model, batch, _args())
    assert metrics["diffusion_loss"] == 0.0


@pytest.mark.parametrize("rows", [[(1, 0)], [(1, 0), (0, 0)]])
def test_batch_without_encoder_ar_targets_is_finite(model, rows):
    # A one-token or all-padding batch has no next-token pair: the AR co-loss is 0, not a NaN mean.
    batch = _batch(model.config.text_config.vocab_size, model.config.canvas_length, rows = rows)
    torch.manual_seed(0)
    loss, _, metrics = DIFFUSION_GEMMA_PROFILE.compute_loss(model, batch, _args())
    assert torch.isfinite(loss) and loss.requires_grad
    assert float(metrics["encoder_ar_loss"]) == 0.0 and float(metrics["diffusion_loss"]) == 0.0


def test_reloaded_adapter_still_refuses_merge(tmp_path):
    from peft import LoraConfig, get_peft_model

    from unsloth import FastModel

    m = transformers.DiffusionGemmaForBlockDiffusion.from_pretrained(TINY, dtype = torch.float32)
    m = get_peft_model(
        m, LoraConfig(r = 4, target_modules = DIFFUSION_GEMMA_PROFILE.lora_target_modules)
    )
    m.save_pretrained(tmp_path)
    reloaded, _ = FastModel.from_pretrained(str(tmp_path), dtype = torch.float32, device_map = "cpu")
    with pytest.raises(RuntimeError, match = "share base weights"):
        reloaded.merge_and_unload()
    # The objective reads its token bookkeeping from the unwrapped module.
    from unsloth.models.diffusion_profiles import unwrap_diffusion_model

    assert "_unsloth_diffusion_eos_token_id" in vars(unwrap_diffusion_model(reloaded))


def test_reload_uses_the_adapters_saved_tokenizer(tmp_path):
    from peft import LoraConfig, get_peft_model

    from unsloth import FastModel

    m = transformers.DiffusionGemmaForBlockDiffusion.from_pretrained(TINY, dtype = torch.float32)
    m = get_peft_model(
        m, LoraConfig(r = 4, target_modules = DIFFUSION_GEMMA_PROFILE.lora_target_modules)
    )
    m.save_pretrained(tmp_path)
    tokenizer = transformers.AutoTokenizer.from_pretrained(TINY)
    tokenizer.chat_template = "{{ 'adapter-template-marker' }}"
    tokenizer.save_pretrained(tmp_path)
    _, reloaded = FastModel.from_pretrained(str(tmp_path), dtype = torch.float32, device_map = "cpu")
    reloaded = getattr(reloaded, "tokenizer", reloaded)
    assert "adapter-template-marker" in (reloaded.chat_template or "")


def test_diffusion_load_restores_progress_bars():
    from huggingface_hub.utils import are_progress_bars_disabled, enable_progress_bars

    from unsloth import FastModel

    enable_progress_bars()
    FastModel.from_pretrained(TINY, dtype = torch.float32, device_map = "cpu")
    assert not are_progress_bars_disabled()


@pytest.mark.skipif(not has_real_cuda(), reason = "bitsandbytes needs a GPU")
def test_caller_quantization_config_is_kept():
    from transformers import BitsAndBytesConfig

    from unsloth import FastModel

    qcfg = BitsAndBytesConfig(load_in_4bit = True, bnb_4bit_quant_type = "fp4")
    m, _ = FastModel.from_pretrained(TINY, quantization_config = qcfg, load_in_4bit = True)
    assert m.config.quantization_config.bnb_4bit_quant_type == "fp4"


def test_self_conditioning_off_skips_the_conditioning_pass(model):
    batch = _batch(model.config.text_config.vocab_size, model.config.canvas_length)
    calls = []
    hook = model.register_forward_pre_hook(lambda *a: calls.append(1))
    try:
        torch.manual_seed(0)
        DIFFUSION_GEMMA_PROFILE.compute_loss(model, batch, _args(diffusion_self_conditioning_p = 0.0))
    finally:
        hook.remove()
    assert len(calls) == 1


def test_full_finetuning_skips_lora():
    from unsloth import FastModel

    m, _ = FastModel.from_pretrained(
        TINY, dtype = torch.float32, device_map = "cpu", full_finetuning = True
    )
    assert FastModel.get_peft_model(m, r = 4) is m
    assert not any("lora_" in name for name, _ in m.named_parameters())


def test_caller_config_is_the_one_loaded():
    from unsloth import FastModel

    config = transformers.AutoConfig.from_pretrained(TINY)
    config.unsloth_test_marker = 7
    m, _ = FastModel.from_pretrained(TINY, config = config, dtype = torch.float32, device_map = "cpu")
    assert getattr(m.config, "unsloth_test_marker", None) == 7