Instructions to use qwecja/ltx-ugc-bundle with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- LTX.io
How to use qwecja/ltx-ugc-bundle with LTX.io:
# Install the LTX-2 pipelines git clone https://github.com/Lightricks/LTX-2.git cd LTX-2 uv sync --frozen
# Download the weights from this repo, plus the Gemma text encoder hf download qwecja/ltx-ugc-bundle --local-dir models/ltx-ugc-bundle hf download google/gemma-3-12b-it-qat-q4_0-unquantized --local-dir models/gemma-3-12b
# Fast pipeline (distilled model, no distilled LoRA needed) uv run python -m ltx_pipelines.distilled \ --distilled-checkpoint-path models/ltx-ugc-bundle/<distilled-checkpoint>.safetensors \ --spatial-upsampler-path models/ltx-ugc-bundle/<spatial-upsampler>.safetensors \ --gemma-root models/gemma-3-12b \ --prompt "A beautiful sunset over the ocean" \ --output-path output.mp4 # For image-to-video, add: --image path/to/image.jpg 0 0.8# HQ pipeline (two-stage, higher quality) uv run python -m ltx_pipelines.ti2vid_two_stages_hq \ --checkpoint-path models/ltx-ugc-bundle/<checkpoint>.safetensors \ --distilled-lora models/ltx-ugc-bundle/<distilled-lora>.safetensors 0.8 \ --spatial-upsampler-path models/ltx-ugc-bundle/<spatial-upsampler>.safetensors \ --gemma-root models/gemma-3-12b \ --prompt "A beautiful sunset over the ocean" \ --output-path output.mp4 # For image-to-video, add: --image path/to/image.jpg 0 0.8 - Notebooks
- Google Colab
- Kaggle
| { | |
| "last_node_id": 10, | |
| "last_link_id": 9, | |
| "nodes": [ | |
| { | |
| "id": 7, | |
| "type": "VHS_VideoCombine", | |
| "pos": [ | |
| 746, | |
| 309 | |
| ], | |
| "size": [ | |
| 320, | |
| 468.7188019966722 | |
| ], | |
| "flags": {}, | |
| "order": 2, | |
| "mode": 0, | |
| "inputs": [ | |
| { | |
| "name": "images", | |
| "type": "LATENT", | |
| "link": 9 | |
| }, | |
| { | |
| "name": "audio", | |
| "type": "AUDIO", | |
| "link": null | |
| }, | |
| { | |
| "name": "meta_batch", | |
| "type": "VHS_BatchManager", | |
| "link": null | |
| }, | |
| { | |
| "name": "vae", | |
| "type": "VAE", | |
| "link": 8 | |
| } | |
| ], | |
| "outputs": [ | |
| { | |
| "name": "Filenames", | |
| "type": "VHS_FILENAMES", | |
| "links": null, | |
| "shape": 3 | |
| } | |
| ], | |
| "properties": { | |
| "Node name for S&R": "VHS_VideoCombine" | |
| }, | |
| "widgets_values": { | |
| "frame_rate": 8, | |
| "loop_count": 0, | |
| "filename_prefix": "AnimateDiff", | |
| "format": "video/webm", | |
| "crf": 20, | |
| "save_metadata": true, | |
| "pingpong": false, | |
| "save_output": false, | |
| "videopreview": { | |
| "hidden": false, | |
| "paused": false, | |
| "params": { | |
| "filename": "AnimateDiff_00001.webm", | |
| "subfolder": "", | |
| "type": "temp", | |
| "format": "video/webm", | |
| "frame_rate": 8 | |
| } | |
| } | |
| } | |
| }, | |
| { | |
| "id": 6, | |
| "type": "VHS_LoadVideoPath", | |
| "pos": [ | |
| 171, | |
| 239 | |
| ], | |
| "size": [ | |
| 320, | |
| 420.7188019966722 | |
| ], | |
| "flags": {}, | |
| "order": 1, | |
| "mode": 0, | |
| "inputs": [ | |
| { | |
| "name": "meta_batch", | |
| "type": "VHS_BatchManager", | |
| "link": null | |
| }, | |
| { | |
| "name": "vae", | |
| "type": "VAE", | |
| "link": 7, | |
| "slot_index": 1 | |
| } | |
| ], | |
| "outputs": [ | |
| { | |
| "name": "LATENT", | |
| "type": "LATENT", | |
| "links": [ | |
| 9 | |
| ], | |
| "slot_index": 0, | |
| "shape": 3 | |
| }, | |
| { | |
| "name": "frame_count", | |
| "type": "INT", | |
| "links": null, | |
| "shape": 3 | |
| }, | |
| { | |
| "name": "audio", | |
| "type": "AUDIO", | |
| "links": [], | |
| "slot_index": 2, | |
| "shape": 3 | |
| }, | |
| { | |
| "name": "video_info", | |
| "type": "VHS_VIDEOINFO", | |
| "links": null, | |
| "shape": 3 | |
| } | |
| ], | |
| "properties": { | |
| "Node name for S&R": "VHS_LoadVideoPath" | |
| }, | |
| "widgets_values": { | |
| "video": "input/bigbuckbunny.mp4", | |
| "force_rate": 8, | |
| "force_size": "Disabled", | |
| "custom_width": 512, | |
| "custom_height": 512, | |
| "frame_load_cap": 64, | |
| "skip_first_frames": 0, | |
| "select_every_nth": 1, | |
| "videopreview": { | |
| "hidden": false, | |
| "paused": false, | |
| "params": { | |
| "frame_load_cap": 64, | |
| "skip_first_frames": 0, | |
| "force_rate": 8, | |
| "filename": "input/bigbuckbunny.mp4", | |
| "type": "path", | |
| "format": "video/mp4", | |
| "select_every_nth": 1 | |
| } | |
| } | |
| } | |
| }, | |
| { | |
| "id": 10, | |
| "type": "VAELoader", | |
| "pos": [ | |
| -42, | |
| 88 | |
| ], | |
| "size": { | |
| "0": 315, | |
| "1": 58 | |
| }, | |
| "flags": {}, | |
| "order": 0, | |
| "mode": 0, | |
| "outputs": [ | |
| { | |
| "name": "VAE", | |
| "type": "VAE", | |
| "links": [ | |
| 7, | |
| 8 | |
| ], | |
| "shape": 3, | |
| "slot_index": 0 | |
| } | |
| ], | |
| "properties": { | |
| "Node name for S&R": "VAELoader" | |
| }, | |
| "widgets_values": [ | |
| "taesd" | |
| ] | |
| } | |
| ], | |
| "links": [ | |
| [ | |
| 7, | |
| 10, | |
| 0, | |
| 6, | |
| 1, | |
| "VAE" | |
| ], | |
| [ | |
| 8, | |
| 10, | |
| 0, | |
| 7, | |
| 3, | |
| "VAE" | |
| ], | |
| [ | |
| 9, | |
| 6, | |
| 0, | |
| 7, | |
| 0, | |
| "LATENT" | |
| ] | |
| ], | |
| "groups": [], | |
| "config": {}, | |
| "extra": {}, | |
| "version": 0.4, | |
| "tests": { | |
| "7": [{"type": "video", "key": "width", "value": 1920}, | |
| {"type": "video", "key": "height", "value": 1080}, | |
| {"type": "video", "key": "nb_read_packets", "value": "64"} | |
| ], | |
| "length": 1 | |
| } | |
| } | |