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
# SPDX-License-Identifier: AGPL-3.0-only
# Copyright 2026-present the Unsloth AI Inc. team. All rights reserved.
<#
Source scan of setup.ps1's "install blocked" reporting: llama.cpp exit 3 must not name
a process, and a Node kept on exit 0 must relay the installer's repair lines.
#>
BeforeAll {
$candidates = @(
$env:SETUP_PS1_PATH,
(Join-Path $PSScriptRoot '..\..\studio\setup.ps1')
) | Where-Object { $_ }
$script:SetupPs1 = $candidates | Where-Object { Test-Path -LiteralPath $_ } | Select-Object -First 1
if (-not $script:SetupPs1) { throw "Could not locate studio/setup.ps1 (set SETUP_PS1_PATH)." }
$script:SetupText = Get-Content -Raw -LiteralPath $script:SetupPs1
$script:NodeInstaller = Get-Content -Raw -LiteralPath (Join-Path (Split-Path -Parent $script:SetupPs1) 'install_node_prebuilt.py')
# Inline installer flow, not functions, so slice from the marker to its closing brace.
function Get-BlockSource {
param(
[Parameter(Mandatory)][string]$Path,
[Parameter(Mandatory)][string]$Marker,
[Parameter(Mandatory)][string]$ClosePattern
)
$lines = @(Get-Content -LiteralPath $Path)
$start = -1
for ($i = 0; $i -lt $lines.Count; $i++) {
if ($lines[$i] -match [regex]::Escape($Marker)) { $start = $i; break }
}
if ($start -lt 0) { return $null }
$indent = ($lines[$start] -replace '\S.*$', '').Length
for ($j = $start + 1; $j -lt $lines.Count; $j++) {
$depth = ($lines[$j] -replace '\S.*$', '').Length
if ($lines[$j] -match $ClosePattern -and $depth -le $indent) {
return ($lines[$start..($j - 1)] -join "`n")
}
}
return $null
}
$script:LlamaBusy = Get-BlockSource -Path $script:SetupPs1 `
-Marker '$prebuiltExit -eq 3' -ClosePattern '^\s*\}\s*(elseif|else)\b'
$script:WhisperBusy = Get-BlockSource -Path $script:SetupPs1 `
-Marker '$whisperExit -eq 3' -ClosePattern '^\s*\}\s*(elseif|else)\b'
$script:LocalLinkBusy = Get-BlockSource -Path $script:SetupPs1 `
-Marker '(Get-PathState -Path $LlamaCppDir) -ne "Absent"' -ClosePattern '^\s*\}\s*$'
# Anchored on the exit-code chain: the mirror retry between them closes first.
$script:NodeExit = Get-BlockSource -Path $script:SetupPs1 `
-Marker '$nodeExit -eq 3' -ClosePattern '^\s*\}\s*$'
}
Describe 'no llama.cpp blocked-install message names a cause setup cannot determine' {
It 'the process headline appears nowhere in setup.ps1' {
$script:SetupText | Should -Not -Match 'install blocked by active llama\.cpp process'
}
It 'the process failure message appears nowhere in setup.ps1' {
$script:SetupText | Should -Not -Match 'blocked by an active llama\.cpp process'
}
It 'every blocked-install site offers ACL repair' {
([regex]::Matches($script:SetupText, 'repair the ACLs')).Count |
Should -BeGreaterOrEqual 2
}
}
Describe 'the prebuilt exit-3 branch' {
It 'is present in setup.ps1' {
$script:LlamaBusy | Should -Not -BeNullOrEmpty
}
It 'offers ACL repair alongside closing other users' {
$script:LlamaBusy | Should -Match 'repair the ACLs'
}
It 'only names ACL repair when the helper emitted recovery guidance' {
$script:LlamaBusy | Should -Match '\$prebuiltOutput -match [''"]takeown /F[''"]'
}
It 'keeps a close-users-only fallback without recovery guidance' {
$script:LlamaBusy | Should -Match '(?s)else\s*\{.+Close Unsloth or other llama\.cpp users and retry'
}
It 'still terminates with exit code 3' {
$script:LlamaBusy | Should -Match 'Exit-SetupFailure .+ 3'
}
It 'still prints the installer output carrying the takeown/icacls commands' {
$script:LlamaBusy | Should -Match 'Write-LlamaFailureLog -Output \$prebuiltOutput'
}
It 'still reports that the previous install was restored' {
$script:LlamaBusy | Should -Match 'Existing install was restored'
}
It 'still tells the user to close other llama.cpp users' {
$script:LlamaBusy | Should -Match 'Close Unsloth or other llama\.cpp users'
}
}
Describe 'the local-directory link path mirrors it, as its comment claims' {
It 'is present in setup.ps1' {
$script:LocalLinkBusy | Should -Not -BeNullOrEmpty
}
It 'offers ACL repair on the install directory' {
$script:LocalLinkBusy | Should -Match 'repair the ACLs on \$LlamaCppDir'
}
It 'still terminates with exit code 3' {
$script:LocalLinkBusy | Should -Match 'Exit-SetupFailure .+ 3'
}
It 'still tells the user to close other llama.cpp users' {
$script:LocalLinkBusy | Should -Match 'Close Unsloth or other llama\.cpp users'
}
}
Describe 'the whisper.cpp exit-3 branch remains the cause-neutral precedent' {
It 'is present in setup.ps1' {
$script:WhisperBusy | Should -Not -BeNullOrEmpty
}
It 'names no process and no scanner' {
$script:WhisperBusy | Should -Not -Match '(?i)process|scanner'
}
}
Describe 'a Node the installer kept because it could not be replaced' {
BeforeAll {
$script:NodeKept = $null
if ($script:NodeExit) {
$at = $script:NodeExit.IndexOf('keeping existing isolated Node')
if ($at -ge 0) { $script:NodeKept = $script:NodeExit.Substring($at) }
}
}
It 'the Node exit handling is present in setup.ps1' {
$script:NodeExit | Should -Not -BeNullOrEmpty
}
It 'matches the line the Node installer logs when it keeps an install' {
$script:NodeInstaller | Should -Match 'keeping existing isolated Node'
$script:NodeExit | Should -Match '\$nodeOut -match [''"]keeping existing isolated Node[''"]'
}
It 'is reached only after both failure arms, so only on exit 0' {
$failure = $script:NodeExit.IndexOf('$nodeExit -ne 0')
$failure | Should -BeGreaterOrEqual 0
$script:NodeExit.IndexOf('keeping existing isolated Node') | Should -BeGreaterThan $failure
}
It 'warns and carries on rather than failing setup' {
$script:NodeKept | Should -Match 'step "node" "update not applied, existing isolated Node kept" "Yellow"'
$script:NodeKept | Should -Not -Match 'Exit-SetupFailure'
}
It 'relays the installer output only when it carries the takeown/icacls lines' {
$script:NodeKept | Should -Match '(?s)\$nodeOut -match [''"]takeown /F[''"]\)\s*\{\s*Write-StudioLine \$nodeOut'
}
}