summaryrefslogtreecommitdiffstats
path: root/desktop/modules/ai/README.md
diff options
context:
space:
mode:
authorDanilo M. <danix@danix.xyz>2026-10-28 09:15:55 +0100
committerDanilo M. <danix@danix.xyz>2026-10-28 09:15:55 +0100
commit779492e8b40084032e218c89f211e60527a28b98 (patch)
tree30a99cfa626374a60a58688558516802a74aea7b /desktop/modules/ai/README.md
parente59745a38b56d2517b8c006279ea6d07f8047678 (diff)
downloadquickshell-779492e8b40084032e218c89f211e60527a28b98.tar.gz
quickshell-779492e8b40084032e218c89f211e60527a28b98.zip
ai: unload llama's model from the engine row
The llama.cpp row offers Unload while a model is loaded. It posts to the router's /models/unload, which frees the VRAM and leaves llama-server up, so its web UI stays available; the engines themselves are still never stopped from here. The answer is not read: the next poll shows the row without a model, or with it if the unload failed. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Diffstat (limited to 'desktop/modules/ai/README.md')
-rw-r--r--desktop/modules/ai/README.md6
1 files changed, 4 insertions, 2 deletions
diff --git a/desktop/modules/ai/README.md b/desktop/modules/ai/README.md
index 5aec615..e71159b 100644
--- a/desktop/modules/ai/README.md
+++ b/desktop/modules/ai/README.md
@@ -8,8 +8,10 @@ The tile counts running apps and names any engine that is generating, or says
## Engines
llama.cpp (`llama-server`, router mode, port 8181) and stable-diffusion.cpp
-(`sd-server`, started by `~/bin/sd-webui`). Both rows are read-only: each
-engine also serves a web UI, and stopping it would take that down.
+(`sd-server`, started by `~/bin/sd-webui`). Neither is ever stopped: each
+engine also serves a web UI, and stopping it would take that down. llama's
+row offers Unload while a model is loaded, `POST /models/unload` to the
+router, which frees the VRAM and leaves the server up.
llama's state comes from its API: `/models` for the loaded model, then
`/slots?model=<id>&autoload=false` for whether a slot is processing. The