exo-explore / exo
git clone https://github.com/exo-explore/exo.git
v1.0.71 · 6mo ago
Run frontier AI locally.
+9
stars, 24h · #1,648
+~63
stars, 7 days · #2,070
+~270
stars, 30 days · #1,983
48k
★ total · +0% this week
3.6k
forks · 388 open issues
Star history (as recorded here)
LanguagePython
LicenseApache-2.0
Created2024-06-24 (2y ago)
Last push9d ago
Watchers350
OwnerOrganization
Links
- GitHub: github.com/exo-explore/exo
- Releases · Issues · Hacker News mentions
README excerpt
exo: Run frontier AI locally. Maintained by exo labs. --- exo connects all your devices into an AI cluster. Not only does exo enable running models larger than would fit on a single device, but with day-0 support for RDMA over Thunderbolt, makes models run faster as you add more devices. ## Features - **Automatic Device Discovery**: Devices running exo automatically discover each other - no manual configuration. - **RDMA over Thunderbolt**: exo ships with day-0 support for RDMA over Thunderbolt 5, enabling 99% reduction in latency between devices. - **Topology-Aware Auto Parallel**: exo figures out the best way to split your model across all available devices based on a realtime view of your device topology. It takes into account device resources and network latency/bandwidth between each link. - **Tensor Parallelism**: exo supports sharding models, for up to 1.8x speedup on 2 devices and 3.2x speedup on 4 devices. - **MLX Support**: exo uses MLX as an inference backend and MLX distributed for distributed communication. - **Multiple API Compatibility**: Compatible with OpenAI Chat Completions API, Claude Messages API, OpenAI Responses API, and Ollama API - use your existing tools and clients. - **Custom Model Support**: Load custom models from HuggingFace hub to expand the range of available models. ## Dashboard exo includes a built-in dashboard for managing your cluster and chatting with models. 4 × 512GB M3 Ultra Mac Studio running DeepSeek v3.1 (8-bit) and Kimi-K2-Thinking (4-bit) ## Benchmarks Qwen3-235B (8-bit) on 4 × M3 Ultra Mac Studio with Tensor Parallel RDMA Source: Jeff Geerling: 15 TB VRAM on Mac Studio – RDMA over Thunderbolt 5 DeepSeek v3.1 671B (8-bit) on 4 × M3 Ultra Mac Studio with Tensor Parallel RDMA Source: Jeff Geerling: 15 TB VRAM on Mac Studio – RDMA over Thunderbolt 5 Kimi K2 Thinking (native 4-bit) on 4 × M3 Ultra Mac Studio with Tensor Parallel RDMA Source: Jeff Geerling: 15 TB VRAM on Mac Studio – RDMA over Thunderbolt 5 --- ## Quick Start Devices running exo automatically discover each other, without needing any manual configuration. Each device provides an API and a dashboard for interacting with your cluster (runs at `http://localhost:52415`). You can run exo with the macOS app, the easiest way on a Mac, or from source on macOS or Linux. ### macOS App exo ships a macOS app that runs in the background on your Mac. The macOS app requires macOS Tahoe 26.2 or later. Download the latest build here: EXO-latest.dmg. You can also install the latest build with Homebrew: [code] The app will ask for permission to modify system settings and install a new Network profile. Improvements to this are being worked on. **Custom Namespace for Cluster Isolation:** The macOS app includes a custom namespace feature that allows you to isolate your exo cluster from others on the same network. This is configured through the `EXO_ZENOH_NAMESPACE` setting: - **Use cases**: - Running multiple separate exo clusters on the same ne