从源码安装¶
此方法适用于需要修改 Hummingbot 源代码的开发者和用户。大多数用户应优先选择 Docker 安装。
安装依赖项¶
🛠️ macOS 安装指南¶
✅ 安装 Xcode 命令行工具¶
这些工具是编译部分 Python 依赖项所必需的。
✅ 安装 Anaconda(macOS 推荐方式)¶
注意
我们推荐使用完整的 Anaconda 发行版,而非较轻量的替代方案如 Miniconda。Anaconda 包含更广泛的预装软件包,有助于避免 Miniconda 常见的依赖冲突和安装错误。
您可以通过图形界面或命令行安装 Anaconda。
🔹 选项 1:图形化安装程序(适合新手)¶
- 访问 anaconda.com/download
- 选择您的版本(Intel 或 Apple Silicon)
- 点击 下载适用于 Mac 的版本
- 按照安装向导提示操作
🔹 选项 2:命令行安装程序¶
如果您熟悉终端,可使用此方法。
适用于搭载 Intel 处理器(x86)的 macOS:
curl -O https://repo.anaconda.com/archive/Anaconda3-2024.10-1-MacOSX-x86_64.sh
bash Anaconda3-2024.10-1-MacOSX-x86_64.sh
适用于搭载 Apple Silicon(M1/M2/M3)的 macOS:
安装步骤¶
克隆仓库
安装环境与依赖项
激活环境
编译代码
启动 Hummingbot
您将看到 Hummingbot 欢迎界面:

要开始使用 Hummingbot,请参阅以下页面和指南:
开发分支 | 旧版本¶
如需安装开发分支或旧版本的 Hummingbot,请按以下步骤操作:
开发分支¶
如需使用最新开发版本,请先克隆仓库,然后切换至 development 分支:
git clone https://github.com/hummingbot/hummingbot.git
cd hummingbot
git checkout development
git pull origin development  # Ensure you have the latest updates
旧版本¶
如需安装特定旧版本,请先列出可用标签以确定目标版本:
确定所需版本后(例如 v2.1.0),使用以下命令切换:
旧版本的标签遵循此格式:vx.x.x(例如 v2.1.0)。
Gateway:DEX 交易必需¶
用于去中心化交易所的必备组件
必须单独安装 Gateway 才能在以下支持的 DEX 上交易:
 - Uniswap (以太坊)
 - PancakeSwap (BNB 链)
 - Trader Joe (Avalanche)
 - dYdX (Starkware)
 - 以及 30 多个其他平台
Gateway 是一种中间件,使 Hummingbot 能够与基于区块链的去中心化交易所交互。请按照 Gateway - 安装指南 中的说明生成证书并连接 Gateway 与 Hummingbot。
