AgentX
Install & Get Started

From zero to a running fleet, on your machine.

The AgentX daemon runs on your own machine and hosts your agents there. Install it, claim it from your console, and it joins your account's fleet — every agent, session, and artifact driven from one screen.

~ stable · 0.129.1 · min compatible 0.129.1 · published 2026-09-08

Prefer Docker? Mac, Windows, Linux →
01 / 04
Prerequisites

What you need before you start.

02 / 04
Install the daemon

Pick your platform, then install.

Pick one package — desktop and server conflict; install only one.

  • Desktop (agentx-desktop). Login-user workstation. Runs as a user unit (agentx-daemon.service) with linger so it stays up after logout.
  • Server (agentx-server). Headless / always-on host. Runs as the system unit agentx.service as root so you can run agents over multiple users.

~ agentx-desktop · debian · amd64 · desktop

1 · Download
wget https://app.agentxhq.io/releases/agentx-desktop_0.129.1_amd64.deb
2 · Verify the checksum
echo "e1e3a53569ee36a6f5396870b8e0781976fe290286493fb14ea5f453db7b4655  agentx-desktop_0.129.1_amd64.deb" | sha256sum --check

Only continue when the checker prints agentx-desktop_0.129.1_amd64.deb: OK. A failed check means the download is corrupt or isn't the file we published — don't install it.

3 · Install
sudo apt install ./agentx-desktop_0.129.1_amd64.deb

apt resolves dependencies and installs the desktop package (user unit + linger). Pure root install: set AGENTX_DESKTOP_USER=yourlogin before apt.

~ agentx-desktop · debian · arm64 · desktop

1 · Download
wget https://app.agentxhq.io/releases/agentx-desktop_0.129.1_arm64.deb
2 · Verify the checksum
echo "d74ab96e7fb7d7eb6587aa602b926d7f8e3c84ef44e0685fb04b630c82f7744c  agentx-desktop_0.129.1_arm64.deb" | sha256sum --check

Only continue when the checker prints agentx-desktop_0.129.1_arm64.deb: OK. A failed check means the download is corrupt or isn't the file we published — don't install it.

3 · Install
sudo apt install ./agentx-desktop_0.129.1_arm64.deb

apt resolves dependencies and installs the desktop package (user unit + linger). Pure root install: set AGENTX_DESKTOP_USER=yourlogin before apt.

~ agentx-server · debian · amd64 · server

1 · Download
wget https://app.agentxhq.io/releases/agentx-server_0.129.1_amd64.deb
2 · Verify the checksum
echo "03c341c8d5b4fcb33960d6bbc650f5da3c920f2de0aca05b7eabc5776a154c3b  agentx-server_0.129.1_amd64.deb" | sha256sum --check

Only continue when the checker prints agentx-server_0.129.1_amd64.deb: OK. A failed check means the download is corrupt or isn't the file we published — don't install it.

3 · Install
sudo apt install ./agentx-server_0.129.1_amd64.deb

apt resolves the package's dependencies and installs the daemon.

~ agentx-server · debian · arm64 · server

1 · Download
wget https://app.agentxhq.io/releases/agentx-server_0.129.1_arm64.deb
2 · Verify the checksum
echo "79e30dd3688fc1f3f2358e19e275c27e58a82a75ebac3f9a05be31b3a3118194  agentx-server_0.129.1_arm64.deb" | sha256sum --check

Only continue when the checker prints agentx-server_0.129.1_arm64.deb: OK. A failed check means the download is corrupt or isn't the file we published — don't install it.

3 · Install
sudo apt install ./agentx-server_0.129.1_arm64.deb

apt resolves the package's dependencies and installs the daemon.

~ agentx-desktop · arch · x86_64 · desktop

1 · Download
wget https://app.agentxhq.io/releases/agentx-desktop-0.129.1-1-x86_64.pkg.tar.zst
2 · Verify the checksum
echo "4df103d6ff0b80abf0a57bfa66994081250f08e06a05ab9bccb6d94962a1ccb5  agentx-desktop-0.129.1-1-x86_64.pkg.tar.zst" | sha256sum --check

Only continue when the checker prints agentx-desktop-0.129.1-1-x86_64.pkg.tar.zst: OK. A failed check means the download is corrupt or isn't the file we published — don't install it.

3 · Install
sudo AGENTX_DESKTOP_USER="$USER" pacman -U ./agentx-desktop-0.129.1-1-x86_64.pkg.tar.zst

Sets the desktop user explicitly (pacman as root often has an empty SUDO_USER), then installs the package and enables the user unit with linger.

~ agentx-desktop · arch · aarch64 · desktop

1 · Download
wget https://app.agentxhq.io/releases/agentx-desktop-0.129.1-1-aarch64.pkg.tar.zst
2 · Verify the checksum
echo "f5ab90a332204a5c46c4d20db4a174c1611ae9227bf05d30af8b8959bde84bae  agentx-desktop-0.129.1-1-aarch64.pkg.tar.zst" | sha256sum --check

Only continue when the checker prints agentx-desktop-0.129.1-1-aarch64.pkg.tar.zst: OK. A failed check means the download is corrupt or isn't the file we published — don't install it.

3 · Install
sudo AGENTX_DESKTOP_USER="$USER" pacman -U ./agentx-desktop-0.129.1-1-aarch64.pkg.tar.zst

Sets the desktop user explicitly (pacman as root often has an empty SUDO_USER), then installs the package and enables the user unit with linger.

~ agentx-server · arch · x86_64 · server

1 · Download
wget https://app.agentxhq.io/releases/agentx-server-0.129.1-1-x86_64.pkg.tar.zst
2 · Verify the checksum
echo "dc68b17c4165c1b7410d4e7178c990658cd572ea771d1ab76f838085639ca5b0  agentx-server-0.129.1-1-x86_64.pkg.tar.zst" | sha256sum --check

Only continue when the checker prints agentx-server-0.129.1-1-x86_64.pkg.tar.zst: OK. A failed check means the download is corrupt or isn't the file we published — don't install it.

3 · Install
sudo pacman -U ./agentx-server-0.129.1-1-x86_64.pkg.tar.zst

Installs the package and enables the matching systemd unit.

~ agentx-server · arch · aarch64 · server

1 · Download
wget https://app.agentxhq.io/releases/agentx-server-0.129.1-1-aarch64.pkg.tar.zst
2 · Verify the checksum
echo "e23689a09c1b73a64fb01c53d6688be346eece74bd84f92c66bfde6953595149  agentx-server-0.129.1-1-aarch64.pkg.tar.zst" | sha256sum --check

Only continue when the checker prints agentx-server-0.129.1-1-aarch64.pkg.tar.zst: OK. A failed check means the download is corrupt or isn't the file we published — don't install it.

3 · Install
sudo pacman -U ./agentx-server-0.129.1-1-aarch64.pkg.tar.zst

Installs the package and enables the matching systemd unit.

03 / 04
Enroll & claim

Connect the daemon to your account.

After install, start the daemon if it is not already running. Linux packages enable systemd automatically (server: system unit agentx.service; desktop: user unit agentx-daemon.service with linger). On Mac with Homebrew, run agentx-daemon background or brew services start agentx. Then claim it so it joins your tenant fleet:

04 / 04
Open your console

Drive the whole fleet from one screen.

Once your daemon is enrolled, your agents, sessions, and artifacts are live in the console — create named agents, put them in a Bubble, and set them to work.

Sign in → Get started