Hardware
tokspur is built around the Apple M5 Max with a 40-core GPU and 128 GB of unified memory. The server refuses to start on a Mac with less than 128 GB. The selected profile holds the engine to a 96 GB ceiling and leaves the rest for macOS and your tools.
System preparation
Use macOS 27 or later. Follow the install instructions for the signed release. For a source build, install Xcode with its Metal toolchain, Python 3.12 or 3.13, Git and the Rust toolchain pinned in rust/rust-toolchain.toml using rustup. Bootstrap builds the native worker with Apple's toolchain and system libraries and the Rust host with the pinned toolchain. It downloads no model.
Check available memory with your normal editor and build tools open. Other inference processes compete for the same GPU and unified memory, and tokspur refuses to start while a known inference worker is running.
Storage
The pinned model set is about 111 GB across 4 GGUF shards, plus a 2.79 GB native MTP sidecar. Adoption verifies the files where they are and keeps them in place. The derived pack adds 84.63 GB under .tokspur/derived/, and building it needs about 139 GB of free space, because it stops unless 54 GB would remain free. SSD checkpoints are off by default. If enabled, allow the selected budget under .tokspur/state/checkpoints/, written only while the volume keeps 20 GiB free, plus the native and Rust builds under the checkout. The optional speed mode drafter adds 1.21 GB.
Continue with model preparation and the memory budget.