Skip to main content

macOS Install (Apple Silicon)

1. Download the installer​

Go to the Releases page and download the .pkg file for your version. It's signed and notarised, so macOS won't warn you about an unidentified developer.

Optional: also download the .pkg.sha256 sidecar and verify:

shasum -a 256 -c locai-link-llm-stt-macos-arm64-v1.0.19.pkg.sha256

2. Run the installer​

Double-click the .pkg. macOS opens the standard installer wizard.

  • Introduction. Click Continue.
  • Destination. The installer writes to /Library/Locai/ (system-wide) plus /Applications/ for the two apps. Click Install.
  • macOS prompts for your administrator password (this is macOS's own prompt for /Library/ write access, not part of Locai). Enter it and click Install Software.
  • Installation takes a few seconds. When it finishes, the Setup Assistant launches automatically. You don't need to open it manually.

3. Setup Assistant: first run​

The Setup Assistant opens as a centered window titled "Locai Link Setup" and walks you through four steps: Sign in, Models, Permissions, and Finish.

Step 1: Sign in​

The wizard asks you to sign in with your Locai account. Click Sign in with Locai.

Setup Assistant Step 1 — sign in to Locai
  • A browser window opens automatically to a Locai sign-in page displaying a short code (e.g. WXYZ-1234).
  • Sign in with your email + password (or Google, or Microsoft, whatever your account is configured for).
  • The page asks "Approve this device?". Confirm. If the code shown on the web page matches the one shown in the Setup Assistant window, you can approve.
  • The Setup Assistant detects the approval automatically within a few seconds and shows the signed-in account.

If the browser didn't open (some proxies block auto-launch), the wizard shows the URL and code so you can enter them manually on any device with a browser.

Setup Assistant Step 1 — account signed in

Once your account appears under Signed in, click Continue.

Step 2: Models​

You'll see a list of every model on your Locai account. Tick the ones you want to send to this device now, or leave them all unticked and deploy later; you can change the selection later from Control.

Each row shows the model name, its model type, its framework (for example GGUF for language models, TensorFlow Lite for audio and image classifiers), and its size on disk after download.

Setup Assistant Step 2 — choose models to prefetch

The models you pick here are queued for the agent to download once setup completes. Downloads run in the background, so you don't have to wait on this step.

Click Continue.

Step 3: Permissions​

The wizard asks whether Locai Link should start at login. Leaving this on (recommended) means the agent and tray app run in the background from the moment you log into your Mac. Turning it off means you'd need to launch Locai Link manually from Applications each time. You can change this at any time from Locai Link Preferences.

Setup Assistant Step 3 — start Locai Link at login

Click Continue.

Step 4: Finish​

Click Complete setup. The Setup Assistant enrols this machine on your Locai account and drops the initial config in place, using the registration key it minted on your behalf. This takes a couple of seconds.

Setup Assistant Step 4 — register this device

If something fails (network error, expired key, etc.), a specific error appears with a Retry button. Common issues:

  • Network blocked. Check that your machine can reach api.locai.co.uk on HTTPS.
  • Registration key expired. Ask your admin to mint a new one and click Retry.

When registration succeeds, the step shows All set with your new device ID, confirms where the config was written, and notes how many models were queued for this device.

Setup Assistant Step 4 — all set, device registered

Click Complete to close the wizard.

  • The Locai Link menu-bar companion appears in the top-right of your menu bar (small Locai icon).
  • If you selected models in Step 2, the companion's tray icon will show download progress within a few seconds.

That's it. The device is now enrolled and running. Continue to Using the companion.