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.

Studio: keep the FLUX.3 Image Klein GGUF row under its Fast FP8 row at the top of the Images picker (#14197)

Daniel Hand5e700bb43b1
diff --git a/studio/frontend/src/features/model-picker/components/model-selector/model-catalog.ts b/studio/frontend/src/features/model-picker/components/model-selector/model-catalog.ts
index f02135b5607..8588d2bc4e5 100644
--- a/studio/frontend/src/features/model-picker/components/model-selector/model-catalog.ts
+++ b/studio/frontend/src/features/model-picker/components/model-selector/model-catalog.ts
@@ -91,6 +91,9 @@ export interface CatalogGroup {
capabilities?: Partial<ModelCapabilities>;
/** Leads the Recommended list whatever the dropdown sort, in catalog order among pinned groups. */
pinToTop?: boolean;
+ /** With `pinToTop`: every row of this group (its GGUF too) leads before the next pinned group's
+ * rows, instead of interleaving lead rows first. */
+ pinRowsTogether?: boolean;
}
@@ -238,7 +241,7 @@ export const IMAGE_CATALOG: CatalogGroup[] = [
},
{
// FLUX.3 Image Klein (distilled): text to image and up to 10 reference images. Pinned first, so its
- // "Fast FP8" row leads the list above Qwen-Image 2.1's. The bf16 row keeps the gated BFL id; the backend
+ // "Fast FP8" and GGUF rows lead the list above Qwen-Image 2.1's. The bf16 row keeps the gated BFL id; the backend
// fetches it from unsloth/flux-3-image-klein-FP8, which carries the official diffusers folders
// byte-identical beside the FP8 / INT8 checkpoints. The GGUFs pair with the same repo for the Qwen3-VL
// text encoder and the FLUX.2 VAE.
@@ -249,6 +252,8 @@ export const IMAGE_CATALOG: CatalogGroup[] = [
// Same reason as Qwen-Image 2.1's alias: the int8 half of the prequant repo has no artifact row.
aliases: ["unsloth/flux-3-image-klein-FP8"],
pinToTop: true,
+ // Its GGUF row sits right under the Fast FP8 one, above Qwen-Image 2.1's rows.
+ pinRowsTogether: true,
artifacts: [
// Resident bf16 GiB, as the fit rule reads it: 10.34 DiT + 8.27 Qwen3-VL-4B + 0.31 VAE.
bf16Pipeline("black-forest-labs/flux-3-image-klein", 18.92, {
diff --git a/studio/frontend/src/features/model-picker/components/model-selector/pickers.tsx b/studio/frontend/src/features/model-picker/components/model-selector/pickers.tsx
index 0171be53f14..1c315fd8770 100644
--- a/studio/frontend/src/features/model-picker/components/model-selector/pickers.tsx
+++ b/studio/frontend/src/features/model-picker/components/model-selector/pickers.tsx
@@ -4091,6 +4091,9 @@ export function HubModelPicker({
pinnedFamilies: catalog
?.filter((g) => g.pinToTop)
.map((g) => g.canonicalId.toLowerCase()),
+ pinnedTogether: catalog
+ ?.filter((g) => g.pinToTop && g.pinRowsTogether)
+ .map((g) => g.canonicalId.toLowerCase()),
});
if (!communityRecommendedEnabled) return unslothRows;
// Appended below everything unsloth publishes, so scrolling past the unsloth uploads continues
diff --git a/studio/frontend/src/features/model-picker/components/model-selector/recommended-fit.ts b/studio/frontend/src/features/model-picker/components/model-selector/recommended-fit.ts
index 61a8098424b..88656b86d86 100644
--- a/studio/frontend/src/features/model-picker/components/model-selector/recommended-fit.ts
+++ b/studio/frontend/src/features/model-picker/components/model-selector/recommended-fit.ts
@@ -457,6 +457,9 @@ export function orderRecommendedRows<
/** Family keys (as returned by `familyOf`) that lead the list in this order, whatever the sort.
* Their rows interleave by position: every pinned family's first row, then every second one. */
pinnedFamilies?: readonly string[];
+ /** Pinned family keys whose rows stay together instead of interleaving: all of them come before
+ * the next pinned family's, so a GGUF sits right under its own lead row. */
+ pinnedTogether?: readonly string[];
}): T[] {
const {
seeds,
@@ -466,6 +469,7 @@ export function orderRecommendedRows<
fits,
familyOf,
pinnedFamilies = [],
+ pinnedTogether = [],
} = opts;
const seedById = new Map(seeds.map((s) => [s.id, s]));
const rows = results.filter(keep).map((row) => {
@@ -505,6 +509,7 @@ export function orderRecommendedRows<
if (!firstSeen.has(key)) firstSeen.set(key, i);
});
const pinIndex = new Map(pinnedFamilies.map((key, i) => [key, i]));
+ const together = new Set(pinnedTogether);
// Row position within its family: pinned families' lead rows ("Fast FP8") come before their GGUFs.
const slotOf = new Map<number, number>();
const seenPerFamily = new Map<string, number>();
@@ -519,7 +524,10 @@ export function orderRecommendedRows<
// Pinned families lead, ahead of first-party rows that trend higher.
const pin = pinIndex.get(key);
if (pin != null) {
- return [slotOf.get(i) ?? 0, pin, 0, firstSeen.get(key) ?? i, i];
+ const slot = slotOf.get(i) ?? 0;
+ return together.has(key)
+ ? [0, pin, slot, firstSeen.get(key) ?? i, i]
+ : [slot, pin, 0, firstSeen.get(key) ?? i, i];
}
const ours = firstParty(r.id);
const unranked = ours && !listable.has(key) ? -1 : Infinity;
diff --git a/studio/frontend/tests/recommended-catalog-seeds.test.ts b/studio/frontend/tests/recommended-catalog-seeds.test.ts
index 4af52dbd584..36260c995b0 100644
--- a/studio/frontend/tests/recommended-catalog-seeds.test.ts
+++ b/studio/frontend/tests/recommended-catalog-seeds.test.ts
@@ -629,6 +629,10 @@ test("pinned families lead Recommended whatever the listing sort, lead rows firs
"unsloth/qwen-image-2.1",
"qwen/qwen-image-2.1-turbo",
]);
+ const pinnedTogether = IMAGE_CATALOG.filter((g) => g.pinToTop && g.pinRowsTogether).map((g) =>
+ g.canonicalId.toLowerCase(),
+ );
+ assert.deepEqual(pinnedTogether, ["black-forest-labs/flux-3-image-klein"]);
const flux3 = "black-forest-labs/flux-3-image-klein";
const flux3Gguf = "unsloth/flux-3-image-klein-GGUF";
const flux3Base = "black-forest-labs/flux-3-image-klein-base";
@@ -657,7 +661,11 @@ test("pinned families lead Recommended whatever the listing sort, lead rows firs
{ id: qwen21Gguf, isGguf: true },
{ id: flux3Gguf, isGguf: true },
];
- const order = (pinned?: readonly string[], fits: (r: Row) => boolean = () => true) =>
+ const order = (
+ pinned?: readonly string[],
+ fits: (r: Row) => boolean = () => true,
+ together?: readonly string[],
+ ) =>
ids(
orderRecommendedRows({
seeds,
@@ -667,6 +675,7 @@ test("pinned families lead Recommended whatever the listing sort, lead rows firs
fits,
familyOf: family,
pinnedFamilies: pinned,
+ pinnedTogether: together,
}),
);
// Unpinned, the listing sorts them and the vendor-hosted pipelines trail the first-party rows.
@@ -681,8 +690,7 @@ test("pinned families lead Recommended whatever the listing sort, lead rows firs
flux3,
flux3Base,
]);
- // "FLUX.3 Image Klein (Fast FP8)" on top, then "Qwen-Image 2.1 (Fast FP8)" and "Qwen-Image 2.1 Turbo
- // (Fast FP8)", then their GGUF rows. The unpinned Base keeps its place among the other models.
+ // Interleaved pins: every lead row ("Fast FP8") first, then every GGUF row.
assert.deepEqual(order(pinnedFamilies), [
flux3,
qwen21,
@@ -699,6 +707,26 @@ test("pinned families lead Recommended whatever the listing sort, lead rows firs
order(pinnedFamilies, (r) => Boolean(r.isGguf)),
[flux3Gguf, qwen21Gguf, turboGguf, qwen2512, zImageTurbo],
);
+ // As shipped: "FLUX.3 Image Klein (Fast FP8)" on top with its GGUF right under it, then "Qwen-Image 2.1
+ // (Fast FP8)" and "Qwen-Image 2.1 Turbo (Fast FP8)", then their GGUF rows. The unpinned Base keeps its
+ // place among the other models.
+ assert.deepEqual(order(pinnedFamilies, () => true, pinnedTogether), [
+ flux3,
+ flux3Gguf,
+ qwen21,
+ turbo,
+ qwen21Gguf,
+ turboGguf,
+ qwen2512,
+ zImageTurbo,
+ flux3Base,
+ ]);
+ assert.deepEqual(
+ order(pinnedFamilies, (r) => Boolean(r.isGguf), pinnedTogether),
+ [flux3Gguf, qwen21Gguf, turboGguf, qwen2512, zImageTurbo],
+ );
+ // A family listed as together but not pinned is not lifted.
+ assert.deepEqual(order(undefined, () => true, pinnedTogether), order());
});
test("an empty Recommended list names a failed search or unreachable hub, not an empty catalog", () => {