aboutsummaryrefslogtreecommitdiff
path: root/assets/outbox/2026-05-28-from-rulesets-local-llm-install.org
diff options
context:
space:
mode:
authorCraig Jennings <c@cjennings.net>2026-05-29 21:11:06 -0500
committerCraig Jennings <c@cjennings.net>2026-05-29 21:11:06 -0500
commit60ebd8e0b3e4b35b2f46444feffab075a43c4ef6 (patch)
tree4fd20bef92663cb796d722d84d3e18fdc5e76479 /assets/outbox/2026-05-28-from-rulesets-local-llm-install.org
parente6572d23b4d10c095eba45a8e37b1282185fcf4d (diff)
downloadarchsetup-60ebd8e0b3e4b35b2f46444feffab075a43c4ef6.tar.gz
archsetup-60ebd8e0b3e4b35b2f46444feffab075a43c4ef6.zip
chore(todo): file local-llm and uv install tasks; process inbox
Filed two new [#B] parent tasks. The local offline LLM runtime task carries design-decision and implementation children for resolving the open design questions alongside implementation work. The uv install task matches the existing eask/signal-cli tooling-codification shape — load-bearing for other projects, manually installed today, codify so fresh installs pick it up. Four cross-project handoffs moved to outbox.
Diffstat (limited to 'assets/outbox/2026-05-28-from-rulesets-local-llm-install.org')
-rw-r--r--assets/outbox/2026-05-28-from-rulesets-local-llm-install.org88
1 files changed, 88 insertions, 0 deletions
diff --git a/assets/outbox/2026-05-28-from-rulesets-local-llm-install.org b/assets/outbox/2026-05-28-from-rulesets-local-llm-install.org
new file mode 100644
index 0000000..c3cbdaa
--- /dev/null
+++ b/assets/outbox/2026-05-28-from-rulesets-local-llm-install.org
@@ -0,0 +1,88 @@
+#+TITLE: Install local offline LLM runtime and model cache
+#+DATE: 2026-05-28
+#+SOURCE_PROJECT: rulesets
+#+REQUEST_TYPE: install-feature
+#+STARTUP: showall
+
+* Request
+
+Please add local offline LLM support to =archsetup='s normal install process so
+machines can run a local coding agent when there is no network.
+
+This came from the =rulesets= generic-agent-runtime design pass. =rulesets=
+should become runtime-neutral, but it needs =archsetup= to provision the local
+model runtime and prefetch model files while network is available.
+
+* Hardware-specific recommendations
+
+** High-end Strix Halo machine
+
+Detected with =inxi=:
+
+- AMD Ryzen AI Max+ 395
+- 128 GiB RAM
+- Radeon 8060S / Strix Halo unified memory
+
+Install:
+
+- Default offline coding model:
+ =Qwen3-Coder-30B-A3B-Instruct-GGUF=, prefer =Q6_K= on this machine.
+- Compatibility quant:
+ =Qwen3-Coder-30B-A3B-Instruct-GGUF Q4_K_M=.
+- Larger general/long-context fallback:
+ =Qwen3-Next-80B-A3B-Instruct-GGUF Q4_K_M=.
+
+** velox
+
+Detected with =ssh velox inxi -C -G -m -S --filter=:
+
+- Intel Core i7-1370P
+- 64 GiB RAM
+- Intel Iris Xe integrated graphics
+
+Install:
+
+- Strongest practical offline coding default:
+ =Qwen3-Coder-30B-A3B-Instruct-GGUF Q4_K_M=.
+- Add an 8B fallback model for quick edits and low-latency triage.
+
+Expect =velox= to be CPU/low-end-iGPU bound. The 30B model fits, but latency
+will be the limiting factor.
+
+* Runtime stack
+
+Recommended packages/components:
+
+- =llama.cpp= with CPU and Vulkan support where practical.
+- Optional =ollama= as a simple model manager/API for workflows that prefer it.
+- A shared local model cache, e.g. =~/.local/share/llm/models= or
+ =/srv/models/llm=.
+- OpenAI-compatible local endpoints:
+ - coding model on =127.0.0.1:8081=
+ - larger/general model on =127.0.0.1:8082= when installed
+ - leave =127.0.0.1:11434= for =ollama= if used
+
+* Install behavior
+
+- Install runtime packages during normal setup.
+- Prefetch model files when network is available.
+- Make model download idempotent: skip if exact file already exists.
+- Do not make the install fail hard if model download is unavailable; surface a
+ clear follow-up saying local offline LLM support is incomplete.
+- Add a smoke test command that starts the local endpoint and asks a short prompt.
+
+* Why this belongs in archsetup
+
+=rulesets= can provide the runtime manifests, launcher behavior, and project
+instructions, but it should not own machine provisioning. =archsetup= already
+owns package installation and per-host setup, so it is the right place to install
+=llama.cpp=/=ollama= and maintain the machine-local model inventory.
+
+* Sources checked
+
+- Qwen3-Coder 30B GGUF quant listings show Q4_K_M around 18.6 GB and Q6_K around
+ 25.1 GB.
+- Qwen3-Next 80B GGUF model card shows Q4_K_M around 48.4 GB and native 262K
+ context.
+- =llama.cpp= supports CPU and GPU backends including Vulkan/HIP/ROCm; keep the
+ backend configurable per host.