Free, open-source AI video generator for Mac. Run LTX-2.5 and MiniMax H3 (Hailuo) locally on Apple Silicon: text-to-video and image-to-video with sound, lip-sync, character LoRA training, songs from lyrics (YuE2) and image editing (Qwen-Image-Edit). One-click install via Pinokio. Offline: no cloud, no API key, no NVIDIA GPU.
Python ai-filmmakingai-videoai-video-generatorapple-siliconhailuoimage-to-videolip-synclocal-ailora-trainingltx-2ltx-2-5ltx-videomacosminimax-h3mlxmusic-generationoffline-aipinokiotext-to-videovideo-generation
// Optional installer for Qwen-Image-Edit-2509 (multi-reference image gen).
//
// What this gives the user:
// - Compose a character + a place / character + product / character +
// character into a single still, in seconds, on Apple Silicon.
// - Powers the agent's `generate_shot_images(refs=[...])` flow for
// cross-shot identity locking — no LoRA training required.
// - The new "Image" tab in the panel uses this to drive manual
// still generation feeding the library.
//
// Backed by:
// - filipstrand/mflux (Apache 2.0) — `mflux-generate-qwen-edit` CLI
// - Qwen/Qwen-Image-Edit-2509 weights (Apache 2.0, Alibaba Tongyi Lab)
//
// Disk + time:
// pip step: ~30 s, ~150 MB.
// First weight download is lazy — happens on first generation, lands
// in ~/.cache/huggingface (~22-34 GB depending on quantization). The
// user picks the quant in Settings → Image generation. We deliberately
// do NOT pre-pull weights here so this install stays under a minute;
// the first agent generation takes the longer hit and the panel
// surfaces a "downloading model…" status during it.
//
// Idempotent:
// pip install -U is a no-op when mflux is already at the pinned version.
// Re-running this script is safe.
//
// Survives Pinokio Reset:
// The mflux package is in `ltx-2-mlx/env/` which Reset wipes; user
// re-runs install_qwen.js after Reset to re-install. Weights in
// ~/.cache/huggingface are OUTSIDE the install dir and survive Reset
// automatically — the second install is just the ~30 s pip step.
module.exports = {
run: [
{
method: "notify",
params: {
html: [
"<b>Installing Qwen-Image-Edit-2509 (multi-reference image gen).</b>",
"<br>Apache 2.0 license. Powers character + place keyframe composition.",
"<br>This step installs the <code>mflux</code> Python package (~150 MB).",
"<br>Model weights (~22-34 GB) download lazily on first use to <code>~/.cache/huggingface</code>."
].join("")
}
},
{
method: "shell.run",
params: {
// EXACT pin to 0.18.0 (not >=). It is the version our local
// patch_mflux_fbcache.py is line-targeted against — bumping mflux
// without re-validating the patch risks silent failure or worse,
// a partial patch that produces broken output. To upgrade:
// 1. Bump this pin (here + scripts/post_update.sh +
// scripts/pinokio/mflux_pack.sh) to the new version.
// 2. Re-run the patch script and confirm it still finds the
// QwenTransformer / Flux2Transformer layer loops.
// 3. Bench a known prompt before/after, verify quality.
// AND: mflux declares its own mlx range, so this pin and the mlx
// pin are ONE decision — scripts/check_post_update.js fails the
// moment either moves without the other.
//
// Two-step install (P2 fix 2026-05-18). The previous
// single-step `pip install --force-reinstall --no-deps` left
// mflux's transitive dependencies (transformers, accelerate,
// sentencepiece, ...) MISSING on fresh installs, so the very
// first attempt to call mflux silently ImportError'd inside a
// subprocess and the panel reported "engine not installed"
// instead of working. New shape:
// Step 1: install WITH deps so pip resolves the full
// transitive set.
// Step 2: force-reinstall the same version WITHOUT deps so
// pip never silently bumps a transitive dep when we
// re-run later.
message: "./ltx-2-mlx/env/bin/pip install -c scripts/pinokio/engine_constraints.txt 'mflux==0.18.0'"
}
},
{
method: "shell.run",
params: {
// Pin-tightening pass — see two-step rationale above.
message: "./ltx-2-mlx/env/bin/pip install -c scripts/pinokio/engine_constraints.txt --force-reinstall --no-deps 'mflux==0.18.0'"
}
},
{
method: "shell.run",
params: {
// mlx-teacache 0.4.1 (MIT, github.com/IonDen/mlx-teacache). Powers
// the optional TeaCache wrap for the FLUX.2 family — skips 3/25
// timesteps on flux2-klein-base-4b at SSIM>0.99 (~1.41x speedup)
// and gives a smaller ~1.25x on the 4-step distilled klein-4b
// (mostly mx.compile avoid). Wired by run_mflux_with_teacache.py
// which image_engine.py launches in place of mflux-generate-flux2
// when MFLUX_TC_FLUX=1 (default). The wrapper itself falls back
// to the bare CLI if this import isn't present, so the install
// step failing isn't fatal — but we pin it next to mflux so a
// user who opted into Qwen also gets the FLUX.2 speedup.
// Pinned for reproducibility. The FLUX.2 TeaCache wrap re-verifies
// its mflux compat at runtime and falls back to the bare CLI if the
// API moved (so a mflux bump never *breaks* FLUX.2 — worst case it
// loses the speedup). Bumped to the mflux 0.18 line (Ideogram 4 +
// Qwen-Edit share this package); re-confirm the FLUX.2 speedup holds.
message: "./ltx-2-mlx/env/bin/pip install -c scripts/pinokio/engine_constraints.txt 'mlx-teacache==0.4.1'"
}
},
{
method: "shell.run",
params: {
// FBCache patch — injects optional step-caching into mflux's Qwen
// transformer layer loop. Line-targeted against mflux==0.18.0 (the
// pin enforced above; anchors re-verified byte-for-byte on the bump).
// Idempotent — script checks for its marker
// before touching anything. Off unless MFLUX_FB_CACHE=1 is set in
// the subprocess env (which Phosphene does for the Fast/Medium
// Qwen tiers via agent/image_engine.py).
message: "./ltx-2-mlx/env/bin/python3.11 patch_mflux_fbcache.py"
}
},
{
method: "shell.run",
params: {
// Sanity check: confirm the per-family CLI made it onto PATH.
// Failure here means the pip step did not place the binary —
// most often a stale cache. The exit-code-only check (no print)
// matches the v2.0.5 install.js convention to avoid shell
// rewriters mangling decorative output.
message: "./ltx-2-mlx/env/bin/mflux-generate-qwen-edit --help > /dev/null"
}
},
{
method: "notify",
params: {
html: [
"<b>Qwen-Image-Edit-2509 installed.</b>",
"<br>Open the panel → Settings → Image generation → pick",
"<br><code>Qwen-Image-Edit-2509 (multi-ref)</code>.",
"<br>The new <b>Image</b> tab in the panel composes character + place stills",
"<br>that drop straight into the library for the agent to use as keyframes."
].join("")
}
}
]
}