From edd2daa16a7afba8d9fe20edcf400ba28b6f5ac4 Mon Sep 17 00:00:00 2001 From: Bryan Van Deusen Date: Fri, 25 Sep 2026 09:58:48 -0400 Subject: [PATCH] docs: the README says ML tagging ships off and fetches its weights when enabled MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The first-run note still said the ML worker downloads its model weights on first boot. Milestone 422 moved that fetch to the moment the ML lane is enabled under Settings → System, and the lane ships at 0 slots. The overview paragraph is also the first release's notes (release_notes.py reads it between the overview markers), so it now says the same. Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01LVjrnpQjRgHdvq95rASoiR --- README.md | 12 ++++++++---- 1 file changed, 8 insertions(+), 4 deletions(-) diff --git a/README.md b/README.md index e5348c3..ed78b17 100644 --- a/README.md +++ b/README.md @@ -22,7 +22,8 @@ through afterwards. - **ML tagging.** Runs image models in-container to suggest tags, group characters, find near-duplicates and power similarity search. Suggestions are reviewable — it proposes, you confirm, and it learns which proposals you keep - rejecting. + rejecting. It ships switched off: turn it on under Settings → System when + you want it, and it fetches its model weights then. - **Deduplication and provenance.** Everything that arrives is hashed and deduplicated by content, metadata sidecars are read wherever the source writes them, and every file keeps a record of where it came from. @@ -119,9 +120,12 @@ needs every credential entered again by hand. A few other things are worth knowing about the first few minutes: -- **The ML worker downloads its model weights on first boot**, several GB from - HuggingFace into `./models`. Until that finishes, tagging is queued rather - than broken. It is idempotent — a restart resumes rather than refetches. +- **ML tagging starts switched off, and nothing is downloaded at boot.** Give + the ML lane a slot under **Settings → System** and it fetches its model + weights then — several GB from HuggingFace into `./models`, shown as a job + under **Settings → Activity** that you can watch and retry. Until it + finishes, tagging is queued rather than broken, and the fetch only takes + what is missing, so turning the lane off and on again does not refetch. - **The gallery starts empty**, and that is the expected state. Add a creator under **Subscriptions** and it fills as posts come down. - **If you already have a library on disk**, there is no screen that imports