diff --git a/docs/install.md b/docs/install.md index 9324278..1d9a01f 100644 --- a/docs/install.md +++ b/docs/install.md @@ -735,9 +735,12 @@ requests. On a slow model, set `timeouts.generation` higher. ## Known gaps, so you find them here rather than at 2am -- **A fetch is silent while it runs.** llmgw will fetch weights for you, but - it reports no progress, so a first start on a large model looks like a hang. - `ls -l` in the model directory is the only progress bar there is. +- **A fetch reports its progress where nobody is looking.** The agent logs a + percentage as it downloads, so `journalctl -u llmgw-agent` on that node knows + exactly how far along it is. Nothing carries it to the control plane, so from + `ctl` or the dashboard a replica pulling a hundred gigabytes and one that is + wedged still look identical — which is the comparison the log line itself + says matters. - **Every node fetches its own copy.** There is no seeding between nodes, so bringing up eight nodes on a new model is eight downloads from the same origin. On a fabric where the nodes can see each other this is wasteful, and