unsloth/studio/backend/utils/preview_rate_limit.py
Michael Han 6d8c18cd1a
Replace standalone Studio wording with Unsloth (#7221)
* Replace standalone Studio wording with Unsloth

Replace the single word Studio with Unsloth wherever it is used as
shorthand for Unsloth Studio in docs, CLI output, UI strings, i18n
locales, workflow display names, comments and docstrings.

Kept unchanged: the full name Unsloth Studio, third party product
names (LM Studio, Visual Studio, Mac Studio), feature names
(Recipe Studio, Fine-tuning Studio and its translations), and all
identifiers such as env vars, commands, paths and filenames.

* Address review feedback on the Studio wording rename

Use "an" before Unsloth where the rename left the article as "a".
Restore the split brand where Unsloth and Studio render as two halves
of the full product name: the onboarding sidebar subtitle and the
IPv6 localhost warning. Scope two messages to the full name Unsloth
Studio where plain Unsloth was misleading: the AMD README bullet and
the CLI studio setup error.
2026-07-19 00:47:04 -07:00

67 lines
2.3 KiB
Python

# SPDX-License-Identifier: AGPL-3.0-only
# Copyright 2026-present the Unsloth AI Inc. team. All rights reserved. See /studio/LICENSE.AGPL-3.0
"""Coarse per-IP sliding-window rate limit for the public ``/p`` preview chat.
A signed link stops ref guessing, but anyone with a link can still drive GPU
generation. This bounds sustained abuse from a single source. In-process and
single-worker only (like the login limiter in ``routes/auth.py``); Unsloth runs as
one uvicorn process, so a shared store isn't needed.
"""
from __future__ import annotations
import threading
import time
from collections import deque
# Window / ceiling for preview chat-completions per client IP.
_WINDOW_SECONDS = 60.0
_MAX_REQUESTS = 20
# Bound memory on a public surface (many distinct IPs).
_MAX_BUCKETS = 4096
_buckets: dict[str, deque] = {}
_lock = threading.Lock()
def _prune(bucket: deque, now: float) -> None:
while bucket and now - bucket[0] > _WINDOW_SECONDS:
bucket.popleft()
def _evict_aged(now: float) -> None:
"""Drop only buckets that have fully aged out. Never evict an active bucket:
evicting a throttled key would reset its counter, so a flood of distinct keys
could cycle the table and clear a victim's (or its own) limit."""
for key in list(_buckets.keys()):
_prune(_buckets[key], now)
if not _buckets[key]:
del _buckets[key]
def check_rate_limit(key: str) -> int:
"""Record a hit for ``key``; return seconds-to-wait if over the limit, else 0."""
now = time.monotonic()
with _lock:
bucket = _buckets.get(key)
if bucket is None:
if len(_buckets) >= _MAX_BUCKETS:
_evict_aged(now)
if len(_buckets) >= _MAX_BUCKETS:
# Table is full of currently-active clients. Fail closed: deny the
# new key rather than evict a live bucket (which would hand out a
# rate-limit reset). Pathological only (>= _MAX_BUCKETS live IPs).
return max(1, int(_WINDOW_SECONDS))
bucket = _buckets[key] = deque()
_prune(bucket, now)
if len(bucket) >= _MAX_REQUESTS:
return max(1, int(_WINDOW_SECONDS - (now - bucket[0])) + 1)
bucket.append(now)
return 0
def reset() -> None:
"""Clear all buckets (test isolation)."""
with _lock:
_buckets.clear()