← millrace

Get started

millrace runs entirely on your Mac (Apple Silicon). Pick whichever fits you — a menu-bar app or the millrace CLI. They share one install tree and one server, so you can start the server from one and see it from the other. Your data never leaves the machine.

macOS app

Menu-bar app

Point-and-click. Download Millrace.pkg from the latest release and open it — the installer puts Millrace in /Applications (signed & notarized, so it installs without a Gatekeeper warning). It lives in the menu bar.

Then, from the menu:

  1. Install server… — downloads the Mojo toolchain + engine, builds it, and fetches the model weights.
  2. Start server — serves on http://127.0.0.1:8000.
  3. Start opencode… — opens opencode in a Terminal, pointed at the server.
command line

CLI (Homebrew)

Install the millrace CLI from the tap:

brew install millrace/tap/millrace

Then bootstrap and run opencode:

# the inference server
millrace install     # toolchain + engine + weights (one time)
millrace start       # http://127.0.0.1:8000
millrace status      # install / running state
millrace stop        # shut the server down
millrace opencode    # open opencode, pointed at the server

Requirements