File size: 2,882 Bytes
61b96d2 e8b6587 61b96d2 e8b6587 61b96d2 e8b6587 61b96d2 e8b6587 | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 | ---
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.
|