Agents Machine

Installation

Download and install Agents Machine on macOS, Linux, or Windows.

Prerequisites

Make sure these are ready before installing:

Download

Log in to your dashboard and download the installer for your platform:

PlatformFileArchitecture
macOS (Apple Silicon).dmgARM64 (M1/M2/M3/M4)
macOS (Intel).dmgx86_64
Linux.debx86_64
Windows.exex86_64

Platform Instructions

Open the DMG

Double-click the downloaded .dmg file.

Drag to Applications

Drag Agents Machine into your Applications folder.

Bypass Gatekeeper

On first launch, macOS shows a "can't be verified" warning (ad-hoc code signing).

Right-click the app → Open → click Open in the dialog. You only need to do this once.

If you see an "App is damaged" error instead, run this in Terminal and try again:

xattr -cr /Applications/agents-machine.app

Install the .deb package:

sudo dpkg -i agents-machine_*.deb

If dependencies are missing:

sudo apt-get install -f
sudo dpkg -i agents-machine_*.deb

Run the Installer

Double-click the downloaded .exe file.

Follow the Prompts

Complete the installation wizard.

Launch

Open Agents Machine from the Start menu.

First Launch

Docker Infrastructure The app verifies Docker is running, then

auto-starts PostgreSQL and Qdrant containers via Docker Compose.

MCP Server The bundled MCP server starts as a sidecar process on port

3000. You can monitor progress on the loading screen.

After the first launch, subsequent startups are much faster — Docker containers resume from their existing state.

Updating

The app checks for updates automatically via Tauri's built-in updater. When a new version is available, a notification appears in the app.

On this page