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
#!/bin/bash
# SPDX-License-Identifier: AGPL-3.0-only
# Copyright 2026-present the Unsloth AI Inc. team. All rights reserved. See /studio/LICENSE.AGPL-3.0
# uninstall.sh must remove the prebuilt siblings and their .install.lock files, since one stray
# lock makes the final `rmdir ~/.unsloth` fail. Runs the real uninstaller on a fixture HOME.
set -e
SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
UNINSTALL_SH="$SCRIPT_DIR/../../scripts/uninstall.sh"
PASS=0
FAIL=0
# Skip on WSL: the real uninstaller reaches host state outside the fixture HOME there.
if grep -qi microsoft /proc/version 2>/dev/null; then
echo " SKIP: WSL -- the uninstall body reaches Windows-side state outside the fixture"
exit 0
fi
_TMP_ROOT=$(mktemp -d)
trap 'rm -rf "$_TMP_ROOT"' EXIT
unset UNSLOTH_STUDIO_HOME STUDIO_HOME UNSLOTH_UNINSTALL_ROCM
# audio.cpp's link farm sits beside the HF hub cache these name; the default is under HOME.
unset HF_HUB_CACHE HUGGINGFACE_HUB_CACHE HF_HOME XDG_CACHE_HOME
TMPDIR="$_TMP_ROOT/tmp"
export TMPDIR
mkdir -p "$TMPDIR"
XDG_RUNTIME_DIR="$_TMP_ROOT/run"
export XDG_RUNTIME_DIR
mkdir -p "$XDG_RUNTIME_DIR"
assert_gone() {
if [ -e "$2" ] || [ -L "$2" ]; then
echo " FAIL: $1 (still present: $2)"; FAIL=$((FAIL + 1))
else
echo " PASS: $1"; PASS=$((PASS + 1))
fi
}
assert_kept() {
if [ -e "$2" ] || [ -L "$2" ]; then
echo " PASS: $1"; PASS=$((PASS + 1))
else
echo " FAIL: $1 (missing: $2)"; FAIL=$((FAIL + 1))
fi
}
# Explicit mktemp template: BSD mktemp without one implies -t and lands outside _TMP_ROOT.
make_home() {
FIXTURE_HOME=$(mktemp -d "$_TMP_ROOT/home.XXXXXX")
mkdir -p "$FIXTURE_HOME/.unsloth/studio/unsloth_studio/bin" \
"$FIXTURE_HOME/.unsloth/llama.cpp/build/bin" \
"$FIXTURE_HOME/.unsloth/node/bin" \
"$FIXTURE_HOME/.unsloth/whisper.cpp/build/bin" \
"$FIXTURE_HOME/.unsloth/audio.cpp" \
"$FIXTURE_HOME/.cache/huggingface/hub/models--audio-cpp--audio.cpp-gguf" \
"$FIXTURE_HOME/.cache/huggingface/unsloth-audiocpp-links/kokoro" \
"$TMPDIR/unsloth-audiocpp-home-$(id -u)/.config" \
"$TMPDIR/unsloth-audiocpp-home-not-this-user" \
"$FIXTURE_HOME/.unsloth/.cache" \
"$FIXTURE_HOME/.unsloth/.staging" \
"$FIXTURE_HOME/.local/share/unsloth" \
"$FIXTURE_HOME/.local/bin"
: > "$FIXTURE_HOME/.unsloth/studio/unsloth_studio/bin/unsloth"
: > "$FIXTURE_HOME/.unsloth/studio/unsloth_studio/.unsloth-studio-owned"
: > "$FIXTURE_HOME/.unsloth/llama.cpp/build/bin/llama-server"
: > "$FIXTURE_HOME/.unsloth/node/bin/node"
: > "$FIXTURE_HOME/.unsloth/whisper.cpp/build/bin/whisper-server"
: > "$FIXTURE_HOME/.unsloth/audio.cpp/audiocpp_server"
: > "$FIXTURE_HOME/.unsloth/audio.cpp/.unsloth-studio-owned"
: > "$FIXTURE_HOME/.cache/huggingface/hub/models--audio-cpp--audio.cpp-gguf/model.gguf"
: > "$FIXTURE_HOME/.cache/huggingface/unsloth-audiocpp-links/kokoro/model.gguf"
: > "$FIXTURE_HOME/.unsloth/.llama.cpp.install.lock"
: > "$FIXTURE_HOME/.unsloth/.node.install.lock"
: > "$FIXTURE_HOME/.unsloth/.whisper.cpp.install.lock"
: > "$FIXTURE_HOME/.unsloth/.audio.cpp.install.lock"
: > "$FIXTURE_HOME/.unsloth/.audio.cpp.install.lock.stale.4242"
# Abandoned locks are renamed, not deleted, so they accumulate across interrupted runs.
: > "$FIXTURE_HOME/.unsloth/.node.install.lock.stale.12345"
: > "$FIXTURE_HOME/.unsloth/.llama.cpp.install.lock.stale.6789"
ln -s "$FIXTURE_HOME/.unsloth/studio/unsloth_studio/bin/unsloth" \
"$FIXTURE_HOME/.local/bin/unsloth"
}
echo "=== every prebuilt artifact is removed, then ~/.unsloth is pruned ==="
make_home
HOME="$FIXTURE_HOME" sh "$UNINSTALL_SH" > "$_TMP_ROOT/out.log" 2>&1 || {
echo " FAIL: uninstall exited $?"; FAIL=$((FAIL + 1)); cat "$_TMP_ROOT/out.log"; }
assert_gone "studio install dir" "$FIXTURE_HOME/.unsloth/studio"
assert_gone "llama.cpp prebuilt" "$FIXTURE_HOME/.unsloth/llama.cpp"
assert_gone "node runtime" "$FIXTURE_HOME/.unsloth/node"
assert_gone "whisper.cpp prebuilt" "$FIXTURE_HOME/.unsloth/whisper.cpp"
assert_gone "audio.cpp prebuilt" "$FIXTURE_HOME/.unsloth/audio.cpp"
assert_gone "prebuilt cache" "$FIXTURE_HOME/.unsloth/.cache"
assert_gone "staging dir" "$FIXTURE_HOME/.unsloth/.staging"
assert_gone "llama.cpp install lock" "$FIXTURE_HOME/.unsloth/.llama.cpp.install.lock"
assert_gone "node install lock" "$FIXTURE_HOME/.unsloth/.node.install.lock"
assert_gone "whisper.cpp install lock" "$FIXTURE_HOME/.unsloth/.whisper.cpp.install.lock"
assert_gone "audio.cpp install lock" "$FIXTURE_HOME/.unsloth/.audio.cpp.install.lock"
assert_gone "stale audio.cpp lock" "$FIXTURE_HOME/.unsloth/.audio.cpp.install.lock.stale.4242"
assert_gone "audio.cpp model link farm" "$FIXTURE_HOME/.cache/huggingface/unsloth-audiocpp-links"
assert_kept "the HF cache itself stays" "$FIXTURE_HOME/.cache/huggingface/hub/models--audio-cpp--audio.cpp-gguf/model.gguf"
assert_gone "audio.cpp scratch home" "$TMPDIR/unsloth-audiocpp-home-$(id -u)"
assert_kept "another user's is kept" "$TMPDIR/unsloth-audiocpp-home-not-this-user"
assert_gone "stale node lock" "$FIXTURE_HOME/.unsloth/.node.install.lock.stale.12345"
assert_gone "stale llama.cpp lock" "$FIXTURE_HOME/.unsloth/.llama.cpp.install.lock.stale.6789"
assert_gone "~/.unsloth is pruned" "$FIXTURE_HOME/.unsloth"
assert_gone "CLI shim" "$FIXTURE_HOME/.local/bin/unsloth"
echo "=== user content under ~/.unsloth is never removed ==="
# rmdir refuses a non-empty directory, which is what protects user files. The
# uninstaller must still clear its own artifacts around them.
make_home
mkdir -p "$FIXTURE_HOME/.unsloth/my-own-models"
: > "$FIXTURE_HOME/.unsloth/my-own-models/keep-me.gguf"
: > "$FIXTURE_HOME/.unsloth/notes.txt"
HOME="$FIXTURE_HOME" sh "$UNINSTALL_SH" > "$_TMP_ROOT/out2.log" 2>&1 || {
echo " FAIL: uninstall exited $?"; FAIL=$((FAIL + 1)); cat "$_TMP_ROOT/out2.log"; }
assert_kept "a user directory survives" "$FIXTURE_HOME/.unsloth/my-own-models/keep-me.gguf"
assert_kept "a user file survives" "$FIXTURE_HOME/.unsloth/notes.txt"
assert_kept "~/.unsloth kept for user content" "$FIXTURE_HOME/.unsloth"
assert_gone "artifacts still cleared" "$FIXTURE_HOME/.unsloth/whisper.cpp"
assert_gone "locks still cleared" "$FIXTURE_HOME/.unsloth/.node.install.lock"
echo "=== an unmarked ~/.unsloth/audio.cpp is the user's own build ==="
make_home
rm -f "$FIXTURE_HOME/.unsloth/audio.cpp/.unsloth-studio-owned"
HOME="$FIXTURE_HOME" sh "$UNINSTALL_SH" > "$_TMP_ROOT/out4.log" 2>&1 || {
echo " FAIL: uninstall exited $?"; FAIL=$((FAIL + 1)); cat "$_TMP_ROOT/out4.log"; }
assert_kept "an unmarked audio.cpp build survives" "$FIXTURE_HOME/.unsloth/audio.cpp/audiocpp_server"
assert_gone "marked siblings still go" "$FIXTURE_HOME/.unsloth/whisper.cpp"
echo "=== a missing ~/.unsloth is a clean no-op ==="
FIXTURE_HOME=$(mktemp -d "$_TMP_ROOT/empty.XXXXXX")
if HOME="$FIXTURE_HOME" sh "$UNINSTALL_SH" > "$_TMP_ROOT/out3.log" 2>&1; then
echo " PASS: uninstalling a machine with no install exits 0"; PASS=$((PASS + 1))
else
echo " FAIL: uninstalling a machine with no install exited $?"; FAIL=$((FAIL + 1))
fi
echo ""
echo "Results: $PASS passed, $FAIL failed"
[ "$FAIL" = 0 ]