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 { authFetch } from "@/features/auth";
import { readFastApiError } from "@/lib/format-fastapi-error";
export type KeylessApiAccessScope = "off" | "inference" | "full";
export type KeylessApiAccessExposure =
| "colab"
| "public_url"
| "private_lan"
| "network";
export type KeylessApiAccessSettings = {
scope: KeylessApiAccessScope;
tools: boolean;
exposure: KeylessApiAccessExposure | null;
/** a managed account turns keyless off install-wide, whatever scope is saved */
suspendedByAccounts: boolean;
};
type ApiKeylessApiAccessSettings = {
scope: KeylessApiAccessScope;
tools: boolean;
exposure?: KeylessApiAccessExposure | null;
// biome-ignore lint/style/useNamingConvention: API schema
suspended_by_accounts?: boolean | null;
};
function fromApi(
settings: ApiKeylessApiAccessSettings,
): KeylessApiAccessSettings {
return {
scope: settings.scope,
tools: settings.tools,
exposure: settings.exposure ?? null,
suspendedByAccounts: settings.suspended_by_accounts === true,
};
}
export async function loadKeylessApiAccess(): Promise<KeylessApiAccessSettings> {
const res = await authFetch("/api/settings/keyless-api-access");
if (!res.ok) {
throw new Error(
await readFastApiError(res, "Failed to load keyless API access settings"),
);
}
return fromApi(await res.json());
}
export async function updateKeylessApiAccess(
scope: KeylessApiAccessScope,
tools?: boolean,
): Promise<KeylessApiAccessSettings> {
const res = await authFetch("/api/settings/keyless-api-access", {
method: "PUT",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({ scope, tools: tools ?? null }),
});
if (!res.ok) {
throw new Error(
await readFastApiError(
res,
"Failed to update keyless API access settings",
),
);
}
return fromApi(await res.json());
}
export function keylessAudience(
exposure: KeylessApiAccessExposure | null,
): string {
switch (exposure) {
case "public_url":
return "Anyone with your public URL";
case "network":
case "private_lan":
return "Anyone on your network";
case "colab":
return "Anyone who can reach this Colab runtime";
default:
return "Anything running on this computer";
}
}