#33 - tui: Model browser — Hugging Face integration - charles/loom

charles commented

2026-04-11 13:05:07 +00:00

Owner

User story

As a user, I want a Hugging Face tab in the model browser so I can search and install HF-hosted models (especially base diffusion models and Flux) with the same UX as CivitAI.

Acceptance criteria

Tab

Second source tab, selectable with 2
Reuses the generic model-browser layout (search + results + detail)

Search & browse

Backed by the Hugging Face Lua plugin through loom-core
Filters: pipeline tag (text-to-image, image-to-image), base model, library
Each card shows preview image (if available), repo id, downloads, likes

Install

Enter or i installs the selected file/revision to the configured model directory, tracking progress
u sets the installed model as active on the Generate screen

Auth

Honours an HF token configured under Settings → Sharing/API Keys
On 401, surfaces a notification with remediation hint

Tests

Unit test: token presence adds the Authorization header to the mocked HTTP call
Unit test: install dispatches to the HF plugin with the expected revision id

Out of scope

CivitAI tab (separate ticket)
Local tab (separate ticket)
IP-Adapter filter (separate ticket)

References

Spec §4.3 "Model Browser Screen"

## User story As a user, I want a Hugging Face tab in the model browser so I can search and install HF-hosted models (especially base diffusion models and Flux) with the same UX as CivitAI. ## Acceptance criteria ### Tab - [ ] Second source tab, selectable with `2` - [ ] Reuses the generic model-browser layout (search + results + detail) ### Search & browse - [ ] Backed by the Hugging Face Lua plugin through `loom-core` - [ ] Filters: pipeline tag (text-to-image, image-to-image), base model, library - [ ] Each card shows preview image (if available), repo id, downloads, likes ### Install - [ ] `Enter` or `i` installs the selected file/revision to the configured model directory, tracking progress - [ ] `u` sets the installed model as active on the Generate screen ### Auth - [ ] Honours an HF token configured under Settings → Sharing/API Keys - [ ] On 401, surfaces a notification with remediation hint ### Tests - [ ] Unit test: token presence adds the `Authorization` header to the mocked HTTP call - [ ] Unit test: install dispatches to the HF plugin with the expected revision id ## Out of scope - CivitAI tab (separate ticket) - Local tab (separate ticket) - IP-Adapter filter (separate ticket) ## References - Spec §4.3 "Model Browser Screen"

charles added this to the loom-tui v0.1.0 milestone

2026-04-11 13:05:07 +00:00

charles added the

type:user-story

area:model-browser

labels

2026-04-11 13:05:07 +00:00

charles referenced this issue

2026-04-11 13:07:50 +00:00

tui: tracking — loom-tui v0.1.0 roadmap & implementation order #47

charles referenced this issue

2026-04-11 16:29:01 +00:00