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.
Python agentaichatgptdeepseekfine-tuninggemmaimage-generationllamallmllmsopenaipythonqwenreinforcement-learningself-hostedstable-diffusiontext-to-speechttsuiunsloth
Unsloth Studio: refuse Cosmos3 on diffusers 0.39 and 0.40 instead of failing at load or generate (#16745)
Leo Borcherding6c486bd0cb9d
diff --git a/studio/backend/core/inference/diffusion_families.py b/studio/backend/core/inference/diffusion_families.pyindex 88f3d5a6f4d..3479706c219 100644--- a/studio/backend/core/inference/diffusion_families.py+++ b/studio/backend/core/inference/diffusion_families.py@@ -2400,7 +2400,7 @@ _DIFFUSERS_DROPPED_PY39 = "0.37.0"_DIFFUSERS_DROPPED_PY310 = "0.42.0"_MAX_PIPELINE_MANIFEST_BYTES = 1 << 20-# First diffusers release exporting each class; every probed class must be listed, since an unlisted one reads as available.+# Minimum diffusers per class, enforced even when the class is present; an unlisted class reads as available._PIPELINE_MIN_DIFFUSERS: dict[str, str] = {# MiniMax-H3 is judged by its transformer, first available in diffusers 0.40.0."MiniMaxH3Transformer3DModel": "0.40.0",@@ -2946,13 +2946,10 @@ def assert_pipeline_class_available(f"missing and install it.")- if present:+ installed = getattr(diffusers, "__version__", None)+ if present and not _present_class_below_floor(pipeline_class, installed):return- raise ValueError(- _too_old_message(- pipeline_class, family_name, str(getattr(diffusers, "__version__", "unknown"))- )- )+ raise ValueError(_too_old_message(pipeline_class, family_name, str(installed or "unknown")))def _module_namespace_is_unreadable(module: Any) -> bool:@@ -2991,6 +2988,20 @@ def _installed_at_least(installed: str, minimum: str) -> bool:return True+def _present_class_below_floor(pipeline_class: str, installed: Any) -> bool:+ """Probe-file classes and unreleased floors stay presence-judged: main builds report an older release."""+ minimum = _PIPELINE_MIN_DIFFUSERS.get(pipeline_class)+ if (+ minimum is None+ or minimum in _UNRELEASED_MIN_DIFFUSERS+ or pipeline_class in _PIPELINE_PROBE_FILES+ or not isinstance(installed, str)+ or not installed.strip()+ ):+ return False+ return not _installed_at_least(installed.strip(), minimum)++def family_probe_class(fam: Any) -> str:"""ModularPipeline is generic and predates families, so probe the transformer class; listing and both training gates must share it."""name = str(getattr(fam, "pipeline_class", "") or "")@@ -3024,9 +3035,12 @@ def family_pipeline_available(fam: Optional[DiffusionFamily]) -> bool:return Trueif not _module_namespace_is_unreadable(module):try:- return hasattr(module, name)+ if not hasattr(module, name):+ return False+ installed = getattr(module, "__version__", None)except Exception: # noqa: BLE001 -- a probe failure must not hide a modelreturn True+ return not _present_class_below_floor(name, installed)minimum, _needs_py310 = pipeline_class_requirement(name)if minimum is None:return Truediff --git a/studio/backend/tests/conftest.py b/studio/backend/tests/conftest.pyindex e4c1b68f4a6..643c0746502 100644--- a/studio/backend/tests/conftest.py+++ b/studio/backend/tests/conftest.py@@ -1373,8 +1373,16 @@ def healthy_diffusers(monkeypatch):return objectraise AttributeError(name)+ from core.inference import diffusion_families as _df++ # A present class below its floor is refused, so a healthy stand-in must also clear every floor.+ version = str(getattr(_real, "__version__", "0.39.0"))+ for floor in _df._PIPELINE_MIN_DIFFUSERS.values():+ if not _df._installed_at_least(version, floor):+ version = floor+proxy = _AnyPipeline("diffusers")- proxy.__version__ = str(getattr(_real, "__version__", "0.39.0"))+ proxy.__version__ = versionfor attr in ("__path__", "__file__", "__spec__", "__loader__"):if _real is not None and hasattr(_real, attr):setattr(proxy, attr, getattr(_real, attr))diff --git a/studio/backend/tests/test_video_cosmos3.py b/studio/backend/tests/test_video_cosmos3.pyindex 3f8fb8bb808..2cbd03d971f 100644--- a/studio/backend/tests/test_video_cosmos3.py+++ b/studio/backend/tests/test_video_cosmos3.py@@ -1132,6 +1132,75 @@ def test_rows_hide_on_a_diffusers_without_edges_native_flow_schedule(assert {df.family_pipeline_available(_fam(n)) for n in vf.COSMOS3_FAMILIES} == {available}+def _imported_diffusers(monkeypatch, version, *classes):+ module = types.ModuleType("diffusers")+ module.__version__ = version+ for name in classes:+ setattr(module, name, type(name, (), {"__module__": "diffusers.pipelines.fake"}))+ monkeypatch.setitem(sys.modules, "diffusers", module)+ return module+++ "installed, available",+ [+ ("0.39.0", False),+ ("0.40.0", False),+ ("0.41.0", True),+ ("0.41.0.dev0", True),+ ("0.42.1", True),+ ],+)+def test_an_imported_diffusers_below_the_floor_hides_cosmos3_even_though_it_exports_the_class(+ monkeypatch, installed, available+):+ from core.inference import diffusion_families as df+ _imported_diffusers(monkeypatch, installed, "Cosmos3OmniPipeline")+ assert {df.family_pipeline_available(_fam(n)) for n in vf.COSMOS3_FAMILIES} == {available}++[email protected]("installed", ["0.39.0", "0.40.0"])+def test_the_load_gate_refuses_cosmos3_on_a_diffusers_that_exports_it_below_the_floor(+ monkeypatch, installed+):+ from core.inference import diffusion_families as df++ _imported_diffusers(monkeypatch, installed, "Cosmos3OmniPipeline")+ with pytest.raises(ValueError, match = r"needs diffusers >= 0\.41\.0 \(Cosmos3OmniPipeline\)"):+ df.assert_pipeline_class_available("Cosmos3OmniPipeline", "cosmos3-edge")+ with pytest.raises(ValueError, match = rf"has diffusers {installed}\."):+ df.assert_pipeline_class_available("Cosmos3OmniPipeline", "cosmos3-edge", strict = True)++[email protected]("installed", ["0.41.0", "0.41.0.dev0", "0.42.1", "0.42.1+local"])+def test_the_load_gate_accepts_cosmos3_at_or_above_the_floor(monkeypatch, installed):+ from core.inference import diffusion_families as df++ _imported_diffusers(monkeypatch, installed, "Cosmos3OmniPipeline")+ df.assert_pipeline_class_available("Cosmos3OmniPipeline", "cosmos3-edge")+ df.assert_pipeline_class_available("Cosmos3OmniPipeline", "cosmos3-edge", strict = True)+++def test_the_floor_leaves_main_builds_judged_by_presence(monkeypatch):+ from core.inference import diffusion_families as df++ _imported_diffusers(monkeypatch, "0.41.0.dev0", "Flux3ModularPipeline", "Cosmos3OmniPipeline")+ df.assert_pipeline_class_available("Flux3ModularPipeline", "flux3")+ monkeypatch.setattr(df, "_UNRELEASED_MIN_DIFFUSERS", frozenset({"0.43.0"}))+ monkeypatch.setitem(df._PIPELINE_MIN_DIFFUSERS, "Cosmos3OmniPipeline", "0.43.0")+ df.assert_pipeline_class_available("Cosmos3OmniPipeline", "cosmos3-edge")+ assert df.family_pipeline_available(_fam("cosmos3-edge"))+++def test_an_unreadable_version_keeps_the_present_class_available(monkeypatch):+ from core.inference import diffusion_families as df++ module = _imported_diffusers(monkeypatch, "0.40.0", "Cosmos3OmniPipeline")+ del module.__version__+ df.assert_pipeline_class_available("Cosmos3OmniPipeline", "cosmos3-edge")+ assert df.family_pipeline_available(_fam("cosmos3-edge"))++_PIPELINE = ("model_index.json", "transformer/diffusion_pytorch_model.safetensors")_SHARDS = ("config.json", "model.safetensors.index.json", "model-00001-of-00002.safetensors")