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
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.tsindex 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.tsxindex 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 continuesdiff --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.tsindex 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.tsindex 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 firsfits,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 firsflux3,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 firsorder(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", () => {