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 / Desktop: log what an image load and each generation actually resolved to (#11994)

Leo Borcherding2c1830830064
diff --git a/studio/backend/core/inference/diffusion.py b/studio/backend/core/inference/diffusion.py
index 41204cd2676..f51a1de2358 100644
--- a/studio/backend/core/inference/diffusion.py
+++ b/studio/backend/core/inference/diffusion.py
@@ -229,6 +229,8 @@ from .diffusion_auto_policy import (
base_repo_bf16_components_gb,
build_resolved_record,
estimate_dense_quant,
+ format_generation_for_log,
+ format_resolved_for_log,
family_bf16_components_gb,
precision_fallback_allowed,
precision_refusal_message,
@@ -6883,12 +6885,14 @@ class DiffusionBackend:
logger.info(
# The estimates too: the verdict alone cannot be checked from a user's log, and a None among these terms
# is itself the explanation for a tier the planner skipped.
- "diffusion.loaded: repo=%s base=%s device=%s offload=%s tiling=%s reasons=%s estimates=%s",
+ "diffusion.loaded: repo=%s base=%s device=%s offload=%s tiling=%s resolved=[%s] reasons=%s "
+ "estimates=%s",
repo_id,
base,
device,
effective_policy,
effective_tiling,
+ format_resolved_for_log(state.resolved),
"; ".join(plan.reasons),
plan.estimates,
)
@@ -8504,6 +8508,9 @@ class DiffusionBackend:
f"Use a smaller source image."
)
init_pil = init_pil.resize((tw, th), Image.LANCZOS)
+ upscale = round(
+ max(tw / iw, th / ih), 2
+ ) # the factor after both caps, for the log
if strength is None:
strength = 0.35 # hires-fix default: preserve content, add detail
elif getattr(fam, "reference", False) and init_image is not None:
@@ -8959,7 +8966,7 @@ class DiffusionBackend:
reclaim_offload_host_memory(state.offload_policy, logger = logger)
# Count the finished generation (drives deferred speed); a batch is one generation.
object.__setattr__(state, "generation_count", state.generation_count + 1)
- return {
+ result = {
"images": list(images),
"seed": int(seed),
"seeds": [int(s) for s in per_image_seeds],
@@ -8985,6 +8992,17 @@ class DiffusionBackend:
"reference_resolution": ref_resolution,
"localized_edit": localized_edit.mode if localized_edit is not None else None,
}
+ logger.info(
+ "diffusion.generated: %s",
+ format_generation_for_log(
+ result,
+ engine = "diffusers",
+ steps = steps,
+ strength = strength_applied,
+ upscale = upscale if workflow == "upscale" else None,
+ ),
+ )
+ return result
finally:
if static_skip_pipe is not None:
try:
diff --git a/studio/backend/core/inference/diffusion_auto_policy.py b/studio/backend/core/inference/diffusion_auto_policy.py
index 9db1b41d13e..eb2053eb7fa 100644
--- a/studio/backend/core/inference/diffusion_auto_policy.py
+++ b/studio/backend/core/inference/diffusion_auto_policy.py
@@ -528,3 +528,46 @@ def build_resolved_record(controls: dict[str, tuple]) -> dict[str, dict[str, Any
"reason": reason,
}
return record
+
+
+def format_resolved_for_log(record: Optional[dict[str, dict[str, Any]]]) -> str:
+ """Resolved record as one ``name=value(source)`` log line."""
+ parts = []
+ for name, entry in (record or {}).items():
+ value = entry.get("value")
+ if entry.get("source") == "auto":
+ note = "auto"
+ else:
+ note = f"requested {entry.get('requested')}"
+ if entry.get("status") != RESOLVED_APPLIED:
+ note += f", {entry.get('status')}"
+ parts.append(f"{name}={value}({note})")
+ return " ".join(parts)
+
+
+def format_generation_for_log(
+ result: dict[str, Any],
+ *,
+ engine: str,
+ steps: Any = None,
+ strength: Any = None,
+ upscale: Any = None,
+ loras: Any = None,
+) -> str:
+ """One-line log summary of a generate() result."""
+ images = result.get("images") or ()
+ size = getattr(images[0], "size", None) if images else None
+ fields = {
+ "engine": engine,
+ "workflow": result.get("workflow"),
+ "images": len(images),
+ "size": f"{size[0]}x{size[1]}" if size else None,
+ "seeds": result.get("seeds") or result.get("seed"),
+ "steps": steps,
+ "strength": strength,
+ "upscale": upscale,
+ "loras": loras or result.get("active_loras") or None,
+ "reference_resolution": result.get("reference_resolution"),
+ "localized_edit": result.get("localized_edit"),
+ }
+ return " ".join(f"{k}={v}" for k, v in fields.items() if v is not None)
diff --git a/studio/backend/core/inference/sd_cpp_backend.py b/studio/backend/core/inference/sd_cpp_backend.py
index 61115f69ae2..fcab6fc5ec5 100644
--- a/studio/backend/core/inference/sd_cpp_backend.py
+++ b/studio/backend/core/inference/sd_cpp_backend.py
@@ -30,6 +30,7 @@ from dataclasses import dataclass, field, replace
from pathlib import Path
from typing import Any, Optional
+from core.inference.diffusion_auto_policy import format_generation_for_log
from core.inference.diffusion_compat import flux2_inner_dim_for_pick
from core.inference.diffusion_device import (
resolve_diffusion_device_target,
@@ -2915,6 +2916,15 @@ class SdCppDiffusionBackend:
self._stop_reserved(orphan)
if superseded:
return
+ logger.info(
+ "sd_cpp.loaded: repo=%s gguf=%s device=%s mode=%s speed=%s offload_flags=%s",
+ state.repo_id,
+ state.gguf_filename,
+ state.device,
+ state.mode,
+ state.native_speed,
+ without_device_backend_flags(state.offload_flags) or "none",
+ )
except SdCppCancelled:
return
except Exception as exc: # noqa: BLE001 -- surfaced via load_progress
@@ -3588,7 +3598,7 @@ class SdCppDiffusionBackend:
if self._active_generate_cancel is cancel:
self._active_generate_cancel = None
self._active_generate_account = None
- return {
+ result = {
"images": images,
"seed": int(seed),
"seeds": seeds,
@@ -3615,6 +3625,17 @@ class SdCppDiffusionBackend:
if conditioned
else None,
}
+ logger.info(
+ "diffusion.generated: %s",
+ format_generation_for_log(
+ result,
+ engine = "sd_cpp",
+ steps = steps,
+ strength = strength,
+ loras = active_loras,
+ ),
+ )
+ return result
except SdCppCancelled as exc:
raise RuntimeError(DIFFUSION_CANCELLED_MSG) from exc
finally:
diff --git a/studio/backend/tests/test_diffusion_auto_policy.py b/studio/backend/tests/test_diffusion_auto_policy.py
index 2b906a59202..2b0abcdc5ef 100644
--- a/studio/backend/tests/test_diffusion_auto_policy.py
+++ b/studio/backend/tests/test_diffusion_auto_policy.py
@@ -601,3 +601,49 @@ def test_qwen_image_21_sizes_a_dense_quant_candidate():
est = estimate_dense_quant(fam, "fp8", base_repo = fam.base_repo, prequant_available = True)
assert est is not None, "no estimate means the pipeline seed is never chosen"
assert est.prequant and est.steady_transformer_mib > 0
+
+
+def test_resolved_log_line_shows_engaged_values_and_their_source():
+ record = build_resolved_record(
+ {
+ "transformer_quant": (None, "int8", "per-kind default"),
+ "text_encoder_quant": ("nvfp4", "nvfp4", "applied"),
+ "memory_mode": ("fast", "none", "fits"),
+ }
+ )
+ line = ap.format_resolved_for_log(record)
+ assert "transformer_quant=int8(auto)" in line
+ assert "text_encoder_quant=nvfp4(requested nvfp4)" in line
+ assert "memory_mode=none(requested fast)" in line
+
+
+def test_resolved_log_line_flags_a_declined_request():
+ record = build_resolved_record({"text_encoder_quant": ("nvfp4", "off", "no fp8 dtype")})
+ assert ap.format_resolved_for_log(record) == (
+ f"text_encoder_quant=off(requested nvfp4, {ap.RESOLVED_FELL_BACK})"
+ )
+ assert ap.format_resolved_for_log(None) == ""
+
+
+def test_generation_log_line_reads_the_recipe_fields():
+ result = {
+ "images": [SimpleNamespace(size = (1024, 768)), SimpleNamespace(size = (1024, 768))],
+ "seed": 7,
+ "seeds": [7, 8],
+ "workflow": "inpaint",
+ "active_loras": [["style", 0.8]],
+ "reference_resolution": None,
+ "localized_edit": None,
+ }
+ line = ap.format_generation_for_log(result, engine = "diffusers", steps = 30, strength = 0.6)
+ assert line == (
+ "engine=diffusers workflow=inpaint images=2 size=1024x768 seeds=[7, 8] steps=30 "
+ "strength=0.6 loras=[['style', 0.8]]"
+ )
+ assert "size" not in ap.format_generation_for_log({"images": []}, engine = "sd_cpp")
+
+
+def test_generation_log_line_prefers_the_engine_supplied_loras():
+ result = {"images": [], "seeds": [3], "workflow": "txt2img"}
+ line = ap.format_generation_for_log(result, engine = "sd_cpp", loras = [("style", 0.8)])
+ assert line == "engine=sd_cpp workflow=txt2img images=0 seeds=[3] loras=[('style', 0.8)]"