Manage video model components for production
mlx-movie-director-sub-command-video-assistantworkflowsetup L2★0
ziyu4huang/video_generation ↗What it does
Download and validate LTX-2.3 video model components sequentially
Best for
Idempotent setup of large LTX video generation model components that respects HF rate limits and resumes from failures.
Inputs
- · LTX_COMPONENTS spec (5 components: transformer, lora, text_encoder, vae, audio)
- · HuggingFace token (from ~/.huggingface/token or env)
- · project root directory
Outputs
- · downloaded model files in component subdirs
- · manifest.json with updated size_bytes per component
- · assembly symlink verification passed
- · ltx_pipelines_mlx import test passed
Requires
- · HuggingFace hub (huggingface-hub CLI / Python)
- · Python 3 + mlx_arsenal + mlx_lm + huggingface_hub
- · bash shell for symlink setup
Preconditions
- · HuggingFace token available (user has access to dgrauet/ltx-2.3-mlx-q8 repo)
- · Sufficient disk space (~34GB for full set, ~33.5GB without audio)
- · Python env with deps installed (mlx_arsenal, mlx_lm, huggingface_hub)
- · Project structure initialized (component subdirs exist or created)
Failure modes
- · HF rate limit hit during sequential downloads → retry with delay (idempotent by design)
- · Network timeout mid-file → resume from last byte (HF supports range requests)
- · Disk full → operation halts, already-downloaded files retained
- · Manifest sync fails → assembly check fails, recommends re-run
- · ltx_pipelines_mlx import fails → detailed error message, debug steps listed
Trust signals
- · Sequential downloads (not parallel) — respects HF rate limits by design
- · Idempotent: re-run after partial failure resumes from where it stopped
- · Assembly symlink verified before import test (catches setup errors early)
- · Manifest size_bytes tracked for quota awareness
- · 5 phases with clear separation (resolve, download, conversion, validate, report)