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
"""Installation-wide account policy, cached against a generation bumped on account writes."""
from __future__ import annotations
import contextlib
import os
import threading
from typing import Optional
from fastapi import Depends, HTTPException, status
LOGIN_MODE_SINGLE = "single"
LOGIN_MODE_MULTI = "multi"
_lock = threading.Lock()
_generation = 0
_cached: Optional[tuple[int, int, int]] = None
# Depth of in-flight account mutations; the cache is bypassed while any is open.
_mutating = 0
def invalidate_account_cache() -> None:
"""Call after any account is created, deleted, activated or deactivated."""
global _generation, _cached
with _lock:
_generation += 1
_cached = None
@contextlib.contextmanager
def account_mutation():
"""Bypass the cache for the whole write, since post-commit invalidation alone leaves a stale
window; counted, so nested account_mutation calls work."""
global _mutating, _generation, _cached
with _lock:
_mutating += 1
try:
yield
finally:
# One critical section: unsuppressing before invalidating would reopen the window.
with _lock:
_mutating -= 1
_generation += 1
_cached = None
def account_generation() -> int:
return _generation
def _account_counts() -> tuple[int, int]:
global _cached
with _lock:
if not _mutating and _cached is not None and _cached[0] == _generation:
return _cached[1], _cached[2]
generation = _generation
from auth import storage
try:
active, managed = storage.account_counts()
except Exception: # noqa: BLE001 - an unreadable auth.db is a one-user install
# Never cached: a transient error would hold full access off until restart.
from utils.account_context import is_owner_context
# A bound managed account proves a multi-user install, so isolation stays on.
return (1 if is_owner_context() else 2), 1
with _lock:
if not _mutating and generation == _generation:
_cached = (generation, active, managed)
return active, managed
def active_account_count() -> int:
return _account_counts()[0]
def managed_account_count() -> int:
"""Managed accounts of any state; a deactivated one still counts."""
return _account_counts()[1]
def installation_is_multi_user() -> bool:
return active_account_count() > 1
def login_mode() -> str:
return LOGIN_MODE_MULTI if installation_is_multi_user() else LOGIN_MODE_SINGLE
def installation_has_managed_accounts() -> bool:
"""Any managed account exists. Gated on this, not login mode: deactivated files stay on disk."""
return installation_is_multi_user() or managed_account_count() > 0
def full_access_permitted() -> bool:
"""Only the installation owner may run tools outside the sandbox."""
from utils.account_context import is_owner_context
return is_owner_context()
def api_full_access_refused() -> bool:
"""An API key (or keyless API access) asked for full access: like a local stdio MCP command, running
outside the sandbox is the Unsloth UI's to choose, unless the operator sets the env opt-in."""
from utils.account_context import via_api_key_context
return via_api_key_context() and os.environ.get("UNSLOTH_STUDIO_ALLOW_API_FULL_ACCESS") != "1"
def _forbid(detail: str) -> HTTPException:
return HTTPException(status_code = status.HTTP_403_FORBIDDEN, detail = detail)
async def require_owner() -> None:
from utils.account_context import current_account
if not current_account().is_owner:
raise _forbid("Only the installation owner can do this")
def require_account_scope(resource_account_id: Optional[str]) -> None:
"""Refuse a resource owned by another account; ``None`` predates accounts and is owner-owned."""
from utils.account_context import OWNER_ACCOUNT_ID, current_account_id
owner_of = resource_account_id or OWNER_ACCOUNT_ID
if owner_of != current_account_id():
# 404 rather than 403: existence is itself information.
raise HTTPException(status_code = status.HTTP_404_NOT_FOUND, detail = "Not found")
OwnerOnly = Depends(require_owner)