Installing on Mac

Install Discovery Engine from the disk image, get past the first-launch macOS warning, and know where everything ends up.

#Before you start

• A Mac with Apple Silicon running macOS 14 or later.
• The installer: a disk image named like Discovery Engine_0.1.0_aarch64.dmg (the version number may differ).
• An internet connection for the first start, when the app downloads its reading models.

#Install

1. Double-click the .dmg file. A window opens with the Discovery Engine app in it.
2. Drag Discovery Engine into your Applications folder.
3. Eject the disk image (drag it to the Trash, or right-click it in Finder and choose Eject).
4. Open Discovery Engine from Applications or Launchpad.

#"macOS cannot verify the app" (first launch only)

This version of the app is not yet signed with an Apple Developer ID, so the first time you open it, macOS stops it with a message that it cannot verify the developer. This is expected. To allow it, once:

1. Click Done (or OK) on the warning.
2. Open System Settings → Privacy & Security.
3. Scroll down to the security section. You'll see a line saying Discovery Engine was blocked.
4. Click Open Anyway, and confirm with your password or Touch ID if asked.
5. Open the app again. From now on it opens normally.

#The first start

The app opens on a short setup: it checks disk encryption, downloads the reading models (about 1 GB, once), and helps you create your first case. See First launch and setup.

#Updating to a newer version

1. Quit Discovery Engine.
2. Open the new .dmg and drag the app into Applications. Choose Replace when Finder asks.
3. Open the app. Your cases, models and settings are kept: they live in the app's data folder, not inside the app.

If you use the command-line tool with an AI agent, open the Start Up screen after updating. If it says the command-line tool needs updating, click Update command-line tool.

#Where things are on a Mac

~ means your home folder. The Library folder is hidden by default; in Finder, choose Go → Go to Folder… and paste the path.

#Uninstalling

1. Quit Discovery Engine.
2. Drag Discovery Engine from Applications to the Trash.
3. If you want everything gone, also delete:
   • the data folder, ~/Library/Application Support/Discovery Engine (this deletes every case's database, highlights and agent log; your original files are elsewhere and are not touched);
   • the command-line tool, ~/.local/bin/discovery;
   • if you clicked Add to PATH, the line export PATH="$HOME/.local/bin:$PATH" the app added to ~/.zprofile.

Your original case files are never inside the app or its data folder, so uninstalling never removes them.