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
# Guards install.sh's shell-rc PATH append (POSIX and fish arms): an unwritable rc must warn,
# print the manual line and return 0 under `set -e`, written as ONE redirect.
set -e
SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
INSTALL_SH="$SCRIPT_DIR/../../install.sh"
PASS=0
FAIL=0
assert_contains() {
_label="$1"; _haystack="$2"; _needle="$3"
if echo "$_haystack" | grep -qF "$_needle"; then
echo " PASS: $_label"
PASS=$((PASS + 1))
else
echo " FAIL: $_label (expected to find '$_needle')"
echo " ---- output ----"; echo "$_haystack" | sed 's/^/ | /'
FAIL=$((FAIL + 1))
fi
}
assert_not_contains() {
_label="$1"; _haystack="$2"; _needle="$3"
if echo "$_haystack" | grep -qF "$_needle"; then
echo " FAIL: $_label (found '$_needle' but should not)"
echo " ---- output ----"; echo "$_haystack" | sed 's/^/ | /'
FAIL=$((FAIL + 1))
else
echo " PASS: $_label"
PASS=$((PASS + 1))
fi
}
_FN_FILE=$(mktemp)
{
grep '^_PATH_LINE_RE=' "$INSTALL_SH"
sed -n '/^_persist_fish_path_dir()/,/^}/p' "$INSTALL_SH"
sed -n '/^_persist_login_path_dir()/,/^}/p' "$INSTALL_SH"
} > "$_FN_FILE"
for _fn in _persist_fish_path_dir _persist_login_path_dir; do
if ! grep -q "^$_fn()" "$_FN_FILE"; then
echo "FAIL: could not extract $_fn from install.sh"
echo " (it must stay a top-level function so this test can reach it)"
exit 1
fi
done
if ! grep -q '^_PATH_LINE_RE=' "$_FN_FILE"; then
echo "FAIL: could not extract _PATH_LINE_RE from install.sh"
exit 1
fi
_HARNESS=$(mktemp)
cat > "$_HARNESS" <<'HARNESS'
C_WARN=''; C_ERR=''; C_OK=''; C_DIM=''; C_RST=''
step() { echo "STEP $1 $2"; }
substep() { echo "SUBSTEP $1"; }
HARNESS
_SH="${BASH:-/bin/bash}"
# `set -e` mirrors install.sh; $5 pins the profile file and SHELL is forced non-fish.
_run() { # $1 = rc path
( LC_ALL=C SHELL=/bin/bash "$_SH" -c "set -e; . '$_HARNESS'; . '$_FN_FILE'; _persist_login_path_dir \"\$HOME/.local/bin\" '\$HOME/.local/bin' '~/.local/bin' '\\.local/bin' '$1'; echo \"RC=\$?\"" 2>&1 )
}
_run_fish() { # $1 = HOME
( LC_ALL=C HOME="$1" SHELL=/usr/bin/fish "$_SH" -c "set -e; . '$_HARNESS'; . '$_FN_FILE'; _persist_login_path_dir \"\$HOME/.local/bin\" '\$HOME/.local/bin' '~/.local/bin' '\\.local/bin'; echo \"RC=\$?\"" 2>&1 )
}
_TMP=$(mktemp -d)
trap 'rm -rf "$_TMP" "$_FN_FILE" "$_HARNESS"' EXIT
echo "=== writable rc: appends the export ==="
_rc="$_TMP/.bashrc"; : > "$_rc"
_out=$(_run "$_rc")
assert_contains "reports the append" "$_out" "STEP path added ~/.local/bin to PATH"
assert_contains "returns 0" "$_out" "RC=0"
assert_contains "export written" "$(cat "$_rc")" 'export PATH="$HOME/.local/bin:$PATH"'
assert_contains "marker written" "$(cat "$_rc")" '# Added by Unsloth installer'
echo "=== already mentions .local/bin: left untouched (idempotent) ==="
_rc2="$_TMP/.bashrc_existing"
printf 'export PATH="$HOME/.local/bin:$PATH"\n' > "$_rc2"
_before=$(cat "$_rc2")
_out=$(_run "$_rc2")
assert_contains "returns 0" "$_out" "RC=0"
assert_not_contains "no second append" "$_out" "added ~/.local/bin"
if [ "$(cat "$_rc2")" = "$_before" ]; then
echo " PASS: file unchanged"; PASS=$((PASS + 1))
else
echo " FAIL: file changed on a re-run"; FAIL=$((FAIL + 1))
fi
echo "=== no home at all (nothing to write to): no-op ==="
_out=$( env -u HOME "$_SH" -c "set -e; . '$_HARNESS'; . '$_FN_FILE'; _persist_login_path_dir '/x/.local/bin' '\$HOME/.local/bin' '~/.local/bin' '\\.local/bin'; echo \"RC=\$?\"" 2>&1 )
assert_contains "returns 0" "$_out" "RC=0"
assert_not_contains "no step" "$_out" "STEP path"
echo "=== READ-ONLY rc: warns, does not fail the install ==="
# Root ignores the write bit, so skip there.
_rc3="$_TMP/.bashrc_ro"; : > "$_rc3"; chmod 0444 "$_rc3"
if [ "$(id -u)" = "0" ] || { echo x >> "$_rc3"; } 2>/dev/null; then
echo " SKIP: cannot make a file unwritable as this user (running as root?)"
: > "$_rc3"
else
_out=$(_run "$_rc3")
assert_contains "returns 0 (set -e survives)" "$_out" "RC=0"
assert_contains "warns about the rc" "$_out" "could not write"
assert_contains "prints the manual line" "$_out" 'export PATH="$HOME/.local/bin:$PATH"'
assert_contains "reassures install is fine" "$_out" "only the PATH line is missing"
assert_not_contains "does not claim success" "$_out" "added ~/.local/bin to PATH in"
# `>> file 2>/dev/null` still prints the error: redirections apply left to right.
assert_not_contains "no raw shell diagnostic" "$_out" "Permission denied"
if [ ! -s "$_rc3" ]; then
echo " PASS: read-only file left empty (no partial write)"; PASS=$((PASS + 1))
else
echo " FAIL: read-only file was modified"; FAIL=$((FAIL + 1))
fi
fi
chmod 0644 "$_rc3" 2>/dev/null || true
echo "=== fish: writable conf.d gets the drop-in ==="
_fhome="$_TMP/fishhome"; mkdir -p "$_fhome"
_out=$(_run_fish "$_fhome")
assert_contains "returns 0" "$_out" "RC=0"
assert_contains "reports the add" "$_out" "STEP path added ~/.local/bin to PATH"
assert_contains "fish_add_path written" "$(cat "$_fhome/.config/fish/conf.d/unsloth.fish" 2>&1)" "fish_add_path '$_fhome/.local/bin'"
echo "=== fish: re-run is idempotent ==="
_before=$(cat "$_fhome/.config/fish/conf.d/unsloth.fish")
_out=$(_run_fish "$_fhome")
assert_contains "returns 0" "$_out" "RC=0"
if [ "$(cat "$_fhome/.config/fish/conf.d/unsloth.fish")" = "$_before" ]; then
echo " PASS: fish file unchanged"; PASS=$((PASS + 1))
else
echo " FAIL: fish file changed on a re-run"; FAIL=$((FAIL + 1))
fi
echo "=== fish: READ-ONLY drop-in warns, does not fail the install ==="
_fro="$_TMP/fishro"; mkdir -p "$_fro/.config/fish/conf.d"
_frofile="$_fro/.config/fish/conf.d/unsloth.fish"; : > "$_frofile"; chmod 0444 "$_frofile"
if [ "$(id -u)" = "0" ] || { echo x >> "$_frofile"; } 2>/dev/null; then
echo " SKIP: cannot make a file unwritable as this user (running as root?)"
else
_out=$(_run_fish "$_fro")
assert_contains "returns 0 (set -e survives)" "$_out" "RC=0"
assert_contains "warns about the drop-in" "$_out" "could not write"
assert_contains "prints the manual line" "$_out" "fish_add_path '$_fro/.local/bin'"
assert_contains "reassures install is fine" "$_out" "only the PATH line is missing"
assert_not_contains "does not claim success" "$_out" "added ~/.local/bin to PATH in"
assert_not_contains "no raw shell diagnostic" "$_out" "Permission denied"
fi
chmod 0644 "$_frofile" 2>/dev/null || true
echo ""
echo "PASS=$PASS FAIL=$FAIL"
[ "$FAIL" -eq 0 ]