Skip to content

fix(models): gate Browse installs to chat brains only - #337

Merged
quiet-node merged 1 commit into
mainfrom
fix/gguf-role-gate
Jul 17, 2026
Merged

fix(models): gate Browse installs to chat brains only#337
quiet-node merged 1 commit into
mainfrom
fix/gguf-role-gate

Conversation

@quiet-node

Copy link
Copy Markdown
Owner

Description

Browse-all and paste-repo no longer treat every GGUF as a chat model. Multi-file HF repos often ship vision projectors and helpers next to text weights; users were downloading those small files, seeing Ready, then failing at engine start (for example unsupported model architecture: 'clip'). This change classifies artifacts by role and only offers supported chat weights as primary downloads.

Key changes

  • Add a pure GGUF role classifier (Primary / Projector / Helper) driven by metadata when present, with filename as a soft list-time signal.
  • Browse and paste listings show only chat-weight candidates; mid-name projectors (for example Bonsai-27B-mmproj-*.gguf) and helpers (dspark / MTP / draft) are not standalone downloads.
  • Brain install still auto-attaches a projector companion by role onto one manifest row for --mmproj.
  • Finalize and load refuse non-primary artifacts with clear user-facing copy; CLIP load errors map to projector messaging.
  • Docs updated for Browse vision detection; staff picks and text-only single-file models keep existing behavior.

Testing

  • Unit tests cover classification, listing, resolve attach/reject, finalize gate, and load preflight paths.
  • bun run test:all:coverage (100% line gate) and bun run validate-build passed in the worktree.

Signed-off-by: Logan Nguyen <lg.131.dev@gmail.com>
@quiet-node
quiet-node merged commit 07e0b35 into main Jul 17, 2026
6 checks passed
@quiet-node
quiet-node deleted the fix/gguf-role-gate branch July 17, 2026 22:32
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant