Download Minion

Minion is the software you install on a machine dedicated to your minion.

After installing, Minion's screen (on Linux, the terminal) shows a code and a link. Open the link while signed in to Minion Workspace and approve: the machine becomes your minion.

Install it on a machine dedicated to your minion, not on a PC you use every day. The minion's AI works on its own on that machine.

Windows

Windows 10 / 11 (64-bit)

The Windows version is not code-signed yet, so warnings appear when you download and run it. See "Installing on Windows" below for how to continue.

Download (.msi)
Version
0.45.1
Size
13.7 MB
SHA-256
d96feab36c7b81b38aaf0f8a002a225f14faa0ed7f21c2234f020c22a4cf2ee2

macOS

Mac with Apple silicon (macOS 13 or later)

Download (.pkg)
Version
0.45.1
Size
10.3 MB
SHA-256
5110d81efd385eed6bcf71ac896a4654d4d007839245de1ab791e99cc7eae8ab

Linux

Linux with systemd (x86_64 / arm64). Ubuntu / Debian recommended. Run one command as root.

curl -fsSL https://minionworkspace.com/setup/minion.sh | sudo sh

Installing on Windows

  1. If your browser stops the download (for example, "not commonly downloaded"), choose "Keep" or "Save" in the downloads list.
  2. Double-click the installer (.msi) you downloaded.
  3. If you see "Windows protected your PC", click "More info", then "Run anyway". The Windows version is not code-signed yet, so this warning appears.
  4. When Windows asks for administrator permission, click "Yes". Once installed, Minion Agent starts running as a service.
  5. When Minion's screen shows a code and a link, open the link and approve.

Windows Security (Microsoft Defender) may mistake Minion for a threat and stop it. If that happens, please contact us.

Installing on a Mac

  1. Double-click the installer (.pkg) you downloaded.
  2. Follow the installer and enter an administrator password. Once installed, Minion Agent starts running as a service, and Minion appears in the Applications folder.
  3. Open Minion from the Applications folder to see Minion Agent's state and what to do next (approval and sign-in).

Installing on Linux

  1. Run the command above as a user who can become root. It installs the packages Minion needs and Minion, and Minion Agent starts as a service.
  2. When the terminal shows a code and a link, open the link and approve (minion status shows them again). Starting from "Add Minion" gives you a command with an enrollment token, which connects without approval.

Uninstalling

On Windows, in Settings → Apps → Installed apps, select Minion and click "Uninstall". The data Minion kept on the machine is removed too.

On a Mac, run this command in Terminal. The data Minion kept on the machine is removed too.

sudo /usr/local/minion/bin/minion uninstall

On Linux, run the following command. The data Minion left on the machine is removed too.

sudo minion uninstall

If an older minion is installed

On a machine that has the older minion installed with npm (the Node.js version), the installer takes it over as the same minion. Choose OK on Windows or Continue on Mac when the installer asks, and have the minion's owner approve the code the Minion window shows as a takeover. Its data moves on the machine; secrets are entered again. Linux, Docker and Cloud VPS minions switch from Switch to the new Minion on the minion's page.

What moves and the steps