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 Hub: Recommended lists safetensors repos only past 30 likes, always open on Discover (#13886)

Michael Han186a9bfeb10e
diff --git a/studio/frontend/src/features/hub/hub-page.tsx b/studio/frontend/src/features/hub/hub-page.tsx
index 8070a1c403b..9922528ad13 100644
--- a/studio/frontend/src/features/hub/hub-page.tsx
+++ b/studio/frontend/src/features/hub/hub-page.tsx
@@ -133,6 +133,7 @@ import {
buildDiscoverRows,
detectResultFormat,
discoveryInventorySignature,
+ hasRecommendedCheckpointLikes,
isUnslothFinetunable,
matchesHubCapability,
matchesFormat,
@@ -157,7 +158,6 @@ import type {
const NO_SEARCH_FILTERS: ModelSearchFilters = {};
const UNSLOTH_UPLOADER: readonly HubUploader[] = ["unsloth"];
-const MODELS_TAB_STORAGE_KEY = "unsloth.hub.modelsTab";
const ALL_MODELS_VIEW_STORAGE_KEY = "unsloth.hub.allModelsView";
const INVENTORY_SORT_STORAGE_KEY = "unsloth.hub.inventorySort";
const RUN_CONFIG_REFRESH_TIMEOUT_MS = 5_000;
@@ -237,29 +237,6 @@ function buildFocusedHeading({
return isDataset ? "Datasets" : "Models";
}
-function readModelsTabPreference(): ModelsTab | null {
- if (typeof window === "undefined") {
- return null;
- }
- try {
- const value = window.localStorage.getItem(MODELS_TAB_STORAGE_KEY);
- return value === "discover" || value === "downloaded" ? value : null;
- } catch {
- return null;
- }
-}
-
-function writeModelsTabPreference(tab: ModelsTab): void {
- if (typeof window === "undefined") {
- return;
- }
- try {
- window.localStorage.setItem(MODELS_TAB_STORAGE_KEY, tab);
- } catch {
- return;
- }
-}
-
// "All models" defaults to split layout; the choice persists across sessions.
function readAllModelsViewPreference(): AllModelsView {
if (typeof window === "undefined") {
@@ -321,12 +298,8 @@ function useModelsTabState(): {
const navigate = useNavigate();
const search = useSearch({ from: "/hub" });
const urlTab: ModelsTab | null = search.tab ?? null;
- const hasModelDeepLink =
- typeof search.model === "string" && search.model.length > 0;
- const [fallbackTab, setFallbackTab] = useState<ModelsTab>(
- () => readModelsTabPreference() ?? "discover",
- );
- const tab = urlTab ?? (hasModelDeepLink ? "discover" : fallbackTab);
+ // Opening the Hub without an explicit ?tab= always lands on Discover; the last tab is not remembered.
+ const tab = urlTab ?? "discover";
useEffect(() => {
if (urlTab !== null) return;
@@ -339,8 +312,6 @@ function useModelsTabState(): {
const setTab = useCallback(
(next: ModelsTab) => {
- setFallbackTab(next);
- writeModelsTabPreference(next);
void navigate({
to: "/hub",
search: (prev) => ({
@@ -1112,12 +1083,15 @@ export function ModelsPage() {
(row) =>
!isHiddenModelId(row.id) &&
!isConfiguredHiddenModelId(hiddenEmbeddingModelIds, row.id) &&
- // Recommended curates browsing to logo'd models plus well-liked iconless ones; a typed
- // search and every other format show all matches.
+ // Recommended curates browsing to logo'd models plus well-liked iconless ones, and to
+ // well-liked checkpoints; a typed search and every other format show all matches.
(effectiveDiscoverFormat !== "recommended" ||
hasQuery ||
resolveOwnerProviderLogo(row.owner, row.repo) !== null ||
(row.result.likes ?? 0) >= MIN_ICONLESS_MODEL_LIKES) &&
+ (effectiveDiscoverFormat !== "recommended" ||
+ hasQuery ||
+ hasRecommendedCheckpointLikes(row.result)) &&
(effectiveDiscoverFormat === "recommended"
? matchesRecommended(
row.result,
@@ -1179,6 +1153,8 @@ export function ModelsPage() {
!isConfiguredHiddenModelId(hiddenEmbeddingModelIds, row.id),
)
.filter((row) => matchesFormat(row.result.isGguf, "gguf"))
+ // Catches low-like safetensors repos cross-tagged "gguf" for a stray .gguf export.
+ .filter((row) => hasRecommendedCheckpointLikes(row.result))
// Same fit filter as the main Discover list, so the feed carousel honors the toggle too.
.filter(
(row) =>
diff --git a/studio/frontend/src/features/hub/lib/format-filters.ts b/studio/frontend/src/features/hub/lib/format-filters.ts
index b6daa35f444..c566cb0a747 100644
--- a/studio/frontend/src/features/hub/lib/format-filters.ts
+++ b/studio/frontend/src/features/hub/lib/format-filters.ts
@@ -1,6 +1,8 @@
// SPDX-License-Identifier: AGPL-3.0-only
// Copyright 2026-present the Unsloth AI Inc. team. All rights reserved. See /studio/LICENSE.AGPL-3.0
+import { isGgufLike } from "./model-identifiers.ts";
+
export type FormatFilterModelFormat =
| "gguf"
| "safetensors"
@@ -97,6 +99,23 @@ export function matchesRecommended(
return format !== null && checkpointQuantFormats.includes(format);
}
+// Recommended browsing lists every GGUF but only checkpoints with more than this many likes.
+export const MIN_RECOMMENDED_CHECKPOINT_LIKES = 30;
+
+export function hasRecommendedCheckpointLikes(result: {
+ id: string;
+ isGguf: boolean;
+ likes?: number;
+ tags?: readonly string[];
+}): boolean {
+ // A safetensors repo that also ships a stray .gguf is still tagged "gguf"; its weights are safetensors.
+ const isGgufRepo =
+ isGgufLike(result.id) ||
+ (result.isGguf &&
+ !result.tags?.some((tag) => tag.toLowerCase() === "safetensors"));
+ return isGgufRepo || (result.likes ?? 0) > MIN_RECOMMENDED_CHECKPOINT_LIKES;
+}
+
// Inference-only quant formats Unsloth cannot fine-tune. Matched on the repo
// name since the search listing often omits the quant config.
const NON_FINETUNABLE_NAME =
diff --git a/studio/frontend/src/features/hub/lib/view-models.ts b/studio/frontend/src/features/hub/lib/view-models.ts
index df4843e160d..ee132ae58be 100644
--- a/studio/frontend/src/features/hub/lib/view-models.ts
+++ b/studio/frontend/src/features/hub/lib/view-models.ts
@@ -25,6 +25,7 @@ import {
} from "./model-capabilities";
export {
detectResultFormat,
+ hasRecommendedCheckpointLikes,
isUnslothFinetunable,
matchesFormat,
matchesRecommended,
diff --git a/studio/frontend/tests/hub-default-tab.test.ts b/studio/frontend/tests/hub-default-tab.test.ts
new file mode 100644
index 00000000000..716a3fa2fa6
--- /dev/null
+++ b/studio/frontend/tests/hub-default-tab.test.ts
@@ -0,0 +1,13 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright 2026-present the Unsloth AI Inc. team. All rights reserved. See /studio/LICENSE.AGPL-3.0
+
+import assert from "node:assert/strict";
+import test from "node:test";
+
+import { readSrcAsync } from "./helpers/kit.ts";
+
+test("the Hub opens on Discover unless the URL names a tab", async () => {
+ const page = await readSrcAsync("features/hub/hub-page.tsx");
+ assert.match(page, /const tab = urlTab \?\? "discover";/);
+ assert.doesNotMatch(page, /unsloth\.hub\.modelsTab/);
+});
diff --git a/studio/frontend/tests/hub-recommended-format.test.ts b/studio/frontend/tests/hub-recommended-format.test.ts
index 6375ad4dc2e..5781054bbea 100644
--- a/studio/frontend/tests/hub-recommended-format.test.ts
+++ b/studio/frontend/tests/hub-recommended-format.test.ts
@@ -6,6 +6,7 @@ import test from "node:test";
import {
checkpointQuantFormat,
+ hasRecommendedCheckpointLikes,
matchesFormat,
matchesRecommended,
} from "../src/features/hub/lib/format-filters.ts";
@@ -63,6 +64,40 @@ test("Recommended lists every GGUF and only the checkpoints this GPU runs native
assert.equal(matchesRecommended(nvfp4, ["fp8", "nvfp4"]), true);
});
+test("Recommended browsing lists checkpoints only past 30 likes", async () => {
+ assert.equal(hasRecommendedCheckpointLikes({ ...gguf, likes: 0 }), true);
+ assert.equal(hasRecommendedCheckpointLikes(fp8), false);
+ assert.equal(hasRecommendedCheckpointLikes({ ...fp8, likes: 30 }), false);
+ assert.equal(hasRecommendedCheckpointLikes({ ...fp8, likes: 31 }), true);
+ // Safetensors repo cross-tagged "gguf" for a stray .gguf file (Nemotron-3.5-Bolt-74B-A9B).
+ const crossTagged = {
+ id: "unsloth/NVIDIA-Nemotron-3.5-Bolt-74B-A9B",
+ isGguf: true,
+ tags: ["transformers", "safetensors", "gguf"],
+ };
+ assert.equal(
+ hasRecommendedCheckpointLikes({ ...crossTagged, likes: 2 }),
+ false,
+ );
+ assert.equal(
+ hasRecommendedCheckpointLikes({ ...crossTagged, likes: 31 }),
+ true,
+ );
+ assert.equal(
+ hasRecommendedCheckpointLikes({ ...gguf, tags: ["safetensors", "gguf"] }),
+ true,
+ );
+ const page = await readSrcAsync("features/hub/hub-page.tsx");
+ assert.match(
+ page,
+ /effectiveDiscoverFormat !== "recommended" \|\|\s*hasQuery \|\|\s*hasRecommendedCheckpointLikes\(row\.result\)/,
+ );
+ assert.match(
+ page,
+ /matchesFormat\(row\.result\.isGguf, "gguf"\)\)[\s\S]{0,200}\.filter\(\(row\) => hasRecommendedCheckpointLikes\(row\.result\)\)/,
+ );
+});
+
test("the GGUF filter stays a plain format match", () => {
assert.equal(matchesFormat("gguf", "gguf"), true);
assert.equal(matchesFormat("safetensors", "gguf"), false);