下载适用于 macOS、Windows 或 Linux 的 HeartBeatAgents，并在你的设备上运行起来。
HeartBeatAgents 完全运行在你自己的设备上：安装过程不依赖任何云端账户。请从 https://zh.heartbeatagents.com/download （在新标签页中打开） 下载。完全免费，无需注册账户。
前提条件：Docker Desktop
请先安装 Docker Desktop （在新标签页中打开）（免费，跨平台）。HeartBeatAgents 使用 Docker 运行本地容器，以隔离每个智能体的执行环境。
选择安装包
macOS
需要 macOS 12 Monterey 或更高版本。同时支持 Apple Silicon（arm64）和 Intel（x64）：
.dmg原生安装包.zip压缩包
Windows
需要 Windows 10 或更高版本：
.exe安装程序
Linux
支持 Ubuntu 20.04+、Debian 11+、Fedora 36+ 或同等版本，同时支持 x64 和 arm64：
.deb软件包（Debian/Ubuntu）.AppImage（适用于任何发行版）- Docker 镜像，用于完全容器化的自托管部署
安装
下载适用于你所在平台的安装程序并运行它。安装程序会自动处理其余步骤：无需手动配置。
每个下载文件都附带 SHA-256 校验和，可在运行前验证其完整性。Docker 镜像通过 GitHub OIDC 使用 cosign 签名，因此自托管部署也能以同样的方式验证来源。
HeartBeatAgents 在使用你自己的 API 密钥时是免费的；如果通过 Ollama 在本地运行模型，则可实现端到端完全免费。
卸载
- macOS：将
HeartBeatAgents.app从“应用程序”拖到废纸篓即可。配置和数据保存在~/.heartbeatagents/中；如果要彻底删除所有内容，也请删除该目录。 - Windows：控制面板 → 程序 → 卸载程序 → HeartBeatAgents → 卸载，或在提升权限的 PowerShell 中运行
winget uninstall HeartBeatAgents。 - Linux（.deb）：运行
sudo apt remove heartbeat-agents-desktop；若还要同时删除配置，请运行sudo apt purge heartbeat-agents-desktop。 - Linux（.rpm）：运行
sudo dnf remove heartbeat-agents-desktop（在较旧的发行版上使用yum）。 - 自托管 / 无界面部署：运行
hba uninstall，或手动执行：cd ~/.heartbeatagents && docker compose down -v && cd ~ && rm -rf ~/.heartbeatagents。