Skip to content

Don't mark model versions installed when only shared components are present - #1802

Open
deepratna-awale wants to merge 1 commit into
LykosAI:mainfrom
deepratna-awale:fix-version-installed-for-shared-components
Open

deepratna-awale wants to merge 1 commit into
LykosAI:mainfrom
deepratna-awale:fix-version-installed-for-shared-components

Conversation

@deepratna-awale

@deepratna-awale deepratna-awale commented Nov 18, 2026 •

Copy link
Copy Markdown
Contributor

Fixes #1785

Problem

In the CivitAI model browser a version got the installed checkmark as soon as any of its files was in the local model index. Newer multi-file releases (Anima, Qwen Image, etc.) list their text encoder and VAE alongside the diffusion model, and those files are shared by many versions and creators. Installing one shared encoder or VAE made every version that lists it look installed, even though none of their actual models were downloaded.

Changes

  • CivitFileTypeExtensions.IsSupportingComponent() marks companion file types: VAE, text/vision encoders, CLIPVision, Config, Training Data, Negative, ControlNet, Upscaler, Enhancement LoRA and Workflow.
  • CivitModelVersion.GetInstallState(hashes) returns NotInstalled, ComponentsOnly or Installed:
    • Any one installed main model file makes the version installed, so a single BF16, FP8 or INT8 variant is enough.
    • If only supporting components are installed, the version is ComponentsOnly.
    • Files with an Unknown type count as main files, so detection keeps working for file types Civitai adds later (the reason the type check was dropped earlier).
    • A version whose files are all component types (for example a standalone VAE release) is still installed when one of them is present.
  • ModelVersionViewModel uses it for IsInstalled and exposes a new IsComponentsOnlyInstalled.
  • The version tabs on the model details page show a dimmed puzzle-piece icon with a tooltip ("Only shared components (VAE, text encoder, etc.) are installed") instead of the checkmark for components-only versions.

Per-file "Installed" labels are unchanged, and so is the browser card badge, which already only looks at model weights. Since IsInstalled drives "Hide installed", components-only versions are no longer hidden by that filter.

Not covered here: flagging an installed version whose required external dependency is missing. Civitai doesn't say which components a version actually needs, so that would need a separate design.

Screenshots

The real Anima model page, rendered headless with the same data on main and on this branch. Its base-v1.0 version lists the Qwen 3 text encoder and the Qwen Image VAE next to the diffusion model. Installed: qwen_3_06b_base.safetensors, qwen_image_vae.safetensors and anima-turbo-v1.1.safetensors, downloaded from CivitAI and hashed locally (the BLAKE3 hashes match CivitAI's).

Before. base-v1.0 shows the installed checkmark, though only its shared encoder and VAE are present.

After. base-v1.0 shows the components-only icon. turbo-v1.1, whose model file is installed, still shows the checkmark.

Testing

  • New CivitModelVersionInstallStateTests: nothing installed, only the shared encoder and VAE installed (components only), one of several main model variants installed, an Unknown typed file installed, and a version made only of component files.
  • Rendered the real Anima model page headless (Avalonia headless, same model data and installed files on main and on this branch) for the screenshots above.
  • StabilityMatrix.Tests: all passed except the TestLicenseUrl / TestPreviewImageUri checks, which need outbound network access that my test environment blocks (unrelated to this change).

…present

Versions that ship text encoders or VAEs shared with other models showed as
installed as soon as one of those components was on disk. A version now
counts as installed only when one of its main model files is present, and
versions with only supporting components installed get a separate indicator.
@deepratna-awale
deepratna-awale marked this pull request as ready for review November 19, 2026 01:17

This branch has not been deployed

No deployments
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.

[Feature Request] Distinguish installed main models from shared components in CivitAI Model Browser

1 participant