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
"""Static contracts for remote connection model persistence (#7281)."""
from pathlib import Path
REPO = Path(__file__).resolve().parents[2]
FRONTEND = REPO / "studio/frontend/src"
PROVIDERS_API = FRONTEND / "features/chat/api/providers-api.ts"
SYNC_PROVIDERS = FRONTEND / "features/chat/sync-external-providers.ts"
CHAT_PAGE = FRONTEND / "features/chat/chat-page.tsx"
RECONCILIATION = FRONTEND / "features/credentials/reconciliation.ts"
CREDENTIAL_BOOTSTRAP = FRONTEND / "features/credentials/bootstrap.ts"
ROOT_ROUTE = FRONTEND / "app/routes/__root.tsx"
PROVIDERS_DB = REPO / "studio/backend/storage/providers_db.py"
PROVIDERS_MODELS = REPO / "studio/backend/models/providers.py"
def test_providers_db_stores_model_json_columns():
source = PROVIDERS_DB.read_text(encoding = "utf-8")
assert "models_json" in source
assert "available_models_json" in source
assert "ALTER TABLE llm_providers ADD COLUMN models_json" in source
def test_provider_api_schemas_expose_models():
source = PROVIDERS_MODELS.read_text(encoding = "utf-8")
assert "models: list[str]" in source
assert "available_models: list[str]" in source
def test_frontend_sync_prefers_server_models_on_remote_clients():
source = SYNC_PROVIDERS.read_text(encoding = "utf-8")
assert "config.models" in source
assert "config.available_models" in source
assert "serverModels.length > 0" in source
def test_frontend_sync_backfills_local_models_to_backend():
source = SYNC_PROVIDERS.read_text(encoding = "utf-8")
assert "updateProviderConfig" in source
assert "needsModelBackfill" in source
# The batch is settled by settleTasksIfCurrent. Only the wiring is checked here; that both
# hops are awaited runs for real in test_provider_backfill_awaits_batch.py.
flat = " ".join(source.split()).replace("( ", "(")
assert "settleTasksIfCurrent(backfillTasks" in flat
helper = RECONCILIATION.read_text(encoding = "utf-8")
assert "export async function settleTasksIfCurrent" in helper
# Scoped to the helper: runCredentialBootstrap also allSettles.
body = helper.split("export async function settleTasksIfCurrent", 1)[1]
body = body.split("\nexport ", 1)[0]
assert (
"Promise.allSettled(tasks.map(" in body
), "the batch must still settle rather than reject on the first failure"
def test_frontend_sync_preserves_local_provider_options():
source = SYNC_PROVIDERS.read_text(encoding = "utf-8")
assert "mergeLocalProviderOptions" in source
assert "promptCacheTtl" in source
assert "openaiContainerTtlMinutes" in source
def test_connections_are_hydrated_on_startup():
"""Matches call sites, not bare names: an import survives after its call is deleted."""
bootstrap = CREDENTIAL_BOOTSTRAP.read_text(encoding = "utf-8")
assert "syncExternalProvidersFromBackend(providers" in bootstrap
root = ROOT_ROUTE.read_text(encoding = "utf-8")
assert (
"bootstrapPersistedCredentials()" in root
), "nothing calls the credential bootstrap, so no page hydrates connections"
# The call lives inside CredentialBootstrapGate, so the gate must render too.
assert "<CredentialBootstrapGate active={!isAuthFlowRoute}>" in root
assert "hydratePersistedSettings()" in CHAT_PAGE.read_text(encoding = "utf-8")
def test_providers_api_sends_models_to_backend():
source = PROVIDERS_API.read_text(encoding = "utf-8")
assert "available_models: payload.availableModels" in source
assert "models: payload.models" in source