app_paths.py

"""Project-local paths; configure before importing Gradio or Hugging Face."""

import os
from pathlib import Path

ROOT = Path(__file__).resolve().parent
DATA = ROOT / "data"
MODELS = DATA / "models"
VOICES = DATA / "voices"
OUTPUT = DATA / "output"
CACHE = DATA / "cache"
TEMP = DATA / "temp"
LOGS = DATA / "logs"


def configure_environment() -> None:
    for directory in (MODELS, VOICES, OUTPUT, CACHE / "pip", TEMP / "gradio", LOGS):
        directory.mkdir(parents=True, exist_ok=True)
    os.environ.update({
        "HF_HOME": str(MODELS),
        "HF_HUB_CACHE": str(MODELS / "hub"),
        "HF_XET_CACHE": str(MODELS / "xet"),
        "HF_HUB_DISABLE_TELEMETRY": "1",
        "HF_HUB_DISABLE_IMPLICIT_TOKEN": "1",
        "DO_NOT_TRACK": "1",
        "PIP_CACHE_DIR": str(CACHE / "pip"),
        "XDG_CACHE_HOME": str(CACHE),
        "TMPDIR": str(TEMP),
        "GRADIO_TEMP_DIR": str(TEMP / "gradio"),
        "GRADIO_ANALYTICS_ENABLED": "False",
    })