Skip to content

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.

2.7 KB
Raw Blame
# SPDX-License-Identifier: AGPL-3.0-only
# Copyright 2026-present the Unsloth AI Inc. team. All rights reserved. See /studio/LICENSE.AGPL-3.0

"""`python -I -m unsloth_cli` -- reach the CLI without the generated console script.

Windows materialises the `unsloth` entry point as a generated, unsigned
`unsloth.exe`. AppLocker, WDAC and Smart App Control deny that executable while
the signed interpreter beside it keeps running, so `unsloth ...` is unusable on
a locked-down machine even though the install is perfectly healthy (issue
https://github.com/unslothai/unsloth/issues/8490). This module is the supported
way in for those users, and for anyone who would rather not depend on a
generated launcher:

    python -X utf8 -I -m unsloth_cli studio -p 8888

Use -I when that `python` is the managed Unsloth interpreter, which is what every
command Unsloth prints does. `-m` resolves the package before this file runs, so a
shell standing in a directory that has an `unsloth_cli` folder would otherwise run
that copy, and -I drops the working directory from sys.path first.

A `pip install --user` install is the exception: -I implies -s, so it hides the very
user site the package lives in and the command cannot find it at all. There, run the
same bootstrap the internal call sites use, which strips only the working directory:

    python -X utf8 -c "import sys, os; sys.path[:1] = [x for x in sys.path[:1] if getattr(sys.flags, 'safe_path', False) or x not in ('', os.getcwd())]; sys.argv[0] = 'unsloth'; from unsloth_cli import app; sys.exit(app())" studio -p 8888

Output is identical to the console script, which takes three things:

  * argv[0] is rewritten, so anything reading it sees the name the console
    script would have given it.
  * _prepare_entry_point() applies the rest of the console-script behaviour
    (UTF-8 streams, the `-np<N>` rewrite). The import-time gate in
    unsloth_cli/__init__ cannot do it here, because `-m` imports the package in
    order to locate this module: __init__ has already run, with argv[0] still
    "-m", before the first statement below executes.
  * prog_name is passed explicitly. click ignores argv[0] once it sees a
    __main__ with a __package__ (its _detect_program_name treats that as "python
    -m example") and would print `Usage: python -m unsloth_cli` in every usage
    and error message.
"""

import sys

if __name__ == "__main__":
    # Worker processes import this file as __mp_main__; they must not launch the CLI.
    sys.argv[0] = "unsloth"

    import unsloth_cli

    unsloth_cli._prepare_entry_point()
    # A returned value must become the exit status, like the console script's sys.exit(app()).
    sys.exit(unsloth_cli.app(prog_name = "unsloth"))