Repository navigation
Local models install and run on a Mac, Windows or Linux with nothing installed first - #188
Merged
Merged
Conversation
…installed first Each local model's setup is now tools/<model>/setup.py (standard library only, on tools/local_setup.py), run by uv on any OS as raea runs it: uv on the PATH, else raea's own uv 0.12.24 fetched once into ~/.cache/raea-tools/uv (where tools/ensure.sh puts it) and checked against its SHA-256. The setup.sh beside each is a wrapper for a Mac or Linux. Until now each setup was a sh script needing uv already installed (brew install uv), so Windows had no way to install any local model. - SAO: Core ML on a Mac, ONNX Runtime elsewhere (CUDA where nvidia-smi finds a GPU; RAEA_SAO_CUDA=0|1); its WAV is written by Python's wave module, not an installed ffmpeg (same samples) - matchmove, splat: footage read through PyAV, whose wheels carry FFmpeg's libraries (no ffmpeg/ffprobe needed); splat fetches Brush v0.3.0's release build for macOS arm64, Linux x86_64 or Windows x86_64, each SHA-256 checked - goo: Taichi on Metal on a Mac, else its best GPU (CUDA, Vulkan) or the CPU; the backend is reported as run - TokenSynth: its code as GitHub's archive at a pinned commit (no git); coremltools only on a Mac - the engine runs .venv\Scripts\python.exe on Windows (venv_python), Brush's brush_app.exe - tools/release.sh ships tools/local_setup.py
shinyobjectz
force-pushed
the
local-models
branch
from
November 19, 2026 00:24
5f9e35f to
4d44519
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Every local model (SAO, TokenSynth, matchmove, splat, goo) used to install through a
shscript that needed uv already installed (brew install uv), and the engine ran.venv/bin/python, so none of them could install or run on Windows, and a Mac without Homebrew couldn't install any. SAO, matchmove and splat also called an installedffmpeg/ffprobeat run time, and TokenSynth neededgit.Install
tools/<model>/setup.py(standard library only, ontools/local_setup.py). raea runs it through uv on any OS (raea_io_assets::run_setup), and uv brings its own Python.~/.cache/raea-tools/uv(wheretools/ensure.shalready puts it), checked against its SHA-256 and moved into place whole.setup.shis now a thin wrapper for running a setup by hand on a Mac or Linux. With no uv anywhere on an Apple-silicon Mac, it callsensure.sh uv.Run
wavemodule (the same samples). Off a Mac it runs on ONNX Runtime, with CUDA wherenvidia-smifinds a GPU;RAEA_SAO_CUDA=0|1overrides that..venv\Scripts\python.exeandbrush_app.exeon Windows.tools/release.shnow shipstools/local_setup.py.Tested
/usr/bin:/bin:/usr/sbin:/sbinon the PATH (no Homebrew, no uv, no ffmpeg):raea saofetched raea's uv, installed SAO and made a 16-bit stereo WAV;raea trackinstalled matchmove and solved a clip;tools/matchmove/setup.shalone, with no uv anywhere, installed throughensure.sh uv;test_run.pystill bakes on Metal.rask checkandcargo shearall pass.🤖 Generated with Claude Code