Skip to main content

macOS Installation & Setup

GoingMerry runs natively on macOS, leveraging Apple Silicon's Unified Memory Architecture (UMA) via Apple Metal execution kernels. This allows GoingMerry to load large model parameters directly into unified memory boundaries without copy-overhead, achieving maximum throughput.

1. Installation​

During the waitlist staging phase, download packages are available via waitlist slots. Once waitlist authorization is active:

  1. Download the GoingMerry-Darwin.zip archive.
  2. Unzip and drag the GoingMerry.app bundle into your /Applications directory.
  3. Double-click the application bundle to launch.

2. Background Daemon & CLI Mapping​

When launched for the first time, GoingMerry:

  • Starts a background helper process that listens for local API requests on 127.0.0.1:11434.
  • Places a menu bar icon in the top right.
  • Automatically links the merry command line binary to /usr/local/bin/merry or prompts to inject it into your user shell configuration (.bash_profile, .zshrc).

Verifying CLI Access​

Open a terminal shell and verify the installation:

merry --version

3. How to Quit or Restart​

  • To Quit: Click the GoingMerry icon in the menu bar and select Quit.
  • To Restart: Relaunch GoingMerry.app from /Applications or launch the daemon manually in your terminal: 
    merry serve

4. Environment Customization​

You can customize the daemon's runtime configuration using environment variables. Since GoingMerry launches via the macOS app boundary, you must configure these using launchctl if running as a system agent:

# Set custom storage directory for model weights
launchctl setenv MERRY_MODELS "/Volumes/ExternalSSD/models"

# Restart the application to load new environments
killall GoingMerry
open /Applications/GoingMerry.app