Skip to content

Update LTX model library snippets for LTX-2.5 and DFR - #2404

Merged
Wauplin merged 2 commits into
huggingface:mainfrom
alexanderar:update-ltx-snippet
Aug 25, 2026
Merged

Update LTX model library snippets for LTX-2.5 and DFR#2404
Wauplin merged 2 commits into
huggingface:mainfrom
alexanderar:update-ltx-snippet

Conversation

@alexanderar

@alexanderar alexanderar commented Aug 24, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Rename the LTX library pretty label from LTX.io to LTX
  • Add LTX-2.5-friendly Hub snippets using split-pack loading (--transformer-path, text encoder, VAEs), with distilled + DFR pipelines
  • Keep LTX-2.3 backward compatible (monolith checkpoints + Gemma 3 --gemma-root, distilled + HQ)
  • Detect 2.5 via model id / tags / base_model; cover LoRA and IC-LoRA variants for both generations

Test plan

  • pnpm --filter tasks lint:check
  • pnpm --filter tasks check
  • pnpm --filter tasks format:check
  • pnpm --filter tasks test
  • Spot-check generated snippets for Lightricks/LTX-2.5 and Lightricks/LTX-2.3 (and a 2.5/2.3 LoRA)

Note

Low Risk
Changes only affect displayed install/run snippets and library labeling on model pages, with no runtime or API impact; wrong 2.5 vs 2.3 detection could show misleading commands to users.

Overview
Updates the LTX model library UI label from LTX.io to LTX-2 and rewrites the ltx Hub code snippets so they match both LTX-2.5 and legacy LTX-2.3 layouts.

LTX-2.5 models are detected from model.id, tags, or base_model (e.g. ltx-2.5). Snippets use split checkpoint paths (--transformer-path, VAEs, upsamplers, bundled Gemma 4 text encoder), uv sync --extra natten, multi-file hf download (plus a separate detailing IC-LoRA repo for DFR), and examples for distilled, DFR, LoRA, and IC-LoRA pipelines. LTX-2.3 keeps monolith checkpoints and google/gemma-3-12b --gemma-root with the same tag-based LoRA / IC-LoRA / base flows, now built through shared _ltxRun helpers and optional image-to-video hints.

Reviewed by Cursor Bugbot for commit b4ec92e. Bugbot is set up for automated code reviews on this repo. Configure here.

@cursor cursor Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Cursor Bugbot has reviewed your changes using default effort and found 1 potential issue.

Fix All in Cursor

❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.

Want higher recall? High effort reviews run extra passes and find more bugs. A team admin can switch effort levels in the Cursor dashboard.

Reviewed by Cursor Bugbot for commit b9cdff5. Configure here.

..._ltx25SplitArgs(dfr),
`--detailing-lora ${detailingDir}/${_LTX_DETAILING_LORA_FILE}`,
"--spatial-upscalings 1",
"--temporal-upscalings 1",

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Wrong DFR CLI upscaling flags

High Severity

The LTX-2.5 DFR Hub snippet emits --spatial-upscalings and --temporal-upscalings, but the LTX-2 CLI documents --temporal-upsample-rounds for temporal control and has no matching --spatial-upscalings flag. Copied snippets will fail at argparse with unrecognized arguments on model pages.

Additional Locations (1)
Fix in Cursor Fix in Web

Reviewed by Cursor Bugbot for commit b9cdff5. Configure here.

@Wauplin Wauplin left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for the PR!

Made a quick review pass but I'll defer to @apolinario and @linoytsaban to check actual changes.

Comment thread packages/tasks/src/model-libraries-snippets.spec.ts

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'll let @apolinario @linoytsaban review that part

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks @Wauplin @alexanderar, took a look now, LGTM pending the dfr pipeline merge to ltx main

Comment thread packages/tasks/src/model-libraries.ts Outdated
Alex added 2 commits August 25, 2026 12:00
Keep LTX-2.3 monolith + Gemma 3 paths, and add LTX-2.5 split-pack
snippets with distilled and DFR pipelines.
@alexanderar

Copy link
Copy Markdown
Contributor Author

@Wauplin
Thank you for the review.
I addressed all the comments.

@Wauplin Wauplin left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Great! Thank you for the iteration! 🤗

Should be live on the Hub within a few days

@Wauplin
Wauplin merged commit 51007b9 into huggingface:main Aug 25, 2026
4 of 6 checks passed
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.

3 participants