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 {
clearChatBackground,
loadChatBackground,
loadChatBackgroundImage,
saveChatBackgroundAdjustments,
saveChatBackgroundImage,
} from "@/features/settings/api/device-sync";
import { sanitizeAdjustments } from "./model";
import { planBackgroundPull } from "./sync-plan";
import {
applyServerBackground,
backgroundRevision,
hydrateBackground,
readBackgroundSync,
recordUploadedImage,
setBackgroundChangeListener,
useBackgroundStore,
writeBackgroundSync,
} from "./storage";
const PUSH_DEBOUNCE_MS = 800;
let queue: Promise<void> = Promise.resolve();
let timer: ReturnType<typeof setTimeout> | undefined;
let changes = 0;
function enqueue(task: () => Promise<void>) {
queue = queue.then(task).catch(() => undefined);
return queue;
}
async function push() {
const started = changes;
const value = useBackgroundStore.getState().value;
if (!value) {
const record = await clearChatBackground();
if (changes === started)
await writeBackgroundSync({ dirty: false, updatedAt: record.updatedAt });
return;
}
let { sha256 } = await readBackgroundSync();
if (!sha256) {
sha256 = (await saveChatBackgroundImage(value.blob)).image?.sha256 ?? null;
await recordUploadedImage(value.blob, sha256);
}
const { blob: _blob, ...adjustments } = value;
const save = () =>
saveChatBackgroundAdjustments(adjustments).catch(async (error: unknown) => {
await recordUploadedImage(value.blob, null);
throw error;
});
let record = await save();
if (record.image?.sha256 !== sha256) {
sha256 = (await saveChatBackgroundImage(value.blob)).image?.sha256 ?? null;
record = await save();
}
await recordUploadedImage(value.blob, sha256);
if (changes === started)
await writeBackgroundSync({ dirty: false, updatedAt: record.updatedAt });
}
async function pull() {
const started = changes;
await hydrateBackground();
const revision = backgroundRevision();
const [remote, sync] = await Promise.all([
loadChatBackground(),
readBackgroundSync(),
]);
const local = useBackgroundStore.getState().value;
const plan = planBackgroundPull(remote, sync, Boolean(local));
if (plan === "push") return push();
if (plan === "keep") return;
const stamp = { updatedAt: remote.updatedAt, sha256: remote.image?.sha256 ?? null };
if (plan === "clear" || !remote.image) {
if (changes === started) await applyServerBackground(null, stamp, revision);
return;
}
const blob =
plan === "adjust" && local ? local.blob : await loadChatBackgroundImage();
if (changes !== started) return;
await applyServerBackground(
{ ...sanitizeAdjustments(remote.adjustments ?? {}), blob },
stamp,
revision,
);
}
export function startChatBackgroundSync(): () => void {
setBackgroundChangeListener(() => {
changes++;
clearTimeout(timer);
timer = setTimeout(() => void enqueue(push), PUSH_DEBOUNCE_MS);
});
void enqueue(pull);
return () => {
setBackgroundChangeListener(null);
clearTimeout(timer);
};
}