exo-explore/exo

Maintainer? Show your league in your README

Card: your league's emblem, from Copper to Legendary

[![bestofgithub](https://bestofgithub.dev/badge/exo-explore/exo.svg?style=card)](https://bestofgithub.dev/repo/exo-explore/exo)

Flat: fits beside your other badges

[![bestofgithub](https://bestofgithub.dev/badge/exo-explore/exo.svg)](https://bestofgithub.dev/repo/exo-explore/exo)

Loading README…

Way	Network settings (if you agreed to the Thunderbolt setup)	`~/.exo`	Downloaded models (`~/.exo/models`)
Uninstall EXO in Settings	Service removed, back to the Automatic location, Thunderbolt Bridge back on	Deleted	Kept, unless you untick Keep downloaded models
`uninstall-exo.sh`	Service removed, back to the Automatic location, Thunderbolt Bridge back on	Deleted	Kept, unless you pass `--delete-models`
`brew uninstall --cask exo`	Service removed, but your Mac stays on the `exo` location with Thunderbolt Bridge off	Kept	Kept
`brew uninstall --zap --cask exo`	Same as `brew uninstall`. Also deletes the app's preferences and caches in `~/Library`	Kept (deleted only if empty)	Kept
Moving EXO.app to the Trash	The service removes itself within about 30 minutes, but your Mac stays on the `exo` location with Thunderbolt Bridge off	Kept	Kept

Variable	Description	Default
`EXO_DEFAULT_MODELS_DIR`	Default directory for model downloads and caches. Always first in the writable dirs list.	`~/.local/share/exo/models` (Linux) or `~/.exo/models` (macOS)
`EXO_MODELS_DIRS`	Colon-separated additional writable directories for model downloads. Checked in order after the default; first with enough free space is used.	None
`EXO_MODELS_READ_ONLY_DIRS`	Colon-separated read-only directories to search for pre-downloaded models (e.g., NFS mounts, shared storage). Models here cannot be deleted.	None
`EXO_OFFLINE`	Run without internet connection (uses only local models)	`false`
`EXO_ENABLE_IMAGE_MODELS`	Enable image model support	`false`
`EXO_ZENOH_NAMESPACE`	Custom namespace for cluster isolation (same as `--namespace`)	exo version
`EXO_FAST_SYNCH`	Control MLX_METAL_FAST_SYNCH behavior (for JACCL backend)	Auto
`EXO_TRACING_ENABLED`	Enable distributed tracing for performance analysis	`false`

Features