LTX 2.5 ComfyUI: The Three Native Workflows Explained
Aug 13, 2026

LTX 2.5 ComfyUI: The Three Native Workflows Explained

LTX 2.5 ComfyUI setup: the three official workflows (T2V, I2V, FLF2V), every model file and its folder, the gated-repo access step, and what int8 means for your VRAM.

ComfyUI support for LTX-2.5 was ready on day one: three native workflows ship in the Template Library — T2V, I2V, and FLF2V — with no custom nodes. If you ran LTX 2.3 in ComfyUI, the good news is the muscle memory transfers. The bad news is every file changed, and one new step will block you if you miss it: the 2.5 weights live in a gated Hugging Face repository, and downloads fail until your access request is approved.

This guide walks the official setup end to end: access, files, folders, the three workflows, and the prompting tips that come with them. Sourced from the ComfyUI LTX-2.5 tutorial, the LTX-2.5 model card, and the LTX-2 README. Checked August 13, 2026.

Step 0: Unlock the gated repo first

The official ComfyUI docs are explicit: "The LTX-2.5 model files are hosted in the gated Lightricks/LTX-2.5 repository… Model downloads will fail without access."

  1. Open the repository page
  2. Accept the license agreement (LTX-2.x Community License)
  3. Wait for your access request to be approved

Access requests are reviewed by Lightricks — the turnaround time is not documented, so request access before you do anything else. This is the step that produces the classic "node is red / model not found" on a fresh setup when the real problem is a 401 at download time. The GitHub README has the same warning for the CLI path: accept the terms and log in with a Read token (fine-grained tokens need the "read gated repos" scope enabled).

Step 1: Update ComfyUI and load a template

  1. Update ComfyUI to the latest version (Nightly has the newest core nodes)
  2. Open the Template LibraryVideo → choose any LTX-2.5 workflow
  3. Missing nodes usually mean an outdated ComfyUI — update, then reload

The three official workflows:

WorkflowWhat it doesExtra files vs. T2V
T2VText-to-video with optional spatial upscaling
I2VAnimates an input first-frame imageYour image (default neon_cyborg_portrait.png provided)
FLF2VInterpolates between a first and last frameFirst + last frame images (defaults provided)

Step 2: Download every file to its exact folder

The T2V and I2V workflows use the same six files. FLF2V uses the same set minus the spatial upscaler.

Model fileComfyUI folder
ltx-2.5-22b-distilled-transformer-comfy-int8-convrot.safetensorsmodels/diffusion_models/
gemma4-12b-with-proj-ltx-2.5-comfy-int8-convrot.safetensorsmodels/text_encoders/
gemma4_e2b_it_bf16.safetensors (from Comfy-Org/gemma-4)models/text_encoders/
ltx-2.5-video-vae-bf16.safetensorsmodels/vae/
ltx-2.5-audio-vae-bf16.safetensorsmodels/vae/
ltx-2.5-latent-spatial-upscaler-x2-bf16-1.0.safetensorsmodels/latent_upscale_models/

Complete storage layout from the official tutorial:

ComfyUI/
└── models/
    ├── diffusion_models/
    │   └── ltx-2.5-22b-distilled-transformer-comfy-int8-convrot.safetensors
    ├── text_encoders/
    │   ├── gemma4-12b-with-proj-ltx-2.5-comfy-int8-convrot.safetensors
    │   └── gemma4_e2b_it_bf16.safetensors
    ├── vae/
    │   ├── ltx-2.5-video-vae-bf16.safetensors
    │   └── ltx-2.5-audio-vae-bf16.safetensors
    └── latent_upscale_models/
        └── ltx-2.5-latent-spatial-upscaler-x2-bf16-1.0.safetensors

Three things that trip people up:

  • Two text encoders, not one. The LTX-specific gemma4-12b-with-proj-ltx-2.5 encoder is required, but the official workflow also loads a second encoder, gemma4_e2b_it_bf16, from the Comfy-Org repo. Download both.
  • These are the Comfy int8 builds. The comfy-int8-convrot variants are ComfyUI-only — the model card explicitly says they are not for the ltx-pipelines / PyTorch path. If you also use ltx-pipelines, download the bf16 files for that path instead. For ComfyUI, int8 is the intended default: smaller footprint, and the reason 8 GB-class VRAM runs are being reported in the community within hours of release (preliminary reports — verify on your own card).
  • Audio VAE is not optional in these workflows. The LTX-2 family generates synchronized audio, and the audio VAE (ltx-2.5-audio-vae-bf16.safetensors) is in the official file list. Skip it and audio nodes go red.

Step 3: Run each workflow with its prompting rules

The official tutorial gives each workflow its own prompting rules — they differ, and using the wrong one is the most common cause of bad output:

T2V — describe the whole scene. Include shot type, scene, action, characters, and camera movement in one flowing paragraph. Describe sounds and dialogue — the model generates synchronized audio with the video. Short prompt? The workflow's prompt enhancer expands it into cinematic instructions automatically.

I2V — describe what happens next, not what is visible. Write the motion, camera movement, and sounds that follow from the input image; do not re-describe what is already in the frame. Anchor the first frame explicitly when continuing a series: phrasing like "Use the provided start image as the first frame."

FLF2V — describe the transition. Write what happens between the two frames, including camera movement and audio. Keep the frames in the same aspect ratio for a smooth interpolation.

What you can do with these workflows

  • Multishot: the model generates connected shots holding identity, environment, lighting, voice, and style across cuts — a model capability, not a separate workflow. Prompt as a shot list with marked cuts. See our multishot guide.
  • Native 4K HDR: the official tutorial notes native 4K HDR output at up to 50 FPS, with a RAW workflow for professional finishing pipelines.
  • Audio: every workflow generates synchronized audio-video; describe dialogue and sound in the prompt.

FAQ

Why do my model downloads fail? The repository is gated. Accept the license on the LTX-2.5 HF page and wait for approval. In ltx-pipelines, also make sure your HF token has the "read gated repos" scope.

Which LTX-2.5 files do I need in ComfyUI? The official T2V/I2V set: int8-convrot distilled transformer, both text encoders, video VAE, audio VAE, and the latent spatial upscaler. FLF2V skips the upscaler.

Why does the workflow use int8 and not the bf16 transformer? The comfy-int8-convrot build is the official ComfyUI path — smaller and designed for consumer VRAM. The bf16 checkpoints are for the ltx-pipelines Python path.

Do I need the Gemma 4 stock encoder too? Yes — the official workflows load two encoders: the LTX-specific gemma4-12b-with-proj-ltx-2.5-comfy-int8-convrot and the gemma4_e2b_it_bf16 from Comfy-Org. Both must be in models/text_encoders/.

Does LTX-2.5 work in ComfyUI Cloud? The official tutorial links Cloud runs for all three workflows ("Run on Comfy Cloud"), with the note that Cloud updates after the ComfyUI stable release.

Bottom line

LTX-2.5 in ComfyUI is three native workflows, six files, and one gate: request access to the gated HF repo first, then update ComfyUI, load a template, and place each file in its exact folder — two text encoders included. Then prompt per workflow: whole scene for T2V, what happens next for I2V, the transition for FLF2V. Not ready to manage the local stack yet? Try LTX 2.5 in the browser at ltx23.app — no gated repo, no folder layout.

Sources

Verified August 13, 2026 against primary documentation:

  1. ComfyUI official LTX-2.5 tutorial — three workflows, file list and storage layout, gated-repo warning, prompting tips per workflow
  2. Lightricks/LTX-2.5 — Hugging Face model card — split file pack, ComfyUI-only int8 builds, constraints, license
  3. Lightricks/LTX-2 — GitHub README — gated repo token requirements, int8/FP8 paths, prompting structure
  4. Comfy-Org/gemma-4 — Hugging Facegemma4_e2b_it_bf16 text encoder required by the official workflows
  5. Lightricks/LTX-2.5-22b-IC-LoRA-Pixel-Spatial-Upscaler — Hugging Face — optional detailing IC-LoRA for DFR refinement

Community 8 GB VRAM reports are preliminary third-party claims as of one day after release; verify on your own hardware.

Start Generating with LTX 2.3 — Free AI Video Online

Create your first AI video free — enter a text prompt and let the LTX 2.3 model handle the rest.

LTX 2.5 ComfyUI: The Three Native Workflows Explained | Blog