Download Mirai Agent

Native desktop apps for macOS, Windows, and Linux, or install the same agent from the command line. Pick your platform below.

Desktop version 0.1.0

macOS

Apple Silicon DMG. Drag into Applications, then open.

Install steps

1. Open the downloaded DMG.
2. Drag Mirai Agent into the Applications folder.
3. Eject the DMG, then open Mirai Agent from Applications.
4. If macOS blocks an unsigned build: Control click the app, choose Open, then confirm Open.

Requirements

• Apple Silicon Mac (arm64). Intel Mac builds are not published yet.
• macOS 13 or newer recommended.
• Gatekeeper may warn until Apple notarization ships. Control click Open is the supported workaround.

Windows

x64 NSIS installer. Run the setup wizard.

Install steps

1. Run the downloaded installer (.exe).
2. Follow the setup prompts, then launch Mirai Agent from the Start menu.
3. If SmartScreen appears on an unsigned build: choose More info, then Run anyway.

Requirements

• Windows 10 or newer, 64 bit (x64).
• Administrator rights may be required to finish install.
• SmartScreen warnings are expected until Windows code signing ships.

Linux

AppImage, optional .deb, or install from the command line with uv or pip.

AppImage

1. Download the AppImage.
2. Make it executable, then run it:

chmod +x Mirai-Agent-linux-x64.AppImage
./Mirai-Agent-linux-x64.AppImage

.deb package

1. Download the .deb for Debian or Ubuntu style systems.
2. Install with your package manager, for example:

sudo dpkg -i Mirai-Agent-linux-x64.deb
# or: sudo apt install ./Mirai-Agent-linux-x64.deb

Command line install

Same agent core as the desktop app. Prefer uv; pip works too. Then start the CLI or the local panel.

uv tool install "mirai-agent[all]"

pip install "mirai-agent[all]"

After install, run the agent or open the local panel:

mirai-agent

mirai-agent panel

Requirements

• x64 (amd64) Linux for AppImage and .deb builds.
• AppImage needs FUSE on some distributions.
• Command line install needs Python 3.11 or newer.

Want CLI, serve, skills, and gateway details? Read the Mirai Agent docs.