CLI Desktop GitHub Get Started
Desktop App

AgentX Desktop

Full graphical dashboard to install, configure, and manage your AgentX agents. One download, no terminal required.

🚀 One-click install
⚙️ Visual config
💬 Built-in chat
📊 Live dashboard

What's Included

Everything you need to run your AI agents

📥

Binary Installer

Downloads and installs the AgentX CLI binary automatically. No terminal needed.

⚙️

Config Editor

Visual editor for models, channels, agent defaults, and all settings.

🤖

Agent Setup

Edit IDENTITY, SOUL, AGENTS, and other bootstrap files through the UI.

📊

Live Dashboard

Monitor gateway health, view logs, and start/stop/restart services.

💬

Built-in Chat

Chat directly with your agent from the desktop app.

🌐

Channel Manager

Enable and configure Telegram, Discord, Slack, and more with toggle switches.

Installation Steps

Get up and running in minutes

Ubuntu / Linux
macOS
Windows
  1. Download the .deb package from above
  2. Install: sudo dpkg -i AgentX-Desktop-amd64.deb — or double-click the .deb file
  3. If prompted for dependencies: sudo apt install -f
  4. Launch AgentX Desktop from your application menu, or run: agentx-desktop
  1. Download the .dmg for your chip (Apple Silicon or Intel)
  2. Open the .dmg and drag AgentX Desktop into your Applications folder
  3. If macOS blocks it: System Settings → Privacy & Security → click Open Anyway
  4. Launch from Applications — the GUI walks you through setup
  1. Download AgentX-Desktop-Setup.exe from above
  2. Run the installer — follow the setup wizard
  3. If Windows SmartScreen warns you, click More info → Run anyway
  4. Launch AgentX Desktop from the Start menu or desktop shortcut

Prerequisites

System requirements by platform

🐧 Ubuntu / Linux

WebKit2GTK is required for the GUI. On Ubuntu/Debian:
sudo apt install libwebkit2gtk-4.1-0

On Fedora/RHEL:
sudo dnf install webkit2gtk4.1

🍎 macOS

No extra dependencies. WebView is built into macOS. Works on macOS 11 (Big Sur) and later.

🪟 Windows

Requires WebView2 runtime (included in Windows 10 21H2+ and Windows 11). Older systems: download WebView2.

Prefer the command line? The CLI binary is faster and lighter.

Download CLI instead →