local-offload-setuplisted
Install: claude install-skill dmmdea/offload-harness
# local-offload-setup
This skill is a **thin wrapper**. The canonical, always-current procedure lives in the repo at
**`setup/SETUP-AGENT.md`** — follow that, not a copy here, so the skill can never drift from the
scripts it drives.
## Hardware gate
| Detected | Backend | Notes |
|---|---|---|
| NVIDIA GPU (~8 GB VRAM) | `cuda` | First-class. `nvidia-smi` or CIM name match selects it. |
| AMD Radeon, incl. RDNA3 iGPU (780M / gfx1103) | `vulkan` | **Native Windows Vulkan.** ROCm/HIP and WSL2-for-iGPU are research-verified dead ends — do NOT attempt. |
| No GPU | `cpu` | Fallback. Slow (`<8 t/s`); 26B tier needs ≥48 GB RAM. |
| RAM < 32 GB | (any) | Install E4B workhorse only: `OFFLOAD_WITH_FAMILY=0`. |
| Free disk < 25 GB | — | Hard blocker; `detect.ps1` exits 1. |
## Procedure
Run the three scripts in order, reading each one's final JSON line, and follow
`setup/SETUP-AGENT.md` for the decision tree at every branch:
```powershell
pwsh -NoProfile -File setup\detect.ps1 # -> backend + blockers
pwsh -NoProfile -File setup\install.ps1 # -> pinned binaries, models, Go build, rendered yaml
pwsh -NoProfile -File setup\selftest.ps1 # -> receipt JSON: verdict pass|warn|fail
```
Then start the stack and register the MCP (Step 3 of `setup/SETUP-AGENT.md`):
```powershell
& "$env:OFFLOAD_HOME\llama-swap\llama-swap.exe" --config "$env:OFFLOAD_HOME\llama-swap.yaml" --listen 127.0.0.1:11436
claude mcp add local-offload -- "$env:OFFLOAD_HOME\harness\local-offload.exe" mcp
`