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
| import os | |
| from aiohttp import web | |
| from ..utils import sub_abspath | |
| THIS_DIR = os.path.dirname(os.path.abspath(__file__)) | |
| DIR_WEB = os.path.abspath(f'{THIS_DIR}/../../web/') | |
| def get_param(request, param, default=None): | |
| """Gets a param from a request.""" | |
| return request.rel_url.query[param] if param in request.rel_url.query else default | |
| def is_param_falsy(request, param): | |
| """Determines if a param is explicitly 0 or false.""" | |
| val = get_param(request, param) | |
| return val is not None and (val == "0" or val.upper() == "FALSE") | |
| def is_param_truthy(request, param): | |
| """Determines if a param is explicitly 0 or false.""" | |
| val = get_param(request, param) | |
| return val is not None and not is_param_falsy(request, param) | |
| def set_default_page_resources(path, routes): | |
| """Sets up routes for handling static files under a path.""" | |
| async def get_resource(request): | |
| """Returns a resource file.""" | |
| filepath = request.match_info['file'] | |
| abspath = sub_abspath(os.path.join(DIR_WEB, path), filepath) | |
| if abspath is None: | |
| return web.HTTPNotFound() | |
| return web.FileResponse(abspath) | |
| async def get_resource_subdir(request): | |
| """Returns a resource file.""" | |
| filepath = os.path.join(request.match_info['subdir'], request.match_info['file']) | |
| abspath = sub_abspath(os.path.join(DIR_WEB, path), filepath) | |
| if abspath is None: | |
| return web.HTTPNotFound() | |
| return web.FileResponse(abspath) | |
| def set_default_page_routes(path, routes): | |
| """ Sets default path handling for a hosted rgthree page. """ | |
| async def get_path_redir(request): | |
| """ Redirects to the path adding a trailing slash. """ | |
| raise web.HTTPFound(f'{request.path}/') | |
| async def get_path_index(request): | |
| """ Handles the page's index loading. """ | |
| html = '' | |
| with open(os.path.join(DIR_WEB, path, 'index.html'), 'r', encoding='UTF-8') as file: | |
| html = file.read() | |
| return web.Response(text=html, content_type='text/html') | |
| set_default_page_resources(path, routes) | |