installer.py

from functools import lru_cache
import os
import sys
import json
import time
import shutil
import locale
import socket
import logging
import platform
import subprocess
import cProfile
import importlib
import importlib.util
import importlib.metadata


class Dot(dict): # dot notation access to dictionary attributes
    __getattr__ = dict.get
    __setattr__ = dict.__setitem__
    __delattr__ = dict.__delitem__

class Torch(dict):
    def set(self, **kwargs):
        for k, v in kwargs.items():
            self[k] = v

version = {
    'app': 'sd.next',
    'updated': 'unknown',
    'commit': 'unknown',
    'branch': 'unknown',
    'url': 'unknown',
    'kanvas': 'unknown',
}
log = logging.getLogger('sdnext.installer')
debug = log.debug if os.environ.get('SD_INSTALL_DEBUG', None) is not None else lambda *args, **kwargs: None
setuptools, distutils = None, None # defined via ensure_base_requirements
current_branch = None
pip_log = '--log pip.log' if os.environ.get('SD_PIP_DEBUG', None) is not None else ''
log_file = os.path.join(os.path.dirname(__file__), 'sdnext.log')
hostname = socket.gethostname()
log_rolled = False
first_call = True
quick_allowed = True
errors = []
opts = {}
args = Dot({
    'debug': False,
    'reset': False,
    'profile': False,
    'upgrade': False,
    'skip_extensions': False,
    'skip_requirements': False,
    'skip_git': False,
    'skip_torch': False,
    'use_directml': False,
    'use_ipex': False,
    'use_cuda': False,
    'use_rocm': False,
    'experimental': False,
    'test': False,
    'tls_selfsign': False,
    'reinstall': False,
    'version': False,
    'ignore': False,
    'uv': False,
})
git_commit = "unknown"
diffusers_commit = "unknown"
transformers_commit = "unknown"
restart_required = False
extensions_commit = { # force specific commit for extensions
    'sd-webui-controlnet': 'ecd33eb',
    'adetailer': 'a89c01d'
    # 'stable-diffusion-webui-images-browser': '27fe4a7',
}
control_extensions = [ # extensions marked as safe for control ui
    'NudeNet',
    'IP Adapters',
    'Remove background',
]
gpu_info = []
torch_info = Torch()


try:
    from modules.timer import init
    ts = init.ts
    elapsed = init.elapsed
except Exception:
    ts = lambda *args, **kwargs: None # pylint: disable=unnecessary-lambda-assignment
    elapsed = lambda *args, **kwargs: None # pylint: disable=unnecessary-lambda-assignment


@lru_cache
def get_logfile():
    log_size = os.path.getsize(log_file) if os.path.exists(log_file) else 0
    log.info(f'Logger: file="{os.path.abspath(log_file)}" level={logging.getLevelName(logging.DEBUG if args.debug else logging.INFO)} host="{hostname}" size={log_size} mode={"append" if not log_rolled else "create"}')
    return log_file


def custom_excepthook(exc_type, exc_value, exc_traceback):
    import traceback
    if issubclass(exc_type, KeyboardInterrupt):
        sys.__excepthook__(exc_type, exc_value, exc_traceback)
        return
    log.error(f"Uncaught exception occurred: type={exc_type} value={exc_value}")
    if exc_traceback:
        format_exception = traceback.format_tb(exc_traceback)
        for line in format_exception:
            log.error(repr(line))


def print_dict(d):
    if d is None:
        return ''
    return ' '.join([f'{k}={v}' for k, v in d.items()])


def env_flag(name: str, default: bool = False) -> bool:
    value = os.environ.get(name)
    if value is None:
        return default
    return str(value).strip().lower() in ('1', 'true', 'yes', 'on')


def print_profile(profiler: cProfile.Profile, msg: str):
    profiler.disable()
    from modules.errors import profile
    profile(profiler, msg)


def package_version(package):
    try:
        return importlib.metadata.version(package)
    except Exception:
        return None


def package_spec(package):
    try:
        return importlib.metadata.distribution(package)
    except Exception:
        try:
            return importlib.metadata.distribution(package.lower())
        except Exception:
            try:
                return importlib.metadata.distribution(package.replace('_', '-'))
            except Exception:
                return None


# check if package is installed
def installed(package, friendly: str | None = None, quiet = False): # pylint: disable=redefined-outer-name
    t_start = time.time()
    ok = True
    try:
        if friendly:
            pkgs = friendly.split()
        else:
            pkgs = [p for p in package.split() if not p.startswith('-') and not p.startswith('=') and not p.startswith('git+')]
            pkgs = [p.split('/')[-1] for p in pkgs] # get only package name if installing from url
        for pkg in pkgs:
            if '!=' in pkg:
                p = pkg.split('!=')
                return True # check for not equal always return true
            elif '>=' in pkg:
                p = pkg.split('>=')
            else:
                p = pkg.split('==')
            spec = package_spec(p[0])
            ok = ok and spec is not None
            if ok:
                pkg_version = package_version(p[0])
                if len(p) > 1:
                    exact = pkg_version == p[1]
                    if not exact and not quiet:
                        if args.experimental:
                            log.warning(f'Install: package="{p[0]}" installed={pkg_version} required={p[1]} allowing experimental')
                        else:
                            log.warning(f'Install: package="{p[0]}" installed={pkg_version} required={p[1]} updating...')
                            global restart_required # pylint: disable=global-statement
                            restart_required = True
                    ok = ok and (exact or args.experimental)
            else:
                if not quiet:
                    log.debug(f'Install: package="{p[0]}" install required')
        ts('installed', t_start)
        return ok
    except Exception as e:
        log.error(f'Install: package="{pkgs}" {e}')
        ts('installed', t_start)
        return False


def uninstall(package, quiet = False):
    t_start = time.time()
    packages = package if isinstance(package, list) else [package]
    txt = ''
    for p in packages:
        if installed(p, p, quiet=True):
            if not quiet:
                log.warning(f'Package: {p} uninstall')
            _result, _txt = pip(f"uninstall {p} --yes --quiet", ignore=True, quiet=True, uv=False)
            txt += _txt
    ts('uninstall', t_start)
    return txt


def uv_info():
    uv_version = None
    uv_cache_dir = None
    uv_cache_active = False
    uv_local = os.path.join(sys.prefix, "bin", "uv") # Prefer uv inside the venv
    if os.path.exists(uv_local):
        uv_version = subprocess.check_output([uv_local, "--version"], text=True).strip()
        uv_cache_dir = subprocess.check_output([uv_local, "cache", "dir"], text=True).strip()
    uv_global = shutil.which("uv") # Fallback: system uv
    if uv_global:
        uv_version = subprocess.check_output([uv_global, "--version"], text=True).strip()
        uv_cache_dir = subprocess.check_output([uv_global, "cache", "dir"], text=True).strip()
    uv_cache_disabled = os.environ.get("UV_NO_CACHE") == "1"
    site = next(p for p in sys.path if p.endswith("site-packages"))
    if uv_cache_dir and not uv_cache_disabled:
        for root, _dirs, files in os.walk(site):
            for f in files:
                full = os.path.join(root, f)
                try:
                    st = os.stat(full)
                except FileNotFoundError:
                    continue
                if st.st_nlink > 1: # Hardlink count > 1 means deduped
                    uv_cache_active = True
                cache_path = os.path.join(uv_cache_dir, f) # Or check if inode matches something in cache
                if os.path.exists(cache_path):
                    if os.stat(cache_path).st_ino == st.st_ino:
                        uv_cache_active = True
    log.debug(f'Package manager: app=uv version="{uv_version}" folder="{uv_cache_dir}" dedup={uv_cache_active}')


def run(cmd: str, *nargs: str, **kwargs):
    options = {
        "check": False,
        "env": os.environ,
    }
    options |= kwargs  # Override defaults with passed kwargs
    argstr = " ".join(nargs)
    result = subprocess.run(f'"{cmd}" {argstr}', **options, shell=True, capture_output=True, text=True)
    result.stdout = result.stdout.strip()
    result.stderr = result.stderr.strip()
    txt = result.stdout
    if result.stderr:
        # Put newline between outputs only if stdout isn't empty
        txt += "\n" + result.stderr if txt else result.stderr
    return result, txt


def cleanup_broken_packages():
    """Remove dist-info directories with missing RECORD files that uv may have left behind"""
    try:
        import site
        for site_dir in site.getsitepackages():
            if not os.path.isdir(site_dir):
                continue
            for entry in os.listdir(site_dir):
                if not entry.endswith('.dist-info'):
                    continue
                dist_info = os.path.join(site_dir, entry)
                record_file = os.path.join(dist_info, 'RECORD')
                if not os.path.isfile(record_file):
                    pkg_name = entry.split('-')[0]
                    log.warning(f'Install: package={pkg_name} path="{dist_info}" removing metadata')
                    shutil.rmtree(dist_info, ignore_errors=True)
    except Exception:
        pass


def pip(arg: str, ignore: bool = False, quiet: bool = True, *, uv = True, constraints = True) -> tuple[subprocess.CompletedProcess | None, str]:
    t_start = time.time()
    originalArg = arg
    arg = arg.replace('>=', '==').strip()
    if opts.get('offline_mode', False):
        log.warning('Offline mode enabled')
        return None, 'offline'
    package = arg.replace("install", "").replace("--upgrade", "").replace("--no-deps", "").replace("--force-reinstall", "").strip()
    # uv = uv and args.uv and not package.startswith('git+')
    uv = uv and args.uv
    pipCmd = "uv pip" if uv else "pip"
    if not quiet and '-r ' not in arg:
        log.info(f'Install: package="{package}" mode={"uv" if uv else "pip"}')
    env_args = os.environ.get("PIP_EXTRA_ARGS", "").strip()
    all_args: list[str] = []
    if pip_log:
        all_args.append(pip_log)
    all_args.append(arg)
    if env_args:
        all_args.append(env_args)
    if constraints and "-c " not in env_args and arg.startswith("install"):
        all_args.append("-c constraints.txt")
    if not quiet:
        log.debug(f'Running: {pipCmd}="{" ".join(all_args)}"')

    if uv:
        result, output = run("uv", "pip", *all_args)
    else:
        result, output = run(sys.executable, "-m", pipCmd, *all_args)

    if len(result.stderr) > 0:
        if uv and result.returncode != 0:
            log.warning(f'Install: cmd="{pipCmd}" args="{" ".join(all_args)}" cannot use uv, fallback to pip')
            debug(f'Install: uv pip error: {result.stderr}')
            cleanup_broken_packages()
            return pip(originalArg, ignore, quiet, uv=False)
    if os.environ.get('SD_INSTALL_DEBUG', None) is not None:
        log.debug(f'PIP cmd="{pipCmd}": {output}')
    if result.returncode != 0 and not ignore:
        errors.append(f'pip: {package}')
        log.error(f'Install: {pipCmd}: {arg}')
        log.debug(f'Install: pip code={result.returncode} stdout={result.stdout} stderr={result.stderr} output={output}')
    ts('pip', t_start)
    return result, output


# install package using pip if not already installed
def install(package, friendly: str | None = None, ignore: bool = False, reinstall: bool = False, no_deps: bool = False, quiet: bool = False, force: bool = False, no_build_isolation: bool = False):
    t_start = time.time()
    res = ''
    force = force or args.reinstall
    if args.reinstall or args.upgrade:
        global quick_allowed # pylint: disable=global-statement
        quick_allowed = False
    if args.reinstall or reinstall or not installed(package, friendly, quiet=quiet):
        deps = '' if not no_deps else '--no-deps '
        isolation = '' if not no_build_isolation else '--no-build-isolation '
        cmd = f"install{' --upgrade' if not args.uv else ''}{' --force-reinstall' if force else ''} {deps}{isolation}{package}"
        res = pip(cmd, ignore=ignore, uv=package != "uv" and not package.startswith('git+'))
    ts('install', t_start)
    return res


# execute git command
def git(arg: str, folder: str | None= None, ignore: bool = False, optional: bool = False): # pylint: disable=unused-argument
    t_start = time.time()
    if args.skip_git:
        return ''
    if 'google.colab' in sys.modules:
        return ''
    git_cmd = os.environ.get('GIT', "git")
    if git_cmd != "git":
        git_cmd = os.path.abspath(git_cmd)
    result, txt = run(git_cmd, arg, cwd=folder or ".")
    if result.returncode != 0 and not ignore:
        if folder is None:
            folder = 'root'
        if "couldn't find remote ref" in txt: # not a git repo
            log.error(f'Git: folder="{folder}" could not identify repository')
        elif "no submodule mapping found" in txt:
            log.warning(f'Git: folder="{folder}" submodules changed')
        elif 'or stash them' in txt:
            log.warning(f'Git: folder="{folder}" local changes detected')
        else:
            log.error(f'Git: folder="{folder}" arg="{arg}" output={txt}')
        errors.append(f'git: {folder}')
    ts('git', t_start)
    return txt


# reattach as needed as head can get detached
def branch(folder=None):
    # if args.experimental:
    #    return None
    t_start = time.time()
    if not os.path.exists(os.path.join(folder or os.curdir, '.git')):
        return None
    branches = []
    try:
        b = git('branch --show-current', folder, optional=True)
        if b == '':
            branches = git('branch', folder).split('\n')
        marked = [x for x in branches if x.startswith('*')]
        if len(branches) > 0 and len(marked) > 0:
            b = marked[0]
            if 'detached' in b and len(branches) > 1:
                b = branches[1].strip()
                log.debug(f'Git detached head detected: folder="{folder}" reattach={b}')
    except Exception:
        b = git('git rev-parse --abbrev-ref HEAD', folder, optional=True)
    if 'main' in b:
        b = 'main'
    elif 'master' in b:
        b = 'master'
    else:
        b = b.split('\n')[0].replace('*', '').strip()
    log.debug(f'Git submodule: {folder} / {b}')
    git(f'checkout {b}', folder, ignore=True, optional=True)
    ts('branch', t_start)
    return b


# restart process
def restart(argv: list | None = None):
    argv = argv if isinstance(argv, list) else sys.argv
    log.critical('Restarting process...')
    os.execv(sys.executable, ['python'] + argv)


# update git repository
def update(folder, keep_branch = False, rebase = True):
    t_start = time.time()
    try:
        git('config rebase.Autostash true')
    except Exception:
        pass
    arg = '--rebase --force' if rebase else ''
    if keep_branch:
        res = git(f'pull {arg}', folder)
        debug(f'Install update: folder={folder} args={arg} {res}')
    else:
        b = branch(folder)
        if b is None:
            res = git(f'pull {arg}', folder)
            debug(f'Install update: folder={folder} branch={b} args={arg} {res}')
        else:
            res = git(f'pull origin {b} {arg}', folder)
            debug(f'Install update: folder={folder} branch={b} args={arg} {res}')
        if not args.experimental:
            commit = extensions_commit.get(os.path.basename(folder), None)
            if commit is not None:
                res = git(f'checkout {commit}', folder)
                debug(f'Install update: folder={folder} branch={b} args={arg} commit={commit} {res}')
    ts('update', t_start)
    return res


# clone git repository
def clone(url, folder, commithash=None):
    t_start = time.time()
    if os.path.exists(folder):
        if commithash is None:
            update(folder)
        else:
            current_hash = git('rev-parse HEAD', folder).strip()
            if current_hash != commithash:
                res = git('fetch', folder)
                debug(f'Install clone: {res}')
                git(f'checkout {commithash}', folder)
                return
    else:
        log.info(f'Cloning repository: {url}')
        git(f'clone "{url}" "{folder}"')
        if commithash is not None:
            git(f'-C "{folder}" checkout {commithash}')
    ts('clone', t_start)


def get_platform():
    try:
        if platform.system() == 'Windows':
            release = platform.platform(aliased = True, terse = False)
        else:
            release = platform.release()
        return {
            'arch': platform.machine(),
            'cpu': f'{platform.processor()}',
            'system': platform.system(),
            'release': release,
            'python': platform.python_version(),
            'locale': locale.getlocale(),
            'setuptools': package_version('setuptools'),
            'docker': os.environ.get('SD_DOCKER', None) is not None,
            'pip': package_version('pip'),
            'uv': package_version('uv'),
            # 'host': platform.node(),
            # 'version': platform.version(),
        }
    except Exception as e:
        return { 'error': e }


# check python version
def check_python(supported_minors=None, experimental_minors=None, reason=None):
    if experimental_minors is None:
        experimental_minors = []
    if supported_minors is None:
        supported_minors = []
    if supported_minors is None or len(supported_minors) == 0:
        supported_minors = [10, 11, 12, 13]
        experimental_minors = [14]
    t_start = time.time()
    if args.quick:
        return
    log.info(f'Python: version={platform.python_version()} platform={platform.system()} bin="{sys.executable}" venv="{sys.prefix}"')
    if sys.prefix == getattr(sys, "base_prefix", sys.prefix) and 'venv' not in sys.prefix.lower():
        log.warning('Python: virtual environment not detected')
    if int(sys.version_info.minor) == 9:
        log.error(f"Python: version={platform.python_version()} is end-of-life")
    if int(sys.version_info.minor) == 10:
        log.warning(f"Python: version={platform.python_version()} is not actively supported")
    if int(sys.version_info.minor) >= 12:
        os.environ.setdefault('SETUPTOOLS_USE_DISTUTILS', 'local') # hack for python 3.11 setuptools
    if int(sys.version_info.minor) >= 13:
        # log.warning(f"Python: version={platform.python_version()} not all features are available")
        pass
    if not (int(sys.version_info.major) == 3 and int(sys.version_info.minor) in supported_minors):
        if (int(sys.version_info.major) == 3 and int(sys.version_info.minor) in experimental_minors):
            log.warning(f"Python experimental: {sys.version_info.major}.{sys.version_info.minor}.{sys.version_info.micro}")
            if reason is not None:
                log.error(reason)
            if not args.ignore and not args.experimental:
                sys.exit(1)
        else:
            log.error(f"Python incompatible: current {sys.version_info.major}.{sys.version_info.minor}.{sys.version_info.micro} required 3.{supported_minors}")
            if reason is not None:
                log.error(reason)
            if not args.ignore and not args.experimental:
                sys.exit(1)
    if not args.skip_git:
        git_cmd = os.environ.get('GIT', "git")
        if shutil.which(git_cmd) is None:
            log.error('Git not found')
            if not args.ignore:
                sys.exit(1)
    else:
        git_version = git('--version', folder=None, ignore=False)
        log.debug(f'Git: version={git_version.replace("git version", "").strip()}')
    if ' ' in sys.executable:
        log.warning(f'Python: path="{sys.executable}" contains spaces which may cause issues')
    ts('python', t_start)


# check diffusers version
def check_diffusers():
    t_start = time.time()
    if args.skip_all:
        return
    target_commit = "d1f8e55c3b6e3ac42d6303a8805ded1c2a4bdd0e" # diffusers commit hash == 0.39.0.dev0 == 06-15-2026
    # if args.use_rocm or args.use_zluda or args.use_directml:
    #     sha = '043ab2520f6a19fce78e6e060a68dbc947edb9f9' # lock diffusers versions for now
    pkg = package_spec('diffusers')
    parts = pkg.version.split('.') if pkg is not None else []
    minor = int(parts[1]) if len(parts) > 1 else -1
    current = opts.get('diffusers_version', '') if minor > -1 else ''
    if (minor == -1) or ((current != target_commit) and (not args.experimental)):
        if minor == -1:
            log.info(f'Install: package="diffusers" commit={target_commit}')
        else:
            log.info(f'Update: package="diffusers" current={pkg.version} hash={current} target={target_commit}')
            pip('uninstall --yes diffusers', ignore=True, quiet=True, uv=False)
        if args.skip_git:
            log.warning('Git: marked as not available but required for diffusers installation')
        pip(f'install --upgrade git+https://github.com/huggingface/diffusers@{target_commit}', ignore=False, quiet=True, uv=False)
        global diffusers_commit # pylint: disable=global-statement
        diffusers_commit = target_commit
    ts('diffusers', t_start)


# check transformers version
def check_transformers():
    t_start = time.time()
    if args.skip_all or args.skip_git or args.experimental:
        return
    pkg_transformers = package_spec('transformers')
    pkg_tokenizers = package_spec('tokenizers')
    # target_commit = '753d61104116eefc8ffc977327b441ee0c8d599f' # transformers commit hash == 4.57.6
    # target_commit = "380e3cc5d59912a48508cb6d4959a31cd460e12e" # transformers commit hash == 5.5.0.dev-0409
    target_commit = "d242bb790bcbbe6c9a20e46cf9d70648739a90bf" # transformers commit hash == 5.13.0.dev0 == 06-15-2026
    if args.use_directml:
        target_transformers = '4.52.4'
        target_tokenizers = '0.21.4'
    else:
        # target_transformers = '4.57.6'
        target_transformers = None
        target_tokenizers = '0.23.1'
    if target_transformers is not None:
        # Pinned release version (e.g. DirectML)
        if args.reinstall or (pkg_transformers is None) or ((pkg_transformers.version != target_transformers) or (pkg_tokenizers is None) or ((pkg_tokenizers.version != target_tokenizers) and (not args.experimental))):
            if pkg_transformers is None:
                log.info(f'Install: package="transformers" version={target_transformers}')
            else:
                log.info(f'Update: package="transformers" current={pkg_transformers.version} target={target_transformers}')
            pip('uninstall --yes transformers', ignore=True, quiet=True)
            pip(f'install --upgrade tokenizers=={target_tokenizers}', ignore=False, quiet=True)
            pip(f'install --upgrade transformers=={target_transformers}', ignore=False, quiet=True)
    else:
        # Git commit-pinned version
        current = opts.get('transformers_version', '')
        if args.reinstall or (pkg_transformers is None) or (pkg_transformers.version.startswith('4')) or (current != target_commit):
            if pkg_transformers is None:
                log.info(f'Install: package="transformers" commit={target_commit}')
            else:
                log.info(f'Update: package="transformers" current={pkg_transformers.version} hash={current} target={target_commit}')
            pip('uninstall --yes transformers', ignore=True, quiet=True)
            pip(f'install --upgrade tokenizers=={target_tokenizers}', ignore=False, quiet=True)
            pip(f'install --upgrade git+https://github.com/huggingface/transformers@{target_commit}', ignore=False, quiet=True)
            global transformers_commit # pylint: disable=global-statement
            transformers_commit = target_commit
    ts('transformers', t_start)


# check onnx version
def check_onnx():
    t_start = time.time()
    if args.skip_all or args.skip_requirements:
        return
    if not installed('onnx', quiet=True):
        install('onnx', 'onnx', ignore=True)
    if not installed('onnxruntime', quiet=True) and not (installed('onnxruntime-gpu', quiet=True) or installed('onnxruntime-openvino', quiet=True) or installed('onnxruntime-training', quiet=True)): # allow either
        install(os.environ.get('ONNXRUNTIME_COMMAND', 'onnxruntime'), ignore=True)
    ts('onnx', t_start)


def install_cuda():
    t_start = time.time()
    log.info('CUDA: nVidia toolkit detected')
    ts('cuda', t_start)
    if args.use_nightly:
        cmd = os.environ.get('TORCH_COMMAND', '--upgrade --pre torch torchvision --index-url https://download.pytorch.org/whl/nightly/cu132 --extra-index-url https://download.pytorch.org/whl/nightly/cu130')
    else:
        cmd = os.environ.get('TORCH_COMMAND', 'torch==2.12.0+cu130 torchvision==0.27.0+cu130 --index-url https://download.pytorch.org/whl/cu130')
    return cmd


def install_rocm_zluda():
    torch_command = ''
    t_start = time.time()
    if args.skip_all or args.skip_requirements:
        return torch_command
    from modules import rocm

    amd_gpus = []
    try:
        amd_gpus = rocm.get_agents()
    except Exception as e:
        log.warning(f'ROCm agent enumerator failed: {e}')

    #os.environ.setdefault('TENSORFLOW_PACKAGE', 'tensorflow')

    device = None
    if len(amd_gpus) == 0:
        log.warning('ROCm: no agent was found')
    else:
        log.info(f'ROCm: agents={[gpu.name for gpu in amd_gpus]}')
        if args.device_id is None:
            index = 0
            for idx, gpu in enumerate(amd_gpus):
                index = idx
                if not gpu.is_apu:
                    # although apu was found, there can be a dedicated card. do not break loop.
                    # if no dedicated card was found, apu will be used.
                    break
            os.environ.setdefault('HIP_VISIBLE_DEVICES', str(index))
            device = amd_gpus[index]
        else:
            device_id = int(args.device_id)
            if device_id < len(amd_gpus):
                device = amd_gpus[device_id]

    if sys.platform == "win32" and (not args.use_zluda) and (device is not None) and (device.therock is not None) and not installed("rocm"):
        check_python(supported_minors=[11, 12, 13], reason='ROCm backend requires a Python version between 3.11 and 3.13')
        install(f"rocm[devel,libraries] --index-url https://rocm.nightlies.amd.com/{device.therock}")
        rocm.refresh()

    msg = f'ROCm: version={rocm.version}'
    if device is not None:
        msg += f', using agent {device}'
    log.info(msg)

    if sys.platform == "win32":
        if args.use_zluda:
            torch_command = os.environ.get('TORCH_COMMAND', 'torch==2.7.1+cu118 torchvision==0.22.1+cu118 --index-url https://download.pytorch.org/whl/cu118')

            if args.device_id is not None:
                if os.environ.get('HIP_VISIBLE_DEVICES', None) is not None:
                    log.warning('Setting HIP_VISIBLE_DEVICES and --device-id at the same time may be mistake.')
                os.environ['HIP_VISIBLE_DEVICES'] = args.device_id
                del args.device_id

            from modules import zluda_installer
            try:
                if args.reinstall or zluda_installer.is_reinstall_needed():
                    zluda_installer.uninstall()
                zluda_installer.install()
                zluda_installer.set_default_agent(device)
            except Exception as e:
                log.error(f'Install ZLUDA: {e}')

            try:
                zluda_installer.load()
            except Exception as e:
                log.error(f'Load ZLUDA: {e}')
        else: # TODO rocm: switch to pytorch source when it becomes available
            if device is None:
                log.error('ROCm: no agent found - make sure that graphics driver is installed and up to date')
            if isinstance(rocm.environment, rocm.PythonPackageEnvironment):
                check_python(supported_minors=[11, 12, 13], reason='ROCm: python==3.11/3.12/3.13 required')
                torch_command = os.environ.get('TORCH_COMMAND', f'torch torchvision --index-url https://rocm.nightlies.amd.com/{device.therock}')
            else:
                check_python(supported_minors=[12], reason='ROCm: Windows preview python==3.12 required')
                # torch 2.8.0a0 is the last version with rocm 6.4 support
                torch_command = os.environ.get('TORCH_COMMAND', '--no-cache-dir https://repo.radeon.com/rocm/windows/rocm-rel-6.4.4/torch-2.8.0a0%2Bgitfc14c65-cp312-cp312-win_amd64.whl https://repo.radeon.com/rocm/windows/rocm-rel-6.4.4/torchvision-0.24.0a0%2Bc85f008-cp312-cp312-win_amd64.whl')
    else:
        #check_python(supported_minors=[10, 11, 12, 13, 14], reason='ROCm backend requires a Python version between 3.10 and 3.13')
        if args.use_nightly:
            if rocm.version is None or float(rocm.version) >= 7.2: # assume the latest if version check fails
                torch_command = os.environ.get('TORCH_COMMAND', '--upgrade --pre torch torchvision --index-url https://download.pytorch.org/whl/nightly/rocm7.2')
            else: # oldest rocm version on nightly is 7.1
                torch_command = os.environ.get('TORCH_COMMAND', '--upgrade --pre torch torchvision --index-url https://download.pytorch.org/whl/nightly/rocm7.1')
        else:
            if rocm.version is None or float(rocm.version) >= 7.2: # assume the latest if version check fails
                torch_command = os.environ.get('TORCH_COMMAND', 'torch==2.12.0+rocm7.2 torchvision==0.27.0+rocm7.2 --index-url https://download.pytorch.org/whl/rocm7.2')
            elif rocm.version == "7.1":
                torch_command = os.environ.get('TORCH_COMMAND', 'torch==2.12.0+rocm7.1 torchvision==0.27.0+rocm7.1 --index-url https://download.pytorch.org/whl/rocm7.1')
            elif rocm.version == "7.0":
                torch_command = os.environ.get('TORCH_COMMAND', 'torch==2.10.0+rocm7.0 torchvision==0.25.0+rocm7.0 --index-url https://download.pytorch.org/whl/rocm7.0')
            elif rocm.version == "6.4":
                torch_command = os.environ.get('TORCH_COMMAND', 'torch==2.9.1+rocm6.4 torchvision==0.24.1+rocm6.4 --index-url https://download.pytorch.org/whl/rocm6.4')
            elif rocm.version == "6.3":
                torch_command = os.environ.get('TORCH_COMMAND', 'torch==2.9.1+rocm6.3 torchvision==0.24.1+rocm6.3 --index-url https://download.pytorch.org/whl/rocm6.3')
            elif rocm.version == "6.2":
                # use rocm 6.2.4 instead of 6.2 as torch==2.7.1+rocm6.2 doesn't exists
                torch_command = os.environ.get('TORCH_COMMAND', 'torch==2.7.1+rocm6.2.4 torchvision==0.22.1+rocm6.2.4 --index-url https://download.pytorch.org/whl/rocm6.2.4')
            elif rocm.version == "6.1":
                torch_command = os.environ.get('TORCH_COMMAND', 'torch==2.6.0+rocm6.1 torchvision==0.21.0+rocm6.1 --index-url https://download.pytorch.org/whl/rocm6.1')
            else:
                # lock to 2.4.1 instead of 2.5.1 for performance reasons there are no support for torch 2.6 for rocm 6.0
                torch_command = os.environ.get('TORCH_COMMAND', 'torch==2.4.1+rocm6.0 torchvision==0.19.1+rocm6.0 --index-url https://download.pytorch.org/whl/rocm6.0')
                if float(rocm.version) < 6.0:
                    log.warning(f"ROCm: unsupported version={rocm.version}")
                    log.warning("ROCm: minimum supported version=6.0")

    if device is None or os.environ.get("HSA_OVERRIDE_GFX_VERSION", None) is not None:
        log.info(f'ROCm: HSA_OVERRIDE_GFX_VERSION auto config skipped: device={device} version={os.environ.get("HSA_OVERRIDE_GFX_VERSION", None)}')
    else:
        gfx_ver = device.get_gfx_version()
        if gfx_ver is not None and device.name.removeprefix("gfx") != gfx_ver.replace(".", ""):
            os.environ.setdefault('HSA_OVERRIDE_GFX_VERSION', gfx_ver)
            log.info(f'ROCm: HSA_OVERRIDE_GFX_VERSION config overridden: device={device} version={os.environ.get("HSA_OVERRIDE_GFX_VERSION", None)}')

    ts('amd', t_start)
    return torch_command


def install_ipex():
    t_start = time.time()
    args.use_ipex = True # pylint: disable=attribute-defined-outside-init
    log.info('IPEX: Intel OneAPI toolkit detected')
    if args.use_nightly:
        torch_command = os.environ.get('TORCH_COMMAND', '--upgrade --pre torch torchvision --extra-index-url https://download.pytorch.org/whl/nightly/xpu')
    else:
        torch_command = os.environ.get('TORCH_COMMAND', 'torch==2.12.0+xpu torchvision==0.27.0+xpu --extra-index-url https://download.pytorch.org/whl/xpu')

    ts('ipex', t_start)
    return torch_command


def install_openvino():
    t_start = time.time()
    log.info('Backend: OpenVINO')
    os.environ.setdefault('PYTORCH_TRACING_MODE', 'TORCHFX')
    if sys.platform == 'darwin':
        torch_command = os.environ.get('TORCH_COMMAND', 'torch==2.11.0 torchvision==0.26.0')
    else:
        torch_command = os.environ.get('TORCH_COMMAND', 'torch==2.11.0+cpu torchvision==0.26.0 --index-url https://download.pytorch.org/whl/cpu')

    if not (args.skip_all or args.skip_requirements):
        install(os.environ.get('OPENVINO_COMMAND', 'openvino==2026.1.0'), 'openvino')
    ts('openvino', t_start)
    return torch_command


def install_torch_addons():
    t_start = time.time()
    triton_command = os.environ.get('TRITON_COMMAND', None)
    if triton_command is not None and triton_command != 'skip':
        install(triton_command, 'triton', quiet=True)
    xformers_package = os.environ.get('XFORMERS_PACKAGE', '--pre xformers') if opts.get('cross_attention_optimization', '') == 'xFormers' or args.use_xformers else 'none'
    if 'xformers' in xformers_package:
        try:
            install(xformers_package, ignore=True, no_deps=True)
        except Exception as e:
            log.debug(f'xFormers cannot install: {e}')
    elif not args.experimental and not args.use_xformers and opts.get('cross_attention_optimization', '') != 'xFormers':
        uninstall('xformers')
    if opts.get('cuda_compile_backend', '') == 'hidet':
        install('hidet', 'hidet')
    if opts.get('cuda_compile_backend', '') == 'deep-cache':
        install('DeepCache')
    if opts.get('cuda_compile_backend', '') == 'olive-ai':
        install('olive-ai')
    if opts.get('samples_format', 'jpg') == 'jxl' or opts.get('grid_format', 'jpg') == 'jxl':
        install('pillow-jxl-plugin==1.3.7', 'pillow-jxl-plugin')
    if not args.experimental:
        uninstall('wandb', quiet=True)
        uninstall('pynvml', quiet=True)
    ts('addons', t_start)


# check cudnn
def check_cudnn():
    import site
    site_packages = site.getsitepackages()
    cuda_path = os.environ.get('CUDA_PATH', '')
    if cuda_path == '':
        for site_package in site_packages:
            folder = os.path.join(site_package, 'nvidia', 'cudnn', 'lib')
            if os.path.exists(folder) and folder not in cuda_path:
                cuda_path = f"{cuda_path}:{folder}"
                if cuda_path.startswith(':'):
                    cuda_path = cuda_path[1:]
                os.environ['CUDA_PATH'] = cuda_path


def get_cuda_arch(capability):
    major, minor = capability
    if torch_info.get('cuda', None) is not None:
        mapping = {
            12: "Blackwell",
            10: "Blackwell",
            9: "Hopper",
            8: "Ada Lovelace" if minor == 9 else "Ampere",
            7: "Turing" if minor == 5 else "Volta",
            6: "Pascal",
            5: "Maxwell",
            4: "Kepler",
            3: "Kepler",
            2: "Fermi",
        }
        name = mapping.get(major, "")
    elif torch_info.get('rocm', None) is not None:
        mapping = {
            (8, 0): "GCN",
            (9, 0): "Vega",
            (9, 4): "Vega",
            (9, 6): "Vega",
            (10, 1): "RDNA1",
            (10, 3): "RDNA2",
            (11, 0): "RDNA3",
            (11, 5): "CDNA3",
        }
        name = mapping.get((major, minor), "")
    else:
        name = ''
    return f"{major}.{minor} {name}"


# check torch version
def check_torch():
    log.info('Torch: verifying installation')
    t_start = time.time()
    if args.skip_torch:
        log.info('Torch: skip tests')
        return
    if args.profile:
        pr = cProfile.Profile()
        pr.enable()
    allow_cuda = not (args.use_rocm or args.use_directml or args.use_ipex or args.use_openvino)
    allow_rocm = not (args.use_cuda or args.use_directml or args.use_ipex or args.use_openvino)
    allow_ipex = not (args.use_cuda or args.use_rocm or args.use_directml or args.use_openvino)
    allow_directml = not (args.use_cuda or args.use_rocm or args.use_ipex or args.use_openvino)
    allow_openvino = not (args.use_cuda or args.use_rocm or args.use_ipex or args.use_directml)
    log.debug(f'Torch overrides: cuda={args.use_cuda} rocm={args.use_rocm} ipex={args.use_ipex} directml={args.use_directml} openvino={args.use_openvino} zluda={args.use_zluda}')
    # log.debug(f'Torch allowed: cuda={allow_cuda} rocm={allow_rocm} ipex={allow_ipex} diml={allow_directml} openvino={allow_openvino}')
    torch_command = os.environ.get('TORCH_COMMAND', '')

    if sys.platform != 'win32':
        if args.use_zluda:
            log.error('ZLUDA is only supported on Windows')
        if args.use_directml:
            log.error('DirectML is only supported on Windows')

    if torch_command != '':
        is_cuda_available = False
        is_ipex_available = False
        is_rocm_available = False
    else:
        is_cuda_available = allow_cuda and (args.use_cuda or shutil.which('nvidia-smi') is not None or os.path.exists(os.path.join(os.environ.get('SystemRoot') or r'C:\Windows', 'System32', 'nvidia-smi.exe')))
        is_ipex_available = allow_ipex and (args.use_ipex or shutil.which('sycl-ls') is not None or shutil.which('sycl-ls.exe') is not None or os.environ.get('ONEAPI_ROOT') is not None or os.path.exists('/opt/intel/oneapi') or os.path.exists("C:/Program Files (x86)/Intel/oneAPI") or os.path.exists("C:/oneAPI") or os.path.exists("C:/Program Files/Intel/Intel Graphics Software"))
        is_rocm_available = False

        if not is_cuda_available and not is_ipex_available and allow_rocm:
            from modules import rocm
            is_rocm_available = allow_rocm and (args.use_rocm or args.use_zluda or rocm.is_installed) # late eval to avoid unnecessary import

        if is_cuda_available and args.use_cuda: # prioritize cuda
            torch_command = install_cuda()
        elif is_rocm_available and (args.use_rocm or args.use_zluda): # prioritize rocm
            torch_command = install_rocm_zluda()
        elif allow_ipex and args.use_ipex: # prioritize ipex
            torch_command = install_ipex()
        elif allow_openvino and args.use_openvino: # prioritize openvino
            torch_command = install_openvino()
        elif is_cuda_available:
            torch_command = install_cuda()
        elif is_rocm_available:
            torch_command = install_rocm_zluda()
        elif is_ipex_available:
            torch_command = install_ipex()
        else:
            machine = platform.machine()
            if sys.platform == 'darwin':
                torch_command = os.environ.get('TORCH_COMMAND', 'torch torchvision')
            elif allow_directml and args.use_directml and ('arm' not in machine and 'aarch' not in machine):
                log.info('DirectML: selected')
                torch_command = os.environ.get('TORCH_COMMAND', 'torch==2.4.1 torchvision torch-directml==0.2.4.dev240913')
                if 'torch' in torch_command and not args.version:
                    install(torch_command, 'torch torchvision')
                install('onnxruntime-directml', 'onnxruntime-directml', ignore=True)
            else:
                log.warning('Torch: CPU-only version installed')
                torch_command = os.environ.get('TORCH_COMMAND', 'torch torchvision')

    if args.version:
        return

    if 'torch' in torch_command:
        if not installed('torch') or args.reinstall:
            log.info(f'Install: package="torch" cmd="{torch_command}" download and install in progress... ')
            install('--upgrade pip', 'pip', reinstall=args.reinstall) # pytorch rocm is too large for older pip
            install(torch_command, 'torch torchvision', quiet=False)

    try:
        import torch
        try:
            import intel_extension_for_pytorch as ipex # pylint: disable=import-error, unused-import
            log.info(f'Torch backend: type=IPEX version={ipex.__version__}')
        except Exception:
            pass
        torch_info.set(version=torch.__version__)
        if 'cpu' in torch.__version__:
            try:
                if is_cuda_available:
                    if args.use_cuda:
                        log.warning(f'Torch: version="{torch.__version__}" CPU version installed and CUDA is selected - reinstalling')
                        install(torch_command, 'torch torchvision', quiet=True, reinstall=True, force=True) # foce reinstall
                    else:
                        log.warning(f'Torch: version="{torch.__version__}" CPU version installed and CUDA is available - consider reinstalling')
                elif is_rocm_available:
                    if args.use_rocm:
                        log.warning(f'Torch: version="{torch.__version__}" CPU version installed and ROCm is selected - reinstalling')
                        install(torch_command, 'torch torchvision', quiet=True, reinstall=True, force=True) # foce reinstall
                    else:
                        log.warning(f'Torch: version="{torch.__version__}" CPU version installed and ROCm is available - consider reinstalling')
                if args.use_openvino:
                    torch_info.set(type='openvino')
                else:
                    torch_info.set(type='cpu')
            except Exception as e:
                log.error(f'Torch: type=cpu {e}')

        if hasattr(torch, "xpu") and torch.xpu.is_available() and allow_ipex:
            try:
                if shutil.which('icpx') is not None:
                    log.info(f'{os.popen("icpx --version").read().rstrip()}')
                torch_info.set(type='xpu')
                for device in range(torch.xpu.device_count()):
                    props = torch.xpu.get_device_properties(device)
                    gpu = {
                        'gpu': torch.xpu.get_device_name(device),
                        'platform': props.platform_name,
                        'driver': props.driver_version,
                        'vram': round(props.total_memory / 1024 / 1024),
                        'units': props.max_compute_units,
                    }
                    log.info(f'Torch detected: {gpu}')
                    gpu_info.append(gpu)
            except Exception as e:
                log.error(f'Torch: type=xpu {e}')

        if torch.cuda.is_available() and (allow_cuda or allow_rocm):
            try:
                if args.use_zluda:
                    torch_info.set(type="zluda", cuda=torch.version.cuda)
                elif torch.version.cuda and allow_cuda:
                    torch_info.set(type='cuda', cuda=torch.version.cuda, cudnn=torch.backends.cudnn.version() if torch.backends.cudnn.is_available() else 'N/A')
                elif torch.version.hip and allow_rocm:
                    torch_info.set(type='rocm', hip=torch.version.hip)
                else:
                    log.warning('Torch backend: cannot detect type')
                log.info(f"Torch backend: {torch_info}")
                for device in [torch.cuda.device(i) for i in range(torch.cuda.device_count())]:
                    props = torch.cuda.get_device_properties(device)
                    gpu = {
                        'gpu': torch.cuda.get_device_name(device),
                        'vram': round(props.total_memory / 1024 / 1024),
                        'arch': get_cuda_arch(torch.cuda.get_device_capability(device)),
                        'cores': props.multi_processor_count,
                    }
                    gpu_info.append(gpu)
                    log.info(f'Torch detected: {gpu}')
            except Exception as e:
                log.error(f'Torch: type=cuda/rocm {e}')

        if args.use_directml and allow_directml:
            try:
                import torch_directml # pylint: disable=import-error
                dml_ver = package_version("torch-directml")
                log.warning(f'Torch backend: DirectML ({dml_ver})')
                log.warning('DirectML: end-of-life')
                for i in range(0, torch_directml.device_count()):
                    gpu = {
                        'gpu': torch_directml.device_name(i),
                    }
                    gpu_info.append(gpu)
                    log.info(f'Torch detected: {gpu}')
            except Exception as e:
                log.warning(f"Torch: type=directml {e}")

    except Exception as e:
        log.error(f'Torch cannot load: {e}')
        if not args.ignore:
            sys.exit(1)

    if is_rocm_available:
        rocm.postinstall()
    if not args.skip_all:
        install_torch_addons()
    check_cudnn()
    if args.profile:
        pr.disable()
        print_profile(pr, 'Torch')
    ts('torch', t_start)


# check modified files
def check_modified_files():
    t_start = time.time()
    if args.quick:
        return
    if args.skip_git:
        return
    try:
        res = git('status --porcelain')
        files = [x[2:].strip() for x in res.split('\n')]
        files = [x for x in files if len(x) > 0 and (not x.startswith('extensions')) and (not x.startswith('wiki')) and (not x.endswith('.json')) and ('.log' not in x)]
        deleted = [x for x in files if not os.path.exists(x)]
        if len(deleted) > 0:
            log.warning(f'Deleted files: {deleted}')
        modified = [x for x in files if os.path.exists(x) and not os.path.isdir(x)]
        if len(modified) > 0:
            log.warning(f'Modified files: {modified}')
    except Exception:
        pass
    ts('files', t_start)


# run extension installer
def run_extension_installer(folder):
    path_installer = os.path.realpath(os.path.join(folder, "install.py"))
    if not os.path.isfile(path_installer):
        return
    try:
        is_builtin = 'extensions-builtin' in folder
        log.debug(f'Extension installer: builtin={is_builtin} file="{path_installer}"')
        if is_builtin:
            module_spec = importlib.util.spec_from_file_location(os.path.basename(folder), path_installer)
            module = importlib.util.module_from_spec(module_spec)
            module_spec.loader.exec_module(module)
        else:
            env = os.environ.copy()
            env['PYTHONPATH'] = os.path.abspath(".")
            if os.environ.get('PYTHONPATH', None) is not None:
                separator = ';' if sys.platform == 'win32' else ':'
                env['PYTHONPATH'] += separator + os.environ.get('PYTHONPATH', None)
            result, txt = run(sys.executable, path_installer, env=env, cwd=folder)
            debug(f'Extension installer: file="{path_installer}" {result.stdout}')
            if result.returncode != 0:
                errors.append(f'ext: {os.path.basename(folder)}')
                log.error(f'Extension installer error: {path_installer}')
                log.debug(txt)
    except Exception as e:
        log.error(f'Extension installer exception: {e}')


# get list of all enabled extensions
def list_extensions_folder(folder, quiet=False):
    disabled_extensions_all = opts.get('disable_all_extensions', 'none')
    if disabled_extensions_all != 'none':
        return []
    disabled_extensions = opts.get('disabled_extensions', [])
    enabled_extensions = [x for x in os.listdir(folder) if os.path.isdir(os.path.join(folder, x)) and x not in disabled_extensions and not x.startswith('.')]
    if not quiet:
        log.info(f'Extensions: path="{folder}" enabled={enabled_extensions}')
    return enabled_extensions


# run installer for each installed and enabled extension and optionally update them
def install_extensions(force=False):
    disable_diffusers = [
        'sd-webui-controlnet',
        'multidiffusion-upscaler-for-automatic1111',
        'a1111-sd-webui-lycoris',
        'sd-webui-animatediff',
    ]
    disable_obsolete = [
        'Lora',
        'stable-diffusion-webui-rembg',
        'sd-extension-framepack',
        'sd-extension-nudenet',
        'sd-extension-promptgen',
        'sd-extension-system-info',
    ]
    if args.profile:
        pr = cProfile.Profile()
        pr.enable()
    pkgs = [f"{d.metadata['Name']}=={d.version}" for d in importlib.metadata.distributions()]
    log.debug(f'Installed packages: {len(pkgs)}')
    from modules.paths import extensions_builtin_dir, extensions_dir
    extensions_duplicates = []
    extensions_enabled = []
    extensions_disabled = [e.lower() for e in opts.get('disabled_extensions', [])]
    for ext in disable_diffusers:
        if ext.lower() not in opts.get('disabled_extensions', []):
            extensions_disabled.append(ext)
    for ext in disable_obsolete:
        if ext.lower() not in opts.get('disabled_extensions', []):
            extensions_disabled.append(ext)
    extension_folders = [extensions_builtin_dir] if args.safe else [extensions_builtin_dir, extensions_dir]
    res = []
    for folder in extension_folders:
        if not os.path.isdir(folder):
            continue
        extensions = list_extensions_folder(folder, quiet=True)
        log.debug(f'Extensions all: {extensions}')
        for ext in extensions:
            if os.path.basename(ext).lower() in extensions_disabled:
                continue
            t_start = time.time()
            if ext in extensions_enabled:
                extensions_duplicates.append(ext)
                continue
            extensions_enabled.append(ext)
            if args.upgrade or force:
                try:
                    res.append(update(os.path.join(folder, ext)))
                except Exception:
                    res.append(f'Extension update error: {os.path.join(folder, ext)}')
                    log.error(f'Extension update error: {os.path.join(folder, ext)}')
            if not args.skip_extensions:
                commit = extensions_commit.get(os.path.basename(ext), None)
                if commit is not None:
                    log.debug(f'Extension force: name="{ext}" commit={commit}')
                    res.append(git(f'checkout {commit}', os.path.join(folder, ext)))
                run_extension_installer(os.path.join(folder, ext))
            try:
                updated = [f"{d.metadata['Name']}=={d.version}" for d in importlib.metadata.distributions()]
                diff = [x for x in updated if x not in pkgs]
                pkgs = updated
                if len(diff) > 0:
                    log.info(f'Extension installed packages: {ext} {diff}')
            except Exception as e:
                log.error(f'Extension installed unknown package: {e}')
            ts(ext, t_start)
    log.info(f'Extensions enabled: {extensions_enabled}')
    if len(extensions_duplicates) > 0:
        log.warning(f'Extensions duplicates: {extensions_duplicates}')
    if args.profile:
        pr.disable()
        print_profile(pr, 'Extensions')
    # ts('extensions', t_start)
    return '\n'.join(res)


# initialize and optionally update submodules
def install_submodules(force=True):
    t_start = time.time()
    if args.profile:
        pr = cProfile.Profile()
        pr.enable()
    log.info('Verifying submodules')
    txt = git('submodule')
    # log.debug(f'Submodules list: {txt}')
    if force and 'no submodule mapping found' in txt and 'extension-builtin' not in txt:
        txt = git('submodule')
        git_reset()
        log.info('Continuing setup')
    git('submodule --quiet update --init --recursive')
    git('submodule --quiet sync --recursive')
    submodules = txt.splitlines()
    res = []
    for submodule in submodules:
        try:
            parts = submodule.split()
            if len(parts) < 2:
                continue
            name = parts[1].strip()
            if args.upgrade:
                res.append(update(name))
            else:
                branch(name)
        except Exception:
            log.error(f'Submodule update error: {submodule}')
    setup_logging()
    if args.profile:
        pr.disable()
        print_profile(pr, 'Submodule')
    ts('submodules', t_start)
    return '\n'.join(res)


def reload(package, desired=None):
    loaded = package in sys.modules
    if not loaded:
        return
    current = sys.modules[package].__version__ if hasattr(sys.modules[package], "__version__") else None
    if desired is not None and current == desired:
        return
    modules = [m for m in sys.modules if m.startswith(package)]
    for m in modules:
        del sys.modules[m]
    sys.modules[package] = importlib.import_module(package)
    importlib.reload(sys.modules[package])
    log.debug(f'Reload: package={package} version={sys.modules[package].__version__ if hasattr(sys.modules[package], "__version__") else "N/A"}')


def install_gradio():
    # pip install gradio==3.43.2 installs:
    # aiofiles-23.2.1 altair-5.5.0 annotated-types-0.7.0 anyio-4.9.0 attrs-25.3.0 certifi-2025.6.15 charset_normalizer-3.4.2 click-8.2.1 contourpy-1.3.2 cycler-0.12.1 fastapi-0.115.14 ffmpy-0.6.0 filelock-3.18.0 fonttools-4.58.4 fsspec-2025.5.1 gradio-3.43.2 gradio-client-0.5.0 h11-0.16.0 hf-xet-1.1.5 httpcore-1.0.9 httpx-0.28.1 huggingface-hub-0.33.1 idna-3.10 importlib-resources-6.5.2 jinja2-3.1.6 jsonschema-4.24.0 jsonschema-specifications-2025.4.1 kiwisolver-1.4.8 markupsafe-2.1.5 matplotlib-3.10.3 narwhals-1.45.0 numpy-1.26.4 orjson-3.10.18 packaging-25.0 pandas-2.3.0 pillow-10.4.0 pydantic-2.11.7 pydantic-core-2.33.2 pydub-0.25.1 pyparsing-3.2.3 python-dateutil-2.9.0.post0 python-multipart-0.0.20 pytz-2025.2 pyyaml-6.0.2 referencing-0.36.2 requests-2.32.4 rpds-py-0.25.1 semantic-version-2.10.0 six-1.17.0 sniffio-1.3.1 starlette-0.46.2 tqdm-4.67.1 typing-extensions-4.14.0 typing-inspection-0.4.1 tzdata-2025.2 urllib3-2.5.0 uvicorn-0.35.0 websockets-11.0.3
    if installed('gradio', quiet=True):
        return
    install('gradio==3.43.2', no_deps=True)
    install('gradio-client==0.5.0', no_deps=True, quiet=True)
    pkgs = ['fastapi', 'websockets', 'aiofiles', 'ffmpy', 'pydub', 'uvicorn', 'semantic-version', 'altair', 'python-multipart', 'matplotlib', 'importlib-resources']
    for pkg in pkgs:
        if not installed(pkg, quiet=True):
            install(pkg, quiet=True)


def install_compel():
    if installed('compel', quiet=True):
        return
    install("compel==2.4.0", no_deps=True)


def install_pydantic():
    install('pydantic==2.13.4', ignore=True, quiet=True)
    reload('pydantic', '2.13.4')


def install_scipy():
    if args.new or (sys.version_info >= (3, 14)):
        install('scipy==1.17.1', ignore=True, quiet=True)
    else:
        install('scipy==1.14.1', ignore=True, quiet=True)


def install_opencv():
    install('opencv-python==4.13.0.92', ignore=True, quiet=True)
    install('opencv-python-headless==4.13.0.92', ignore=True, quiet=True)
    install('opencv-contrib-python==4.13.0.92', ignore=True, quiet=True)
    install('opencv-contrib-python-headless==4.13.0.92', ignore=True, quiet=True)


def install_insightface():
    """
    if sys.version_info >= (3, 13):
        install('insightfacex==0.7.4', 'insightfacex', ignore=True, quiet=True)
        uninstall('albumentations')
        install('albumentationsx')
    else:
        install('git+https://github.com/deepinsight/insightface@29b6cd65aa0e9ae3b6602de3c52e9d8949c8ee86#subdirectory=python-package', 'insightface') # insightface==0.7.3 with patches
        uninstall('albumentationsx')
        install('albumentations==1.4.3', ignore=True, quiet=True)
    """
    install('insightfacex==0.7.4', 'insightfacex', ignore=True, quiet=True)
    uninstall('albumentations', quiet=True)
    install('albumentationsx', quiet=True)
    install('facexlib', no_deps=True)
    install_pydantic()


def install_optional():
    t_start = time.time()
    log.info('Installing optional requirements...')
    install('pi-heif')
    install('addict')
    install('yapf')
    install('--no-build-isolation git+https://github.com/Disty0/BasicSR@23c1fb6f5c559ef5ce7ad657f2fa56e41b121754', 'basicsr', ignore=True, quiet=True)
    install('av', ignore=True, quiet=True)
    install('beautifulsoup4', ignore=True, quiet=True)
    install('clean-fid', ignore=True, quiet=True)
    install('clip_interrogator==0.6.0', ignore=True, quiet=True)
    install('Cython', ignore=True, quiet=True)
    install('gguf', ignore=True, quiet=True)
    install('hf_transfer', ignore=True, quiet=True)
    install('hf_xet', ignore=True, quiet=True)
    install('nvidia-ml-py', ignore=True, quiet=True)
    install('pillow-jxl-plugin==1.3.7', ignore=True, quiet=True)
    install('ultralytics==8.4.67', ignore=True, quiet=True)
    install('open-clip-torch', no_deps=True, quiet=True)
    install('git+https://github.com/tencent-ailab/IP-Adapter.git', 'ip_adapter', ignore=True, quiet=True)
    # install('git+https://github.com/openai/CLIP.git', 'clip', quiet=True, no_build_isolation=True)
    ts('optional', t_start)


def install_requirements():
    t_start = time.time()
    if args.skip_requirements and not args.requirements:
        return
    if args.profile:
        pr = cProfile.Profile()
        pr.enable()
    if int(sys.version_info.minor) >= 13:
        install('audioop-lts')
    if not installed('diffusers', quiet=True) or args.reinstall: # diffusers are not installed, so run initial installation
        global quick_allowed # pylint: disable=global-statement
        quick_allowed = False
        log.info('Install requirements: this may take a while...')
        pip('install -r requirements.txt')
    if args.optional:
        quick_allowed = False
        install_optional()
    log.info('Install: verifying requirements')
    if args.new:
        log.debug('Install: flag=new')
    with open('requirements.txt', encoding='utf8') as f:
        lines = [line.strip() for line in f.readlines() if line.strip() != '' and not line.startswith('#') and line is not None]
        for line in lines:
            if not installed(line, quiet=True) or args.reinstall:
                if args.reinstall:
                    log.trace(f'Install: package="{line}" reinstall')
                _res = install(line, reinstall=args.reinstall)
    install_compel()
    install_pydantic()
    install_opencv()
    install_scipy()
    if args.profile:
        pr.disable()
        print_profile(pr, 'Requirements')
    ts('requirements', t_start)


# set environment variables controlling the behavior of various libraries
def set_environment():
    log.debug('Setting environment tuning')
    os.environ.setdefault('ACCELERATE', 'True')
    os.environ.setdefault('ATTN_PRECISION', 'fp16')
    os.environ.setdefault('ClDeviceGlobalMemSizeAvailablePercent', '100')
    os.environ.setdefault('CUDA_AUTO_BOOST', '1')
    os.environ.setdefault('CUDA_CACHE_DISABLE', '0')
    os.environ.setdefault('CUDA_DEVICE_DEFAULT_PERSISTING_L2_CACHE_PERCENTAGE_LIMIT', '0')
    os.environ.setdefault('CUDA_LAUNCH_BLOCKING', '0')
    os.environ.setdefault('CUDA_MODULE_LOADING', 'LAZY')
    os.environ.setdefault('DO_NOT_TRACK', '1')
    os.environ.setdefault('FORCE_CUDA', '1')
    os.environ.setdefault('GRADIO_ANALYTICS_ENABLED', 'False')
    os.environ.setdefault('K_DIFFUSION_USE_COMPILE', '0')
    os.environ.setdefault('KINETO_LOG_LEVEL', '3')
    os.environ.setdefault('NEOReadDebugKeys', '1')
    os.environ.setdefault('NUMEXPR_MAX_THREADS', '16')
    os.environ.setdefault('PYTHONHTTPSVERIFY', '0')
    os.environ.setdefault('PYTORCH_ENABLE_MPS_FALLBACK', '1')
    os.environ.setdefault('PYTORCH_ENABLE_XPU_FALLBACK', '1')
    os.environ.setdefault('RUNAI_STREAMER_CHUNK_BYTESIZE', '2097152')
    os.environ.setdefault('RUNAI_STREAMER_LOG_LEVEL', 'DEBUG' if os.environ.get('SD_LOAD_DEBUG') else 'WARNING')
    os.environ.setdefault('RUNAI_STREAMER_MEMORY_LIMIT', '-1')
    os.environ.setdefault('SAFETENSORS_FAST_GPU', '1')
    os.environ.setdefault('SYCL_CACHE_PERSISTENT', '1')
    os.environ.setdefault('TF_CPP_MIN_LOG_LEVEL', '2')
    os.environ.setdefault('TF_ENABLE_ONEDNN_OPTS', '0')
    os.environ.setdefault('TOKENIZERS_PARALLELISM', '0')
    os.environ.setdefault('TORCH_CUDNN_V8_API_ENABLED', '1')
    os.environ.setdefault('TORCH_FORCE_NO_WEIGHTS_ONLY_LOAD', '1')
    os.environ.setdefault('TORCH_ROCM_AOTRITON_ENABLE_EXPERIMENTAL', '1')
    os.environ.setdefault('MIOPEN_FIND_MODE', '2')
    os.environ.setdefault('UR_L0_ENABLE_RELAXED_ALLOCATION_LIMITS', '1')
    os.environ.setdefault('USE_TORCH', '1')
    os.environ.setdefault('UV_CONSTRAINT', 'constraints.txt')
    os.environ.setdefault('UV_INDEX_STRATEGY', 'unsafe-any-match')
    os.environ.setdefault('UV_NO_BUILD_ISOLATION', '1')
    os.environ.setdefault('UVICORN_TIMEOUT_KEEP_ALIVE', '60')
    allocator = f'garbage_collection_threshold:{opts.get("torch_gc_threshold", 80)/100:0.2f},max_split_size_mb:512'
    if opts.get("torch_malloc", "native") == 'cudaMallocAsync':
        allocator += ',backend:cudaMallocAsync'
    if opts.get("torch_expandable_segments", False):
        allocator += ',expandable_segments:True'
    os.environ.setdefault('PYTORCH_ALLOC_CONF', allocator)
    os.environ.setdefault('PYTORCH_CUDA_ALLOC_CONF', allocator)
    os.environ.setdefault('PYTORCH_HIP_ALLOC_CONF', allocator)
    log.debug(f'Torch allocator: "{allocator}"')


def check_extensions():
    newest_all = os.path.getmtime('requirements.txt')
    from modules.paths import extensions_builtin_dir, extensions_dir
    extension_folders = [extensions_builtin_dir] if args.safe else [extensions_builtin_dir, extensions_dir]
    disabled_extensions_all = opts.get('disable_all_extensions', 'none')
    if disabled_extensions_all != 'none':
        log.info(f'Extensions: disabled={disabled_extensions_all}')
    else:
        log.info(f'Extensions: disabled={opts.get("disabled_extensions", [])}')
    for folder in extension_folders:
        if not os.path.isdir(folder):
            continue
        extensions = list_extensions_folder(folder)
        for ext in extensions:
            newest = 0
            extension_dir = os.path.join(folder, ext)
            if not os.path.isdir(extension_dir):
                log.debug(f'Extension listed as installed but folder missing: {extension_dir}')
                continue
            for f in os.listdir(extension_dir):
                if '.json' in f or '.csv' in f or '__pycache__' in f:
                    continue
                mtime = os.path.getmtime(os.path.join(extension_dir, f))
                newest = max(newest, mtime)
            newest_all = max(newest_all, newest)
            # log.debug(f'Extension version: {time.ctime(newest)} {folder}{os.path.sep}{ext}')
    return round(newest_all)


def get_version(force=False):
    t_start = time.time()
    if (version is None) or (version.get('branch', 'unknown') == 'unknown') or force:
        try:
            subprocess.run('git config log.showsignature false', capture_output=True, shell=True, check=True)
        except Exception:
            pass

        try:
            ver = run('git', 'log --pretty=format:"%h %ad" -1 --date=short', check=True)[0].stdout or '  '
            commit, updated = ver.split(' ')
            version['commit'], version['updated'] = commit, updated
        except Exception as e:
            log.warning(f'Version: where=commit {e}')

        try:
            origin = run('git', 'remote get-url origin', check=True)[0].stdout
            branch_name = run('git', 'rev-parse --abbrev-ref HEAD', check=True)[0].stdout
            # normalize ssh remotes (git@host:owner/repo) and ssh-protocol remotes
            # (ssh://git@host/owner/repo) to the canonical https form so downstream
            # url parsers don't have to special-case each remote shape
            if origin.startswith('git@'):
                host, _, path = origin.partition(':')
                origin = f'https://{host[4:]}/{path}'
            elif origin.startswith('ssh://'):
                origin = 'https://' + origin[len('ssh://'):].split('@', 1)[-1]
            origin = origin.removesuffix('.git')
            version['url'] = origin + '/tree/' + branch_name
            version['branch'] = branch_name
            if version['branch'] == 'HEAD':
                log.warning('Version: detached state detected')
        except Exception as e:
            log.warning(f'Version: where=branch {e}')

        try:
            if os.path.exists('extensions-builtin/sdnext-modernui'):
                branch_ui = run('git', 'rev-parse --abbrev-ref HEAD', check=True, cwd='extensions-builtin/sdnext-modernui')[0].stdout
                version['ui'] = 'dev' if 'dev' in branch_ui else 'main'
            else:
                version['ui'] = 'unavailable'
        except Exception as e:
            log.warning(f'Version: where=modernui {e}')
            version['ui'] = 'unknown'

        try:
            if os.environ.get('SD_KANVAS_DISABLE', None) is not None:
                version['kanvas'] = 'disabled'
            elif os.path.exists('extensions-builtin/sdnext-kanvas'):
                branch_kanvas = run('git', 'rev-parse --abbrev-ref HEAD', check=True, cwd='extensions-builtin/sdnext-kanvas')[0].stdout
                version['kanvas'] = 'dev' if 'dev' in branch_kanvas else 'main'
            else:
                version['kanvas'] = 'unavailable'
        except Exception as e:
            log.warning(f'Version: where=kanvas {e}')
            version['kanvas'] = 'unknown'

    ts('version', t_start)
    return version


def check_ui(ver):
    def same(ver):
        core = ver['branch'] if ver is not None and 'branch' in ver else 'unknown'
        ui = ver['ui'] if ver is not None and 'ui' in ver else 'unknown'
        return (core == ui) or (core == 'master' and ui == 'main') or (core == 'dev' and ui == 'dev') or (core == 'HEAD')

    if 'vladmandic/sdnext' not in ver.get('url', ''):
        return
    t_start = time.time()
    if not same(ver):
        log.debug(f'Branch mismatch: {ver}')
        try:
            if 'dev' in ver['branch']:
                target = 'dev'
            elif 'main' in ver['branch'] or 'master' in ver['branch']:
                target = 'main'
            else:
                target =None
            if target:
                git('checkout ' + target, folder='extensions-builtin/sdnext-modernui', ignore=True, optional=True)
                ver = get_version(force=True)
                log.debug(f'Branch sync: {ver}')
        except Exception as e:
            log.debug(f'Branch switch: {e}')
    ts('ui', t_start)


def check_kanvas(ver):
    def same(ver):
        core = ver['branch'] if ver is not None and 'branch' in ver else 'unknown'
        kanvas = ver['kanvas'] if ver is not None and 'kanvas' in ver else 'unknown'
        return (core == kanvas) or (core == 'master' and kanvas == 'main') or (core == 'dev' and kanvas == 'dev') or (core == 'HEAD')

    if 'vladmandic/sdnext' not in ver.get('url', ''):
        return
    t_start = time.time()
    if not same(ver):
        log.debug(f'Branch mismatch: {ver}')
        try:
            if 'dev' in ver['branch']:
                target = 'dev'
            elif 'main' in ver['branch'] or 'master' in ver['branch']:
                target = 'main'
            else:
                target =None
            if target:
                git('checkout ' + target, folder='extensions-builtin/sdnext-kanvas', ignore=True, optional=True)
                ver = get_version(force=True)
                log.debug(f'Branch sync: {ver}')
        except Exception as e:
            log.debug(f'Branch switch: {e}')
    ts('kanvas', t_start)


def check_venv():
    def try_relpath(p):
        try:
            return os.path.relpath(p)
        except ValueError:
            return p

    t_start = time.time()
    import site
    pkg_path = [try_relpath(p) for p in site.getsitepackages() if os.path.exists(p)]
    log.debug(f'Packages: prefix={try_relpath(sys.prefix)} site={pkg_path}')
    if args.uv:
        uv_info()
    for p in pkg_path:
        invalid = []
        for f in os.listdir(p):
            if f.startswith('~'):
                invalid.append(f)
        if len(invalid) > 0:
            log.warning(f'Packages: site="{p}" invalid={invalid} removing')
        for f in invalid:
            fn = os.path.join(p, f)
            try:
                if os.path.isdir(fn):
                    shutil.rmtree(fn)
                elif os.path.isfile(fn):
                    os.unlink(fn)
            except Exception as e:
                log.error(f'Packages: site={p} invalid={f} error={e}')
    ts('venv', t_start)


# check version of the main repo and optionally upgrade it
def check_version(reset=True): # pylint: disable=unused-argument
    if opts.get('offline_mode', False):
        log.warning('Offline mode enabled')
        args.skip_git = True # pylint: disable=attribute-defined-outside-init
        args.skip_all = True # pylint: disable=attribute-defined-outside-init
        return
    t_start = time.time()
    if args.skip_all:
        return
    if not os.path.exists('.git'):
        log.warning('Not a git repository')
        args.skip_git = True # pylint: disable=attribute-defined-outside-init
    ver = get_version()
    log.info(f'Version: {print_dict(ver)}')
    branch_name = ver.get('branch', None) if ver is not None else 'master'
    if branch_name is None or branch_name == 'unknown':
        branch_name = 'master'
    if args.version or args.skip_git:
        return
    check_ui(ver)
    check_kanvas(ver)
    commit = git('rev-parse HEAD')
    global git_commit # pylint: disable=global-statement
    git_commit = commit[:7]
    if args.quick:
        return
    try:
        import requests
    except ImportError:
        return
    commits = None
    branch_names = []
    try:
        if ver and 'url' in ver:
            url_parts = ver['url'].replace('https://github.com/', '').split('/tree/')[0]
            api_base = f'https://api.github.com/repos/{url_parts}'
        else:
            api_base = 'https://api.github.com/repos/vladmandic/sdnext'
        branches = requests.get(f'{api_base}/branches', timeout=5).json()
        if not isinstance(branches, list):
            log.error(f'Repository: branches API returned {branches!r} from {api_base}')
            return
        branch_names = [b['name'] for b in branches if 'name' in b]
        log.trace(f'Repository branches: active={branch_name} available={branch_names}')
    except Exception as e:
        log.error(f'Repository: failed to get branches: {e}')
        return
    if branch_name not in branch_names:
        log.warning(f'Repository: branch={branch_name} skipping update')
        ts('latest', t_start)
        return
    try:
        commits = requests.get(f'{api_base}/branches/{branch_name}', timeout=5).json()
        latest = commits['commit']['sha']
        if len(latest) != 40:
            log.error(f'Repository error: commit={latest} invalid')
        elif latest != commit and args.upgrade:
            global quick_allowed # pylint: disable=global-statement
            quick_allowed = False
            log.info('Updating main repository')
            try:
                git('add .')
                git('stash')
                update('.', keep_branch=True)
                # git('git stash pop')
                ver = git('log -1 --pretty=format:"%h %ad"')
                log.info(f'Repository upgraded: {ver}')
                log.warning('Server restart is recommended to apply changes')
                if ver == latest: # double check
                    restart()
            except Exception:
                if not reset:
                    log.error('Repository error upgrading')
                else:
                    log.warning('Repository: retrying upgrade...')
                    git_reset()
                    check_version(reset=False)
        else:
            dt = commits["commit"]["commit"]["author"]["date"]
            commit = commits["commit"]["sha"][:8]
            log.info(f'Version: app=sd.next latest={dt} hash={commit} branch={branch_name}')
    except Exception as e:
        log.error(f'Repository failed to check version: {e} {commits}')
    ts('latest', t_start)


def update_wiki():
    t_start = time.time()
    if args.upgrade:
        log.info('Updating Wiki')
        try:
            update(os.path.join(os.path.dirname(__file__), "wiki"))
        except Exception:
            log.error('Wiki update error')
    ts('wiki', t_start)


@lru_cache
def get_state():
    state = {
        'version': version,
        'torch': os.environ.get('TORCH_COMMAND', 'unknown'),
        'python': sys.version,
        'platform': sys.platform,
        'requirements': 'unknown',
        'installer': 'unknown',
        'extensions': {}
    }
    try:
        import hashlib
        with open('requirements.txt', 'rb') as f:
            state['requirements'] = hashlib.sha256(f.read()).hexdigest()
        with open('installer.py', 'rb') as f:
            state['installer'] = hashlib.sha256(f.read()).hexdigest()
    except Exception:
        pass
    try:
        from concurrent.futures.thread import ThreadPoolExecutor
        from modules.paths import extensions_builtin_dir, extensions_dir
        extension_folders = [extensions_builtin_dir] if args.safe else [extensions_builtin_dir, extensions_dir]
        ext_dirs = []
        for folder in extension_folders:
            if not os.path.isdir(folder):
                continue
            for ext in list_extensions_folder(folder, quiet=True):
                ext_dirs.append((ext, os.path.join(folder, ext)))

        def _get_commit(item):
            ext, ext_dir = item
            try:
                return ext, run('git', 'rev-parse HEAD', cwd=ext_dir)[0].stdout
            except Exception:
                return ext, ''

        with ThreadPoolExecutor(max_workers=min(len(ext_dirs), 8), thread_name_prefix='sdnext-git') as pool:
            for ext, commit in pool.map(_get_commit, ext_dirs):
                if commit:
                    state['extensions'][ext] = commit
    except Exception:
        pass
    return state


def check_state():
    if not os.path.isfile('data/installer.json'):
        return False
    try:
        with open('data/installer.json', 'r', encoding='utf8') as f:
            saved_state = json.load(f)
        unchanged = saved_state == get_state()
        log.debug(f'State: cached={unchanged}')
        return unchanged
    except Exception:
        return False


def update_state():
    try:
        state = get_state()
        if not os.path.exists('data'):
            os.makedirs('data')
        with open('data/installer.json', 'w', encoding='utf8') as f:
            json.dump(state, f, indent=4)
        log.debug(f'State: file="{os.path.abspath("data/installer.json")}"')
    except Exception as e:
        log.error(f'State save error: {e}')


# check if we can run setup in quick mode
def check_timestamp():
    if not quick_allowed or not os.path.isfile(log_file):
        return False
    if args.quick:
        return True
    if args.skip_git:
        return True
    return check_state()


def add_args(parser):
    group_install = parser.add_argument_group('Install')
    group_install.add_argument('--quick', default=env_flag("SD_QUICK", False), action='store_true', help="Bypass version checks, default: %(default)s")
    group_install.add_argument('--reset', default=env_flag("SD_RESET", False), action='store_true', help="Reset main repository to latest version, default: %(default)s")
    group_install.add_argument('--upgrade', '--update', default=env_flag("SD_UPGRADE", False), action='store_true', help="Upgrade main repository to latest version, default: %(default)s")
    group_install.add_argument('--requirements', default=env_flag("SD_REQUIREMENTS", False), action='store_true', help="Force re-check of requirements, default: %(default)s")
    group_install.add_argument('--reinstall', default=env_flag("SD_REINSTALL", False), action='store_true', help="Force reinstallation of all requirements, default: %(default)s")
    group_install.add_argument('--uv', default=env_flag("SD_UV", False), action='store_true', help="Use uv instead of pip to install the packages")
    group_install.add_argument('--optional', default=env_flag("SD_OPTIONAL", False), action='store_true', help="Force installation of optional requirements, default: %(default)s")
    group_install.add_argument('--skip-requirements', default=env_flag("SD_SKIPREQUIREMENTS", False), action='store_true', help="Skips checking and installing requirements, default: %(default)s")
    group_install.add_argument('--skip-extensions', default=env_flag("SD_SKIPEXTENSION", False), action='store_true', help="Skips running individual extension installers, default: %(default)s")
    group_install.add_argument('--skip-git', default=env_flag("SD_SKIPGIT", False), action='store_true', help="Skips running all GIT operations, default: %(default)s")
    group_install.add_argument('--skip-torch', default=env_flag("SD_SKIPTORCH", False), action='store_true', help="Skips running Torch checks, default: %(default)s")
    group_install.add_argument('--skip-all', default=env_flag("SD_SKIPALL", False), action='store_true', help="Skips running all checks, default: %(default)s")
    group_install.add_argument('--skip-env', default=env_flag("SD_SKIPENV", False), action='store_true', help="Skips setting of env variables during startup, default: %(default)s")


def parse_args(parser):
    # command line args
    global args # pylint: disable=global-statement
    if "USED_VSCODE_COMMAND_PICKARGS" in os.environ:
        import shlex
        argv = shlex.split(" ".join(sys.argv[1:])) if "USED_VSCODE_COMMAND_PICKARGS" in os.environ else sys.argv[1:]
        log.debug('VSCode Launch')
        args = parser.parse_args(argv)
    else:
        args = parser.parse_args()
    return args


def extensions_preload(parser):
    t_start = time.time()
    if args.profile:
        pr = cProfile.Profile()
        pr.enable()
    if args.safe:
        log.info('Running in safe mode without user extensions')
    try:
        from modules.script_loading import preload_extensions
        from modules.paths import extensions_builtin_dir, extensions_dir
        extension_folders = [extensions_builtin_dir] if args.safe else [extensions_builtin_dir, extensions_dir]
        preload_time = {}
        for ext_dir in extension_folders:
            t0 = time.time()
            preload_extensions(ext_dir, parser)
            t1 = time.time()
            preload_time[ext_dir] = round(t1 - t0, 2)
        log.debug(f'Extension preload: {preload_time}')
    except Exception:
        log.error('Error running extension preloading')
    if args.profile:
        pr.disable()
        print_profile(pr, 'Preload')
    ts('preload', t_start)


def git_reset(folder='.'):
    t_start = time.time()
    log.warning('Running GIT reset')
    global quick_allowed # pylint: disable=global-statement
    quick_allowed = False
    b = branch(folder)
    if b is None or b == '':
        b = 'master'
    git('add .')
    git('stash')
    git('merge --abort', folder=None, ignore=True)
    git('fetch --all')
    git(f'reset --hard origin/{b}')
    git(f'checkout {b}')
    git('submodule update --init --recursive')
    git('submodule sync --recursive')
    log.info('GIT reset complete')
    ts('reset', t_start)


def read_options():
    t_start = time.time()
    global opts # pylint: disable=global-statement
    if os.path.isfile(args.config):
        with open(args.config, encoding="utf8") as file:
            try:
                opts = json.load(file)
                if type(opts) is str:
                    opts = json.loads(opts)
            except Exception as e:
                log.error(f'Error reading options file: {file} {e}')
    if os.path.isfile(args.secrets):
        with open(args.secrets, encoding="utf8") as file:
            try:
                secrets = json.load(file)
                if type(secrets) is str:
                    secrets = json.loads(secrets)
                opts = opts | secrets
            except Exception as e:
                log.error(f"Error reading secrets file: {file} {e}")
    ts('options', t_start)


def ensure_base_requirements():
    t_start = time.time()
    setuptools_version = '69.5.1'
    if (args.uv or '--uv' in sys.argv) and (shutil.which('uv') is not None): # early enable uv
        args.uv = True # pylint: disable=attribute-defined-outside-init
        uv_info()

    def update_setuptools():
        local_log = logging.getLogger('sdnext.installer')
        global setuptools, distutils # pylint: disable=global-statement
        # python may ship with incompatible setuptools
        if args.uv:
            subprocess.run(f'uv pip install setuptools=={setuptools_version} wheel', shell=True, check=False, env=os.environ, capture_output=True)
        else:
            subprocess.run(f'"{sys.executable}" -m pip install setuptools=={setuptools_version} wheel', shell=True, check=False, env=os.environ, capture_output=True)
        # need to delete all references to modules to be able to reload them otherwise python will use cached version
        modules = [m for m in sys.modules if m.startswith('setuptools') or m.startswith('distutils')]
        for m in modules:
            del sys.modules[m]
        try:
            setuptools = importlib.import_module('setuptools')
            sys.modules['setuptools'] = setuptools
        except ImportError as e:
            local_log.info(f'Python: version={platform.python_version()} platform={platform.system()} bin="{sys.executable}" venv="{sys.prefix}"')
            local_log.critical(f'Import: setuptools {e}')
            os._exit(1)
        try:
            distutils = importlib.import_module('distutils')
            sys.modules['distutils'] = distutils
        except ImportError as e:
            local_log.info(f'Python: version={platform.python_version()} platform={platform.system()} bin="{sys.executable}" venv="{sys.prefix}"')
            local_log.critical(f'Import: distutils {e}')
            os._exit(1)
        try:
            distutils = importlib.import_module('distutils')
            sys.modules['distutils'] = distutils
        except ImportError as e:
            local_log.info(f'Python: version={platform.python_version()} platform={platform.system()} bin="{sys.executable}" venv="{sys.prefix}"')
            local_log.critical(f'Import: distutils {e}')
            os._exit(1)

    try:
        global setuptools # pylint: disable=global-statement
        import wheel # pylint: disable=unused-import
        import setuptools # pylint: disable=redefined-outer-name
        if setuptools.__version__ != setuptools_version:
            update_setuptools()
    except ImportError:
        update_setuptools()

    # used by installer itself so must be installed before requirements
    install('rich==15.0.0', 'rich', quiet=True)
    install('psutil', 'psutil', quiet=True)
    install('requests==2.32.3', 'requests', quiet=True)
    ts('base', t_start)


# startup
ensure_base_requirements()
from modules.logger import setup_logging # must be loaded after ensure_base_requirements
from modules.logger import log as log_instance
log = log_instance