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
export type SearchEngineId = "duckduckgo" | "google" | "bing" | "brave";
export const SEARCH_ENGINES: Record<SearchEngineId, { label: string; searchUrl: (query: string) => string }> = {
// Server-rendered, so it works without scripts.
duckduckgo: {
label: "DuckDuckGo",
searchUrl: (query) => `https://html.duckduckgo.com/html/?q=${encodeURIComponent(query)}`,
},
google: {
label: "Google",
searchUrl: (query) => `https://www.google.com/search?q=${encodeURIComponent(query)}`,
},
bing: {
label: "Bing",
searchUrl: (query) => `https://www.bing.com/search?q=${encodeURIComponent(query)}`,
},
brave: {
label: "Brave Search",
searchUrl: (query) => `https://search.brave.com/search?q=${encodeURIComponent(query)}`,
},
};
const SCHEME = /^[a-z][a-z\d+.-]*:\/\//i;
// A dotted host (optionally with port and path), no spaces: "unsloth.ai/docs/x", "пример.рф", "example.xn--p1ai".
const HOST_LIKE = /^(?:[\p{L}\p{N}_-]+\.)+(?:\p{L}{2,}|xn--[a-z\d-]+)(?::\d+)?(?:[/?#]\S*)?$/iu;
// File extensions that are not TLDs, so "llama.cpp" is a search (.py, .md and .rs are real TLDs).
const FILE_NAME = /^[^/?#:]+\.(?:cpp|jsx?|tsx?|jsonl?|html?|css|txt|csv|ya?ml|toml|ipynb|gguf|safetensors|bin|pdf|png|jpe?g)$/i;
const IPV4_LIKE = /^\d{1,3}(?:\.\d{1,3}){3}(?::\d+)?(?:[/?#]\S*)?$/;
const IPV6_LIKE = /^\[[\da-f:.]+\](?::\d+)?(?:[/?#]\S*)?$/i;
const LOOPBACK = /^(?:localhost|127(?:\.\d{1,3}){3}|\[::1\])(?::\d+)?(?:[/?#]\S*)?$/i;
/** What the address bar navigates to: a URL as typed, a bare host as https, anything else as a search. */
export function resolveAddress(input: string, engine: SearchEngineId): string | null {
const text = input.trim();
if (!text) return null;
if (SCHEME.test(text)) return text;
if (LOOPBACK.test(text)) return `http://${text}`;
if ((HOST_LIKE.test(text) && !FILE_NAME.test(text)) || IPV4_LIKE.test(text) || IPV6_LIKE.test(text)) return `https://${text}`;
return SEARCH_ENGINES[engine].searchUrl(text);
}
export function unwrapRedirect(url: string): string {
const target = redirectTarget(url);
// The hop's target is page-supplied; only follow it to another web page.
return target && isWebUrl(target) ? target : url;
}
function redirectTarget(url: string): string | null {
try {
const parsed = new URL(url);
const host = parsed.hostname.replace(/^www\./, "");
if ((host === "duckduckgo.com" || host.endsWith(".duckduckgo.com")) && parsed.pathname === "/l/") {
return parsed.searchParams.get("uddg");
}
// Google's own country domains, not google.com.evil.example (core/inference/browser_agent.py agrees).
if (/^google\.(?:[a-z]{2,3}|co\.[a-z]{2}|com\.[a-z]{2})$/.test(host) && parsed.pathname === "/url") {
return parsed.searchParams.get("q") ?? parsed.searchParams.get("url");
}
} catch {
// Not a URL; the fetch reports it.
}
return null;
}
export function isLoopbackUrl(url: string): boolean {
try {
const { protocol, hostname } = new URL(url);
return /^https?:$/.test(protocol) && /^(?:localhost|127(?:\.\d+){3}|\[::1\])$/.test(hostname);
} catch {
return false;
}
}
export function localOriginOf(url: string): string | null {
return isLoopbackUrl(url) ? new URL(url).origin : null;
}
export function isWebUrl(url: string): boolean {
return /^https?:\/\//i.test(url);
}
export function fileNameFromUrl(url: string): string {
try {
const { pathname, hostname } = new URL(url);
const raw = pathname.split("/").filter(Boolean).pop() ?? "";
let last = raw;
try {
last = decodeURIComponent(raw);
} catch {
}
return last || hostname;
} catch {
return url;
}
}
/** Bidi controls out, so `x\u202efdp.exe` can't read as `xexe.pdf` where it is shown or saved. */
export function safeDownloadName(name: string): string {
return name.replace(/[\u061c\u200e\u200f\u202a-\u202e\u2066-\u2069]/g, "_");
}
export function hostOf(url: string): string {
try {
return new URL(url).hostname.replace(/^www\./, "");
} catch {
return url;
}
}
/** A fetched page with its base URL put back, so a saved copy's relative links still resolve. */
export function withBaseUrl(html: string, base: string): string {
const tag = `<base href="${base.replace(/&/g, "&").replace(/"/g, """)}">`;
// After <head>, else after the doctype so the copy keeps standards mode.
const anchor = /<head\b[^<>]*>/i.exec(html) ?? /<!doctype\b[^<>]*>/i.exec(html);
if (!anchor) return tag + html;
const at = anchor.index + anchor[0].length;
return html.slice(0, at) + tag + html.slice(at);
}