Install agent-hub in minutes.
The setup app handles everything: checks your machine, installs, picks a runtime, creates your first agent, connects the gateway, and opens the web app for you.
⌘
↓Download for macOS (Apple Silicon) Blocked on first launch? See how ↓ Coming soon — the first release is being prepared. Detected your operating system macOS · Apple Silicon
All installers
⌘
macOS Apple Silicon or Intel
$
Linux Ubuntu 22.04+, Debian 12+
⊞
Windows x64 · Windows 10 build 19041+ / 11
Prefer the terminal? Download
./install.sh — for macOS, Linux, and WSL2. Download tarball Guide → Releases
Latest
After downloading
Six steps, the app does them for you.
Re-run the app any time to repair or update the install. It also sits in the menu bar / system tray to toggle the service and open the web app.
- 01 Check your machine Python ≥ 3.10, git, screen, lsof.
- 02 Install the platform Installs into ~/agent-hub, creates the environment, initializes data.
- 03 Pick a runtime Claude or agy — the app detects them.
- 04 First agent Creates agent-builder to build the next agents.
- 05 Connect the gateway Verifies the bot and recognizes you as the owner.
- 06 Launch Starts the background service, the tunnel, and opens the login link.
First launch
The app isn't code-signed yet, so the OS will ask once. Here's how to allow it:
macOS macOS 15 and later
- Open the .dmg, drag agent-hub Setup into Applications.
- Open the app. The "agent-hub Setup" Not Opened dialog appears → click Done.
- Go to System Settings › Privacy & Security, scroll to Security → click Open Anyway.
- Enter your password or Touch ID → click Open.
- Open the .dmg, drag agent-hub Setup into Applications.
- Right-click agent-hub Setup → Open → click Open.
Windows
- Run the …_x64-setup.exe file.
- The Windows protected your PC dialog appears → click More info → click Run anyway.
- The app enables WSL2 and installs Ubuntu itself (Windows asks for admin rights → click Yes); if a restart is needed, it reopens at the right step.
Linux # or
sudo apt install ./agent-hub.Setup_*_amd64.deb
chmod +x agent-hub.Setup_*.AppImage && ./agent-hub.Setup_*.AppImage
Verify your download: every release ships with SHA256SUMS
SHA256SUMS. Put it in the same folder, then run shasum -a 256 -c SHA256SUMS --ignore-missing (macOS) or sha256sum -c SHA256SUMS --ignore-missing (Linux) — each file must print OK.