Duplicate from ruygar/LTX-2.5-Comfy-GGUF

Co-authored-by: Mehmet Uygar Rollas <ruygar@users.noreply.huggingface.co>

.gitattributes

@@ -0,0 +1,42 @@
+*.7z filter=lfs diff=lfs merge=lfs -text
+*.arrow filter=lfs diff=lfs merge=lfs -text
+*.bin filter=lfs diff=lfs merge=lfs -text
+*.bz2 filter=lfs diff=lfs merge=lfs -text
+*.ckpt filter=lfs diff=lfs merge=lfs -text
+*.ftz filter=lfs diff=lfs merge=lfs -text
+*.gz filter=lfs diff=lfs merge=lfs -text
+*.h5 filter=lfs diff=lfs merge=lfs -text
+*.joblib filter=lfs diff=lfs merge=lfs -text
+*.lfs.* filter=lfs diff=lfs merge=lfs -text
+*.mlmodel filter=lfs diff=lfs merge=lfs -text
+*.model filter=lfs diff=lfs merge=lfs -text
+*.msgpack filter=lfs diff=lfs merge=lfs -text
+*.npy filter=lfs diff=lfs merge=lfs -text
+*.npz filter=lfs diff=lfs merge=lfs -text
+*.onnx filter=lfs diff=lfs merge=lfs -text
+*.ot filter=lfs diff=lfs merge=lfs -text
+*.parquet filter=lfs diff=lfs merge=lfs -text
+*.pb filter=lfs diff=lfs merge=lfs -text
+*.pickle filter=lfs diff=lfs merge=lfs -text
+*.pkl filter=lfs diff=lfs merge=lfs -text
+*.pt filter=lfs diff=lfs merge=lfs -text
+*.pth filter=lfs diff=lfs merge=lfs -text
+*.rar filter=lfs diff=lfs merge=lfs -text
+*.safetensors filter=lfs diff=lfs merge=lfs -text
+saved_model/**/* filter=lfs diff=lfs merge=lfs -text
+*.tar.* filter=lfs diff=lfs merge=lfs -text
+*.tar filter=lfs diff=lfs merge=lfs -text
+*.tflite filter=lfs diff=lfs merge=lfs -text
+*.tgz filter=lfs diff=lfs merge=lfs -text
+*.wasm filter=lfs diff=lfs merge=lfs -text
+*.xz filter=lfs diff=lfs merge=lfs -text
+*.zip filter=lfs diff=lfs merge=lfs -text
+*.zst filter=lfs diff=lfs merge=lfs -text
+*tfevents* filter=lfs diff=lfs merge=lfs -text
+ltx-2.5-22b-distilled-transformer-bf16-Q4_K_M.gguf filter=lfs diff=lfs merge=lfs -text
+ltx-2.5-22b-distilled-transformer-bf16-Q5_K_M.gguf filter=lfs diff=lfs merge=lfs -text
+ltx-2.5-22b-distilled-transformer-bf16-Q6_K.gguf filter=lfs diff=lfs merge=lfs -text
+ltx-2.5-22b-distilled-transformer-bf16-Q8_0.gguf filter=lfs diff=lfs merge=lfs -text
+ltx-2.5-22b-distilled-transformer-bf16-Q3_K_S.gguf filter=lfs diff=lfs merge=lfs -text
+ltx-2.5-22b-distilled-transformer-bf16-Q2_K.gguf filter=lfs diff=lfs merge=lfs -text
+ltx25q4kmgguf.mp4 filter=lfs diff=lfs merge=lfs -text

README.md

@@ -0,0 +1,74 @@
+---
+
+base_model: Lightricks/LTX-2.5
+library_name: gguf
+license: other
+license_name: ltx-2.x-community-license
+license_link: https://github.com/Lightricks/LTX-2/blob/main/LICENSE.md
+pipeline_tag: text-to-video
+tags:
+
+- gguf
+- comfyui
+- video-generation
+- text-to-video
+- image-to-video
+- ltx-2.5
+- diffusers
+
+--- 
+
+<video controls src="https://huggingface.co/ruygar/LTX-2.5-Comfy-GGUF/resolve/main/ltx25q4kmgguf.mp4" width="100%"></video>
+
+# LTX-2.5 22B — Comfy - GGUF
+
+GGUF quantizations of [Lightricks' LTX-2.5](https://huggingface.co/Lightricks/LTX-2.5), converted for efficient execution in tools like ComfyUI. Example video is rendered using **Q4_K_M** quantize variant.
+
+## Model Explanation
+
+LTX-2.5 is an open-world model with open weights, built for local execution and fine-tuning. It natively generates synchronized, high-fidelity video and audio in a single pass from text, image, and video inputs. 
+**Key Features of LTX-2.5:**
+
+- **Synchronized Video and Audio:** A dual-stream DiT with a 4096-wide video path, a 2048-wide audio path, and cross-modal attention joining them. No separate audio stage required.
+
+- **Native Multishot Generation:** Generates connected scenes in a single pass: multiple shots that hold character identity, environment, lighting, voice, and visual style across cuts (whereas previous versions produced a single continuous shot).
+
+- **Diffusion Fidelity Rendering:** Dynamically allocates compute by scene complexity and budget, rendering flawless detail where it matters and remaining efficient everywhere else.
+
+- **Custom Gemma 4 12B Text Encoder:** Holds complex prompts together (multiple characters, camera moves, lighting, actions) instead of dropping details across a longer sequence.
+  The original bf16 transformer weighs in at 39 GB. These GGUF quantizations bring it down to a manageable 11-23 GB for consumer hardware.
+
+# GGUF Quantization VRAM Requirements
+
+Below is a reference guide for the approximate VRAM required to load the 22 Billion parameter LTX-2.5-Distilled model at various GGUF quantization levels. *Note: The sizes below refer specifically to the raw model weights loaded into memory. Generating video or high-resolution images will require an additional 4-8 GB of VRAM for the execution context, VAE, and text encoders depending on your ComfyUI configuration.*
+
+| Quantization Type | Bits per Weight (Avg) | Approx. Model Size (File / VRAM) | Recommended GPU VRAM (inc. Context) |
+| ----------------- | --------------------- | -------------------------------- | ----------------------------------- |
+| **Q2_K**          | 2.67 bits             | ~6.8 GB                          | 10 GB - 12 GB GPU                   |
+| **Q3_K_S**        | 2.9 bits              | ~7.8 GB                          | 12 GB - 16 GB GPU                   |
+| **Q4_K_M**        | 4.8 bits              | ~ 11.5 GB                        | 16 GB - 20 GB GPU                   |
+| **Q5_K_M**        | 5.5 bits              | ~ 14.2 GB                        | 20 GB - 24 GB GPU                   |
+| **Q6_K**          | 6.6 bits              | ~ 16.8 GB                        | 24 GB GPU                           |
+| **Q8_0**          | 8.5 bits              | ~ 23.0 GB                        | 32 GB+ GPU (e.g. Mac / Dual GPU)    |
+
+## Performance vs Quality
+
+- **Q4_K_M:** Best balance for typical consumer hardware (like a 16GB RTX 4080). Minor quality loss but runs very fast.
+
+- **Q5_K_M:** The sweet spot if you have a 24GB card (RTX 3090 / 4090). Noticeably better coherence than Q4 without hitting memory limits.
+
+- **Q6_K:** Very close to uncompressed BF16. Excellent choice if you have a powerful setup or Mac Studio.
+
+- **Q8_0:** Visually indistinguishable from the Master file, but requires significant memory.
+
+**Note:** *For image and video generation, the **Q2** and **Q3** model variants produce poor quality results and are generally unusable for final renders. They should only be used for basic testing and prototyping.*
+
+## License & Disclaimer
+
+**Disclaimer:** I am not the creator or owner of the LTX-2.5 model. This repository only provides quantized GGUF versions of the model for community use. All original licensing terms and usage restrictions carry over from the base model.
+ The original model is released by Lightricks under the **LTX-2.x Community License**.
+
+- **Under $10M annual revenue:** Commercial and production use at no cost under the LTX-2.x Community License.
+
+- **Over $10M annual revenue:** Requires a Paid Commercial Use Agreement with Lightricks.
+  Please refer to the [original Lightricks/LTX-2.5 repository](https://huggingface.co/Lightricks/LTX-2.5) for full, binding license terms and to accept the gated model agreement.

ltx-2.5-22b-distilled-transformer-bf16-Q2_K.gguf

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:b92866857b96fc82136512609804f7b2f62534afacbc95e696a74a37318e33d2
+size 7325780064

ltx-2.5-22b-distilled-transformer-bf16-Q3_K_S.gguf

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:01fd15e08e33935e7895776e22945b284cdd09660a4df69d343823695015bb9f
+size 9446940768

ltx-2.5-22b-distilled-transformer-bf16-Q4_K_M.gguf

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:0b1bca38240087117bb0d1379fdaf1bcdb53c40e63f5f9bcb1a7e793f9520cfb
+size 12220864608

ltx-2.5-22b-distilled-transformer-bf16-Q5_K_M.gguf

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:b9e4eb9e488a6e58659ee46891b4cc4078a97df2a802bedcf7dba104b3170d3e
+size 14831573088

ltx-2.5-22b-distilled-transformer-bf16-Q6_K.gguf

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:ee4dd64ece0314b4fbc789661ed0065e4e18fb99b6a72b98a7a65520731a01f8
+size 17605644384

ltx-2.5-22b-distilled-transformer-bf16-Q8_0.gguf

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:1b09ced58bf06082b73cd9a12df928ee32797f0f3202fdbb8a572bfb6b1cc14f
+size 22663796832

ltx25q4kmgguf.mp4

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:68f24c0dc6a399eae815bb612327dfb486b711e32ac117226eda59e1a9606e5a
+size 2145144