---
title: LTX-2.5 Diffusers
emoji: 🎞️
colorFrom: gray
colorTo: yellow
sdk: gradio
sdk_version: 6.17.3
python_version: "3.12"
app_file: app.py
pinned: false
---
# LTX-2.5 Diffusers

A Hugging Face Space for LTX-2.5 video generation and related IC-LoRA tools.

Model weights, adapters, and example media are downloaded at startup or during CPU preflight. Large LFS/Xet or binary runtime assets are not stored in this Space repository.

## Hugging Face access required

Some model repositories are **gated**. Open the links below while signed in to the same Hugging Face account that owns the token used by this Space, then choose **Agree and Access** when prompted.

- Base model — required for the Space to start: [Lightricks/LTX-2.5-Diffusers](https://huggingface.co/Lightricks/LTX-2.5-Diffusers)
- IC-Colorizer: [Lightricks/LTX-2.3-22b-IC-LoRA-Colorization](https://huggingface.co/Lightricks/LTX-2.3-22b-IC-LoRA-Colorization)
- Pixel Spatial Upscaler: [Lightricks/LTX-2.5-22b-IC-LoRA-Pixel-Spatial-Upscaler](https://huggingface.co/Lightricks/LTX-2.5-22b-IC-LoRA-Pixel-Spatial-Upscaler)
- Inpainting / Outpainting: [Lightricks/LTX-2.3-22b-IC-LoRA-In-Outpainting](https://huggingface.co/Lightricks/LTX-2.3-22b-IC-LoRA-In-Outpainting)

You only need adapter access for the tabs you intend to use. The base-model access is required for the Space itself.

## Space token setup

1. Approve the gated repositories you need using the links above.
2. Create a Hugging Face **read** token from the same account.
3. In the Space settings, add the token as a Secret named `HF_TOKEN`.
4. Restart the Space after changing access or the token.

`HF_ACCESS_TOKEN` is also accepted, but `HF_TOKEN` is the recommended Secret name.

## If the Space does not start

Check the runtime status shown near the top of the UI and the Space logs.

- **`HF_TOKEN/HF_ACCESS_TOKEN is required`** — the Space Secret is missing.
- **`GatedRepoError`, HTTP `401`, or HTTP `403`** — the token owner probably has not approved the required gated repository, or the token does not belong to the account that approved it.
- **The main Space works but one IC tab fails during CPU preflight** — approve that tab's adapter repository using the matching link above, then retry. A GPU reservation is not requested until the adapter preflight succeeds.
- **Access was just approved** — confirm the Space uses a token from that same account, then restart the Space and try again.

Hugging Face gated access is granted to individual user accounts, and scripted downloads must authenticate with a token belonging to an account that has access.

## Notes

- Example media is downloaded at startup and cached locally for the running Space.
- IC-LoRA adapters are downloaded during CPU preflight before GPU work begins.
- User-provided Hugging Face or Civitai LoRAs remain separate from the dedicated IC-LoRA tabs.