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
// 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 { fetchDeviceType } from "@/config/env";
import { authFetch } from "@/features/auth";
import { clearDownloadTransportCapabilitiesCache } from "@/features/hub/download-manager/api";
import { markRemoteNetworkOnline } from "@/features/hub/lib/network";
import { readFastApiError } from "@/lib/format-fastapi-error";
import type { HubSource } from "@/lib/hf-endpoint";
import { loadDownloadTransportSettings } from "./download-transport";
export type HubSettings = {
hfEndpoint: string;
datasetsServerFollowsEndpoint: boolean;
source: HubSource;
activeSource: HubSource;
};
type ApiHubSettings = {
// biome-ignore lint/style/useNamingConvention: API schema
hf_endpoint: string;
// biome-ignore lint/style/useNamingConvention: API schema
datasets_server_follows_endpoint: boolean;
source: HubSource;
// biome-ignore lint/style/useNamingConvention: API schema
active_source: HubSource;
};
function fromApi(settings: ApiHubSettings): HubSettings {
return {
hfEndpoint: settings.hf_endpoint,
datasetsServerFollowsEndpoint: settings.datasets_server_follows_endpoint,
source: settings.source,
activeSource: settings.active_source,
};
}
export async function loadHubSettings(): Promise<HubSettings> {
const res = await authFetch("/api/settings/hub");
if (!res.ok) {
throw new Error(await readFastApiError(res, "Failed to load hub settings"));
}
return fromApi(await res.json());
}
async function followSavedEndpoints(): Promise<void> {
await fetchDeviceType({ force: true }).catch(() => undefined);
// Backoffs were recorded against the old endpoints.
markRemoteNetworkOnline();
}
export class InvalidHubEndpointError extends Error {}
export async function updateHubSource(source: HubSource): Promise<HubSettings> {
const res = await authFetch("/api/settings/hub/source", {
method: "PUT",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({ source }),
});
if (!res.ok) {
throw new Error(await readFastApiError(res, "Failed to switch the model source"));
}
const saved = fromApi(await res.json());
clearDownloadTransportCapabilitiesCache();
// Its event also refreshes the hub's mounted transport toggle.
await loadDownloadTransportSettings({ refresh: true }).catch(() => undefined);
await followSavedEndpoints();
return saved;
}
/** Granted once per install, and it saves the choice. Fails closed. */
export async function claimHubSourceNotice(): Promise<boolean> {
try {
const res = await authFetch(
"/api/settings/hub/source-notice",
{ method: "POST" },
// A retried claim whose first attempt landed would come back denied.
{ retryNetworkErrors: false },
);
if (!res.ok) return false;
const body = (await res.json()) as { granted?: unknown };
return body.granted === true;
} catch {
return false;
}
}
export type HubEndpointSettings = Pick<
HubSettings,
"hfEndpoint" | "datasetsServerFollowsEndpoint"
>;
export async function updateHubSettings(
settings: HubEndpointSettings,
): Promise<HubSettings> {
const res = await authFetch("/api/settings/hub", {
method: "PUT",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
// biome-ignore lint/style/useNamingConvention: API schema
hf_endpoint: settings.hfEndpoint,
// biome-ignore lint/style/useNamingConvention: API schema
datasets_server_follows_endpoint: settings.datasetsServerFollowsEndpoint,
}),
});
if (!res.ok) {
const message = await readFastApiError(res, "Failed to save hub settings");
throw res.status === 400 || res.status === 422
? new InvalidHubEndpointError(message)
: new Error(message);
}
const saved = fromApi(await res.json());
await followSavedEndpoints();
return saved;
}