Instructions to use hgjc/ltx-ugc-bundle with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- LTX.io
How to use hgjc/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 hgjc/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
| """The original Context Switch.""" | |
| from .constants import get_category, get_name | |
| from .context_utils import is_context_empty | |
| from .utils import ByPassTypeTuple, FlexibleOptionalInputType | |
| class RgthreeDynamicContextSwitch: | |
| """The initial Context Switch node.""" | |
| NAME = get_name("Dynamic Context Switch") | |
| CATEGORY = get_category() | |
| def INPUT_TYPES(cls): # pylint: disable = invalid-name, missing-function-docstring | |
| return { | |
| "required": {}, | |
| "optional": FlexibleOptionalInputType("RGTHREE_DYNAMIC_CONTEXT"), | |
| } | |
| RETURN_TYPES = ByPassTypeTuple(("RGTHREE_DYNAMIC_CONTEXT",)) | |
| RETURN_NAMES = ByPassTypeTuple(("CONTEXT",)) | |
| FUNCTION = "switch" | |
| def switch(self, **kwargs): | |
| """Chooses the first non-empty Context to output.""" | |
| output_keys = kwargs.get('output_keys', None) | |
| ctx = None | |
| for key, value in kwargs.items(): | |
| if key.startswith('ctx_') and not is_context_empty(value): | |
| ctx = value | |
| break | |
| res = [ctx] | |
| output_keys = output_keys.split(',') if output_keys is not None else [] | |
| for key in output_keys: | |
| res.append(ctx[key] if ctx is not None and key in ctx else None) | |
| return tuple(res) | |