Three install paths, pick the one that fits. The interactive installer is the fastest for a fresh box; npm-global suits hands-on operators; source build is for contributors.
1 1 · Interactive installer (recommended)
A bash script with three prompts — language, ACP port, and web port. It installs `agim-cli` from npm (the command is `agim`), writes a minimal `~/.agim/config.json` (or keeps `~/.im-hub/` on upgrades), drops a systemd unit if run as root, then launches `agim config` so you can pick messengers, agents, SMTP, Baidu Maps AK, etc. Re-runnable; safe to abort at any prompt.
systemd unit installed automatically when run as root. Otherwise foreground via `agim start`.
Same script — `uname -s` auto-detects Darwin. If Node.js is missing: `brew install node` (Node 22+).
Native Windows isn't supported. WSL2 + Ubuntu is the supported path. First line installs WSL (one-time, reboot may be required); second runs the installer inside Ubuntu.
Requires curl, bash, npm, and Node.js ≥ 22. Run as the user that will own ~/.agim (or whichever existing ~/.im-hub the installer detects from a 0.x deployment).
2 2 · npm global
Install agim globally; bring your own config file. See the README for the schema.
3 3 · From source
Clone, install deps, build, and run. Useful when you want to patch the agent surface or add a new messenger.
Next steps
After install, send /help in your messenger to confirm the bot is online. /agents lists registered agents; /status shows connectivity. The full command reference is in the README.
Uninstall
Stops + removes the systemd service, drops the global CLI, and wipes `~/.agim`. Also clears legacy `~/.im-hub` / `im-hub.service` paths from pre-v1.0 installs. Prefix `npm uninstall` with `sudo` if you installed the CLI system-wide (i.e. not via nvm). The `systemctl` lines silently no-op on macOS / WSL1.