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
# `notools` allows git only for remotes named in UNSLOTH_ALLOW_GIT_FROM requirement files;
# remoteless lines must be uv cache ops, counted only after an allowed fetch.
set -e
SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
REPO_ROOT="$SCRIPT_DIR/../.."
ASSERT_SH="$REPO_ROOT/.github/scripts/clean-machine-assert.sh"
SHIPPED_PIN="$REPO_ROOT/studio/backend/requirements/diffusers-main.txt"
ROOT=$(mktemp -d)
trap 'rm -rf "$ROOT"' EXIT
# The shipped pin is commented out whenever a Diffusers release carries every family, so the
# allowance is exercised on the same file with its requirement line uncommented (a no-op when active).
PIN="$ROOT/diffusers-main.txt"
sed 's/^# diffusers @ git+/diffusers @ git+/' "$SHIPPED_PIN" > "$PIN"
PASS=0
FAIL=0
expect_rc() {
_label="$1"; _expected="$2"; _allow="$3"; _trace_content="$4"
# Where each git line ran: uv's checkout unless the row says otherwise, or "none".
_cwd="${5:-$CACHE/checkouts/76e25d04238765dd/${SHA:0:9}}"
printf '%b' "$_trace_content" > "$ROOT/trace.log"
rm -f "$ROOT/trace.log.git-cwd"
if [ "$_cwd" != none ]; then
awk -F '\t' -v cwd="$_cwd" '$1 == "git" { print cwd "\t" $2 }' "$ROOT/trace.log" \
> "$ROOT/trace.log.git-cwd"
fi
set +e
UV_CACHE_DIR="$UV_CACHE" UNSLOTH_ALLOW_GIT_FROM="$_allow" UNSLOTH_TOOL_TRACE="$ROOT/trace.log" \
INSTALL_LOG="$ROOT/install.log" bash "$ASSERT_SH" notools \
> "$ROOT/out.log" 2>&1
_actual=$?
set -e
if [ "$_actual" -eq "$_expected" ]; then
echo " PASS: $_label"
PASS=$((PASS + 1))
else
echo " FAIL: $_label (expected rc $_expected, got $_actual)"
cat "$ROOT/out.log"
FAIL=$((FAIL + 1))
fi
}
: > "$ROOT/install.log"
REMOTE=$(sed -n 's/^[^#]*git+\(https:\/\/[^@]*\)@.*/\1/p' "$PIN")
SHA=$(sed -n 's/^[^#]*git+https:\/\/[^@]*@\([0-9a-f]*\).*/\1/p' "$PIN")
[ -n "$REMOTE" ] && [ -n "$SHA" ] || { echo "no git+ pin in $PIN"; exit 1; }
UV_CACHE=/Users/runner/work/unsloth/unsloth/.clean-machine/uv-cache
CACHE=$UV_CACHE/git-v0
UV_CLONE="git\t--version
git\t-c remote.origin.url=$REMOTE submodule update --init
git\tclone --local $CACHE/db/76e25d04238765dd $CACHE/checkouts/76e25d04238765dd/${SHA:0:9}
git\tfetch --tags --force --update-head-ok $REMOTE +refs/heads/*:refs/remotes/origin/* +HEAD:refs/remotes/origin/HEAD
git\tinit
git\treset --hard $SHA
git\trev-parse
git\trev-parse --short $SHA
git\trev-parse $SHA^0
git\trev-parse HEAD
git\tsubmodule update --recursive --init
xcode-select\t-p
"
# uv 0.13 (the pinned release): git-v1, and the pinned commit fetched by its own refspec.
CACHE1=$UV_CACHE/git-v1
UV13_CLONE="git\t--version
git\t-c remote.origin.url=$REMOTE submodule update --init
git\tclone --local $CACHE1/db/76e25d04238765dd $CACHE1/checkouts/76e25d04238765dd/${SHA:0:9}
git\tfetch --force --update-head-ok $REMOTE +$SHA:refs/commit/$SHA
git\tinit
git\treset --hard $SHA
git\trev-parse
git\trev-parse --short $SHA
git\trev-parse $SHA^0
git\trev-parse HEAD
git\tsubmodule update --recursive --init
xcode-select\t-p
"
echo "=== pinned git+ remotes ==="
expect_rc "uv cloning the pinned Diffusers build passes" 0 "$PIN" "$UV_CLONE"
expect_rc "uv 0.13 cloning it through git-v1 passes" 0 "$PIN" "$UV13_CLONE" "$CACHE1/checkouts/76e25d04238765dd/${SHA:0:9}"
expect_rc "the uv 0.13 trace fails with no allowance" 1 "" "$UV13_CLONE" "$CACHE1/checkouts/76e25d04238765dd/${SHA:0:9}"
expect_rc "the same trace fails with no allowance, as before" 1 "" "$UV_CLONE"
expect_rc "an allowance file that does not exist allows nothing" 1 "$ROOT/missing.txt" "$UV_CLONE"
expect_rc "the installer's git --version probe alone passes" 0 "$PIN" "git\t--version\n"
COMMENTED_PIN="$ROOT/commented-diffusers-main.txt"
sed 's/^diffusers @ git+/# diffusers @ git+/' "$SHIPPED_PIN" > "$COMMENTED_PIN"
expect_rc "a commented-out pin allows no clone" 1 "$COMMENTED_PIN" "$UV_CLONE"
# An overlay-free leg installs the released wheel, which can pin an older commit than this
# checkout's file; uv's checkout is named after the commit it installs.
OLDER=1111111111111111111111111111111111111111
FETCH="git\tfetch --tags --force --update-head-ok $REMOTE +HEAD:refs/remotes/origin/HEAD\n"
OLDER_PIN="$ROOT/older-diffusers-main.txt"
printf 'diffusers @ git+%s@%s\n' "$REMOTE" "$OLDER" > "$OLDER_PIN"
expect_rc "a released package pinning another commit passes in its own checkout" 0 "$OLDER_PIN" \
"${FETCH}git\treset --hard $OLDER\n" "$CACHE/checkouts/76e25d04238765dd/${OLDER:0:9}"
expect_rc "a reset to a commit the passed file does not pin fails, even in its checkout" 1 "$PIN" \
"${FETCH}git\treset --hard $OLDER\n" "$CACHE/checkouts/76e25d04238765dd/${OLDER:0:9}"
expect_rc "a reset outside uv's checkouts fails" 1 "$OLDER_PIN" \
"${FETCH}git\treset --hard $OLDER\n" "/home/someone/${OLDER:0:9}"
expect_rc "a short or abbreviated reset target fails" 1 "$OLDER_PIN" \
"${FETCH}git\treset --hard ${OLDER:0:9}\n" "$CACHE/checkouts/76e25d04238765dd/${OLDER:0:9}"
expect_rc "git init outside uv's cache fails" 1 "$PIN" \
"${FETCH}git\tinit\n" /Users/runner/work/unsloth/unsloth
expect_rc "rev-parse outside uv's cache fails" 1 "$PIN" \
"${FETCH}git\trev-parse HEAD\n" /Users/runner/work/unsloth/unsloth
expect_rc "git init in uv's database passes" 0 "$PIN" \
"${FETCH}git\tinit\n" "$CACHE/db/76e25d04238765dd"
SSH_PIN="$ROOT/ssh-pin.txt"
printf 'pkg @ git+ssh://[email protected]/org/repo.git@%s\n' "$SHA" > "$SSH_PIN"
expect_rc "an ssh requirement keeps its user in the allowed remote" 0 "$SSH_PIN" \
"git\tfetch --force ssh://[email protected]/org/repo.git +HEAD:refs/remotes/origin/HEAD\n"
expect_rc "an ssh requirement does not allow its bare scheme and user" 1 "$SSH_PIN" \
"git\tfetch --force ssh://git +HEAD:refs/remotes/origin/HEAD\n"
# The installed package's pin file can differ from this checkout's; only the passed file counts.
INSTALLED_PIN="$ROOT/installed-diffusers-main.txt"
printf 'diffusers @ git+https://github.com/example/diffusers-fork.git@%s\n' "$SHA" > "$INSTALLED_PIN"
expect_rc "the installed package's remote is allowed" 0 "$INSTALLED_PIN" \
"git\tfetch --force https://github.com/example/diffusers-fork.git +HEAD:refs/remotes/origin/HEAD\n"
expect_rc "this checkout's remote is then a hit" 1 "$INSTALLED_PIN" \
"git\tfetch --force $REMOTE +HEAD:refs/remotes/origin/HEAD\n"
expect_rc "a remote with the .git suffix dropped still matches" 0 "$PIN" \
"git\tfetch ${REMOTE%.git} +HEAD:refs/remotes/origin/HEAD\n"
echo "=== everything else is still a hit ==="
expect_rc "cloning any other remote fails" 1 "$PIN" \
"${UV_CLONE}git\tclone https://github.com/someone/else.git /tmp/else\n"
expect_rc "an scp-style remote that is not pinned fails" 1 "$PIN" \
"${UV_CLONE}git\tfetch [email protected]:someone/else.git\n"
expect_rc "a config-injected remote that is not pinned fails" 1 "$PIN" \
"${UV_CLONE}git\t-c remote.origin.url=https://example.com/x.git submodule update\n"
expect_rc "a lookalike host that only starts with the pin fails" 1 "$PIN" \
"git\tfetch ${REMOTE%.git}-fork.git +HEAD:refs/remotes/origin/HEAD\n"
expect_rc "remoteless git with no allowed fetch fails" 1 "$PIN" \
"git\tinit\ngit\trev-parse HEAD\n"
expect_rc "a remoteless fetch beside the allowed one fails (its URL is in config)" 1 "$PIN" \
"${UV_CLONE}git\tfetch origin\n"
expect_rc "a local clone outside uv's cache fails" 1 "$PIN" \
"${UV_CLONE}git\tclone /tmp/unrelated /tmp/out\n"
expect_rc "a local clone that climbs out of uv's cache fails" 1 "$PIN" \
"${UV_CLONE}git\tclone --local $CACHE/db/x/../../../x $CACHE/checkouts/x/y\n"
expect_rc "a reset to a commit nothing pins fails" 1 "$PIN" \
"${UV_CLONE}git\treset --hard 0000000000000000000000000000000000000000\n"
expect_rc "any other remoteless subcommand fails" 1 "$PIN" \
"${UV_CLONE}git\tpull\n"
expect_rc "an allowed remote with an extra -c option fails" 1 "$PIN" \
"${UV_CLONE}git\t-c core.sshCommand=evil fetch $REMOTE\n"
expect_rc "pushing to the allowed remote fails" 1 "$PIN" \
"${UV_CLONE}git\tpush $REMOTE HEAD:refs/heads/oops\n"
expect_rc "cloning the allowed remote outside uv's fetch fails" 1 "$PIN" \
"${UV_CLONE}git\tclone $REMOTE /tmp/out\n"
expect_rc "a -c after the subcommand fails too" 1 "$PIN" \
"${UV_CLONE}git\tfetch -c core.sshCommand=evil $REMOTE\n"
expect_rc "a remote URL as an option value is not the repository" 1 "$PIN" \
"${UV_CLONE}git\tfetch --all --server-option=$REMOTE\n"
expect_rc "an option value alone does not count as the allowed fetch" 1 "$PIN" \
"git\tfetch --all --server-option=$REMOTE\ngit\tinit\n"
expect_rc "an unknown fetch option before the repository fails" 1 "$PIN" \
"${UV_CLONE}git\tfetch --upload-pack=evil $REMOTE +HEAD:refs/remotes/origin/HEAD\n"
expect_rc "an option after the repository fails" 1 "$PIN" \
"${UV_CLONE}git\tfetch $REMOTE --upload-pack=evil\n"
expect_rc "a second repository in the refspec slot fails" 1 "$PIN" \
"${UV_CLONE}git\tfetch $REMOTE https://github.com/someone/else.git\n"
expect_rc "submodule update run outside uv's checkout fails" 1 "$PIN" \
"$UV_CLONE" /home/someone/other-repo
expect_rc "submodule update run in a path that climbs out of uv's checkouts fails" 1 "$PIN" \
"$UV_CLONE" "$CACHE/checkouts/../../elsewhere"
expect_rc "a trace with no record of where git ran fails" 1 "$PIN" "$UV_CLONE" none
expect_rc "submodule update with any other option fails" 1 "$PIN" \
"${UV_CLONE}git\t-c remote.origin.url=$REMOTE submodule update --remote\n"
expect_rc "a compiler next to the allowed clone still fails" 1 "$PIN" \
"${UV_CLONE}clang\t-c foo.c\n"
expect_rc "brew next to the allowed clone still fails" 1 "$PIN" \
"${UV_CLONE}brew\tinstall cmake\n"
echo "=== the trace wrapper's working-directory record ==="
# A fresh trace must start the git-cwd record empty, or a rerun is judged by older rows.
ENV_SH="$REPO_ROOT/.github/scripts/clean-machine-env.sh"
if command -v git >/dev/null 2>&1; then
CM="$ROOT/cm"
CLEAN_MACHINE_DIR="$CM" CLEAN_ENV_FILE="$ROOT/cm.env" bash "$ENV_SH" trace > "$ROOT/cm1.log" 2>&1
mkdir -p "$ROOT/elsewhere"
( cd "$ROOT/elsewhere" && "$CM/bin/git" --version > /dev/null )
_record=$(cat "$CM/tool-invocations.log.git-cwd" 2>/dev/null || true)
if [ "$_record" = "$(cd "$ROOT/elsewhere" && pwd) --version" ]; then
echo " PASS: the git wrapper records its working directory"; PASS=$((PASS + 1))
else
echo " FAIL: the git wrapper records its working directory (got: $_record)"; FAIL=$((FAIL + 1))
fi
CLEAN_MACHINE_DIR="$CM" CLEAN_ENV_FILE="$ROOT/cm.env" bash "$ENV_SH" trace > "$ROOT/cm2.log" 2>&1
if [ ! -s "$CM/tool-invocations.log.git-cwd" ]; then
echo " PASS: a new trace starts the record empty"; PASS=$((PASS + 1))
else
echo " FAIL: a new trace starts the record empty"; FAIL=$((FAIL + 1))
fi
fi
echo ""
echo "Passed: $PASS, Failed: $FAIL"
[ "$FAIL" -eq 0 ]