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.

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.py
index 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 True
if 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 model
return True
+ return not _present_class_below_floor(name, installed)
minimum, _needs_py310 = pipeline_class_requirement(name)
if minimum is None:
return True
diff --git a/studio/backend/tests/conftest.py b/studio/backend/tests/conftest.py
index e4c1b68f4a6..643c0746502 100644
--- a/studio/backend/tests/conftest.py
+++ b/studio/backend/tests/conftest.py
@@ -1373,8 +1373,16 @@ def healthy_diffusers(monkeypatch):
return object
raise 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__ = version
for 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.py
index 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")