Install

Homebrew

On macOS or Linux:

brew install erhangundogan/tap/videre

Prebuilt binary

Download from the latest release and put it on your PATH. No Rust toolchain needed, nothing to compile.

Platform	File
Apple Silicon Mac	`videre-<version>-aarch64-apple-darwin.tar.gz`
Linux x86_64	`videre-<version>-x86_64-unknown-linux-gnu.tar.gz`
Linux ARM64	`videre-<version>-aarch64-unknown-linux-gnu.tar.gz`

tar xzf videre-*-aarch64-apple-darwin.tar.gz
./videre --version

Each archive has a .sha256 alongside it.

A binary downloaded with a browser is quarantined by macOS. Either download it with curl, or clear the flag:

xattr -d com.apple.quarantine videre

Homebrew installs are not quarantined, so brew install avoids this entirely.

An old cargo install will shadow a newer Homebrew install

If you previously ran cargo install videre, that copy lives in ~/.cargo/bin, which usually comes first on PATH. It will keep winning even after you install a newer version with Homebrew, and videre --version will quietly report the old one.

which videre          # check which copy you are actually running
cargo uninstall videre

From source

Needs a Rust toolchain.

cargo install videre

git clone git@github.com:erhangundogan/videre.git
cd videre
cargo build --release

On ARM64 Linux, building from source needs one extra flag. The released binary does not, since it is already built with it:

RUSTFLAGS="-C target-feature=+fp16" cargo install videre

Platform notes

Intel Macs are not supported. The ONNX Runtime dependency ships no prebuilt binaries for x86_64-apple-darwin, so videre cannot be built there at all, including via cargo install.

macOS is the primary platform. videre also runs on Linux, with one gap: HEIC photos and video frames are decoded using a macOS system tool, so on Linux those files are skipped (with a clear message) for thumbnails, search, and face detection. They are still scanned, hashed, and de-duplicated. JPEG, PNG and friends work everywhere.

See platform support for the per-command matrix.

Models are not downloaded at install

Nothing is downloaded until you run a command that needs it. Scanning, de-duplicating, fixing dates, pruning and stats work with no model at all.

Two commands need machine-learning models, and each fetches its own from Hugging Face the first time you run it:

Command	Model	What it is	Size
`videre embed`	`google/siglip-base-patch16-224`	SigLIP, Google’s image/text model. Turns a photo and a phrase into comparable vectors, which is what makes “sunset over water” match a picture.	~780 MB
`videre faces`	`WePrompt/buffalo_l`	InsightFace buffalo_l, two ONNX models: `det_10g.onnx` (SCRFD) finds faces, `w600k_r50.onnx` (ArcFace) turns each face into a vector so matching ones can be grouped.	~180 MB

Both downloads are resumable, so you can stop and rerun.

They are only fetched once and then reused, including by later runs against a different library. The download happens at the start of the run, before any of your photos are processed.

Where they are stored

In the standard Hugging Face cache, shared with any other tool that uses it:

~/.cache/huggingface/hub/

Set HF_HOME to put it elsewhere. This is separate from videre’s own directory, so removing ~/.videre does not delete the models, and deleting the cache means the next embed or faces run downloads them again.

Bigger models are opt-in

The table above is the default. If you select a different search model, it is fetched instead, and the larger ones are considerably bigger: siglip2-base-patch16-384 is about 1.4 GB and siglip-so400m-patch14-384 about 3.3 GB. Nothing downloads them unless you ask for them by name.