Enhanced Downloader: browse CivitAI, Hugging Face and Hartsy in SwarmUI

A full featured model browser for SwarmUI's Utilities > Model Downloader tab. Search, preview and download models from CivitAI, Hugging Face and Hartsy without leaving SwarmUI or hand-typing a URL.

This enhances SwarmUI's built in downloader rather than replacing it. The manual URL workflow on the left is still core SwarmUI, just reorganized and given a folder browser and a destination preview. The model browser on the right is new.

Switch between Hartsy, CivitAI and Hugging Face with a dropdown; each keeps its own search and filter state. Filters cover model type or architecture, base model, sort, tags, and NSFW on CivitAI only. Pagination follows whatever the active provider's API uses, page based or cursor based.

Model cards carry a thumbnail, title, creator, download count and type and base-model badges, plus a version and format picker on cards with more than one downloadable file. Click a card's thumbnail, or its Download button, to load that exact file's URL straight into the manual downloader on the left.

A curated panel pulled from the SwarmUI docs' own Image, Video and Audio model support pages. Three columns, each model showing its architecture, scale and author with a variant dropdown covering FP8, BF16, GGUF, NVFP4 and LoRAs. Pick a variant and press Download to load it into the manual downloader, or Open to view the source page. Current top picks carry a Recommended badge. The panel and each column's overflow are independently collapsible and remember their state.

A collapsible tree of your existing model folders replaces core's flat Folder dropdown and sits in the same field row. Expand and collapse branches, or create a subfolder with + New Folder without leaving the page.

Alongside it, a live destination path shows exactly where the file will land, updating as you change type, folder and name. It is shown relative to your model root, as Models/Lora/MyModel rather than an absolute path, so a shared instance does not print the server's filesystem layout to every user.

Download state is persisted server side, so a SwarmUI restart mid-download leaves it paused rather than lost. Pause, resume, retry and clear all work per download from the Downloads list under the manual downloader, and each entry shows bytes transferred, percentage and speed where the server reports a total size.

A download refused with a 401 or 403 shows the provider's own stated reason and which API key to set, using core SwarmUI's shared download error handling, plus a direct link to User Settings.

Every provider works anonymously out of the box. A key raises rate limits and unlocks gated content, and is set under User > User Settings.

Hartsy is a curated model repository being built by the team behind this extension, and is the default provider when the browser loads. It is not yet publicly released, so while it is in this pre-release state the catalog holds base model repackages, SDXL, FLUX.2, Krea 2 and HunyuanImage among them, rather than community finetunes or LoRAs. Browsing and downloading work today; expect the catalog to grow once the site is live.

A pasted Hartsy model link resolves through the Hartsy API automatically, the same way a CivitAI link does. If a model has no direct download link yet, the manual downloader says so explicitly and disables the Download button rather than failing silently.

CivitAI is the largest community model repository. Filters cover type, base model, sort, time period, tag and username, and a @username in the search box is parsed straight out of it.

Browsing without a query uses page based pagination; searching by name uses CivitAI's cursor based pagination. NSFW results require the enhanced_downloader_nsfw permission and the NSFW checkbox, and with both, requests route through civitai.red instead of civitai.com. File selection prioritises .safetensors.

Hugging Face hosts a huge range of ML models. Filters cover pipeline tag, library, sort and author.

Preview images are fetched lazily with a multi-strategy lookup, common filenames first, then the repo's file listing, then parsing the README, so a thumbnail may take a moment to appear or may not exist for every repo. File listings are filtered to model-relevant extensions and show file size, and an API token unlocks gated or private repos.

The extension talks to external hosts only when you actively search, browse or download through it, never in the background and never without you having initiated the action.

Three permissions gate the extension, all defaulting to POWERUSERS: enhanced_downloader for base access, enhanced_downloader_browse for searching, and enhanced_downloader_nsfw for NSFW results. Starting, resuming, cancelling or clearing an actual download uses SwarmUI core's own Permissions.DownloadModels instead, so a user needs that regardless of whether they can browse.

Search results are cached 60 seconds per provider and query, Hugging Face preview images 5 minutes, and model folder paths 30 seconds. Per-provider concurrent request caps, 3 for CivitAI and Hartsy, 5 for Hugging Face, keep a burst of card renders from hammering an upstream API.