gogby nanonix

APPLE SILICON / SOURCE BUILD

Build your
Mac companion.

This guide is for Apple Silicon Macs (M-series), building the Public edition natively. There is no verified Mac binary yet. These are build and acceptance instructions, not a claim that Gog has passed native Mac testing.

1. Prepare your Mac

Open Terminal. Check the machine and install Apple's command-line build tools:

uname -m
xcode-select --install

Expect arm64. If the tools are already installed, keep them. Otherwise finish Apple's installation dialog before continuing. See Tauri's official macOS prerequisites. Build as your normal user, not with sudo.

2. Install the build tools

  1. Install native Apple Silicon Node.js (Node 22 is used by our Unix build checks). Select the macOS ARM64 installer.
  2. Install stable Rust using the instructions at rustup.rs. Review the installer before running it.
  3. Close and reopen Terminal, then install pnpm 10 and check the tools:
npm install --global pnpm@10
node --version
pnpm --version
cargo --version
rustc -vV
xcode-select -p

The Rust host must be aarch64-apple-darwin. If a command is missing or npm reports a permissions error, fix that prerequisite first using its official installation instructions; do not run the Gog build as root.

3. Download and verify the source

Download the source ZIP from the macOS / source card. Compare its SHA-256 with the current card before extracting:

shasum -a 256 "$HOME/Downloads/Gog-Public-source-20260921.zip"

If your browser renamed the download, use its actual filename. The whole hash must match. Stop if it does not match or HTTPS shows a certificate warning. The source contains no companion profiles, credentials or model weights.

4. Open a clean source folder

Extract the verified ZIP into a new folder, not over an existing Gog project. In Terminal, type cd (including the space), drag that extracted folder from Finder into Terminal and press Return. Verify the root contains these files:

ls Cargo.toml desktop/package.json

Both must be found. If not, move into the extracted source root before continuing.

5. Check and compile Public

Run each command below separately. Stop at the first error; do not skip a failing check. Dependency installation and the first Rust build need internet access and can take time.

pnpm --dir desktop install --frozen-lockfile
pnpm --dir desktop typecheck
pnpm --dir desktop test:public-source
pnpm --dir desktop tauri:build:public

This builds the graphical Public companion plus its native brain, recovery and terminal sidecars for this Mac. Do not use the Owner build. The Public source tests explicitly exclude Owner-only fixtures that are not in this archive; platform-specific skips are reported rather than treated as runtime proof.

6. Find and launch the app

With the default Cargo output location, the app is here:

open "desktop/src-tauri/target/release/bundle/macos/Gog Companion.app"

The build also reports its exact bundle paths; use those if you deliberately configured another target directory. A DMG, if packaging succeeds, is under desktop/src-tauri/target/release/bundle/dmg/. You can copy your locally built app into Applications. It is not a notarized public release. If macOS blocks it, record the exact message and consult Apple's app-security guidance; do not disable Gatekeeper globally.

7. Test your companion

  1. Confirm the graphical wizard opens, or your existing companion is preserved.
  2. Choose the name, colours, design and personality yourself.
  3. Check memory and disk capacity before accepting a model download; source packages contain no model. Verify the configured model actually responds.
  4. Hatch once, show the desktop pet, and check the companion name in chat and the window title.
  5. Quit normally, reopen, and verify the name, design and model connection persist.

Keep any failure message together with your macOS version, chip, RAM and build-tool versions. Never include tokens, keys or private conversation data in a test report. Native Mac signing, packaging, model runtime and visual acceptance remain unverified until these checks run on a real Mac.

Removing a test installation

Quit Gog first. To remove its managed model downloads while retaining companion data, run this command before deleting the app (adjust the path if you moved it):

"desktop/src-tauri/target/release/bundle/macos/Gog Companion.app/Contents/MacOS/gog-desktop" --remove-downloaded-models

This cleanup command is implemented but still requires Mac runtime verification. Simply dragging the app to Trash does not run it. It must not remove models stored outside the companion's managed folder.

Back to downloads ↗