Skip to content

fix(generation): keep FLUX Kontext references after renaming - #10238

Open
renningg wants to merge 1 commit into
invoke-ai:mainfrom
renningg:fix/flux-kontext-display-name
Open

renningg wants to merge 1 commit into
invoke-ai:mainfrom
renningg:fix/flux-kontext-display-name

Conversation

@renningg

@renningg renningg commented Nov 11, 2026 •

Copy link
Copy Markdown
Contributor

Summary

Renaming a FLUX.1 Kontext model could make its reference images incompatible and block Invoke. Generate and Canvas now retain an existing Kontext reference bound to the same installed model. Models installed from the official or Starter repositories also keep Kontext as the default when adding a reference after a rename.

Related Issues / Discussions

Addresses item 2 in #9619.

QA Instructions

  • For a FLUX.1 Kontext model, add a reference image, rename the model in Model Manager, and reopen the project. The reference should remain bound to that model in Generate and Canvas.
  • Rename a model installed from an official or Starter source before adding a reference. The new card should select the Kontext model instead of defaulting to IP-Adapter.
  • Verified both flows in Chromium with a mock catalog, including saving and reloading the existing reference. Generate and Canvas graph tests verify the reference reaches kontext_conditioning.
  • 935 focused unit tests passed. pnpm architecture:check passed. pnpm check:release passed formatting, lint and type checking, then stopped at the same two macOS shortcut assertions as clean main (tracked in test(hotkeys): honor platform-specific shortcut labels #10237). 13,238 unit tests passed. The later release stages did not run.

Review

References tied to another model key do not transfer. For a custom model from an unrecognized source, keep Kontext in the display name when adding new references. The FLUX.1 guide explains that limit.

Checklist

  • The PR has a short but descriptive title, suitable for a changelog
  • Meaningful regression coverage added / updated where needed; obsolete tests/code removed
  • Persisted-state and API changes include required migrations / compatibility validation
  • Relevant performance/efficiency opportunities considered; material claims have evidence
  • Material review findings resolved and relevant checks rerun
  • Documentation added / updated (if applicable)
  • Updated What's New copy (if doing a release after this PR)

Autofix with [code]smith
Open in [code]smith · Need help on this PR? Tag @codesmith-bot with what you need.

Recognize known model sources and preserve references bound to the same installed model in Generate and Canvas.
@github-actions github-actions Bot added frontend PRs that change frontend files docs PRs that change docs labels Nov 11, 2026

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

docs PRs that change docs frontend PRs that change frontend files

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant