跳至内容

从源码安装

此方法适用于需要修改 Hummingbot 源代码的开发者和用户。大多数用户应优先选择 Docker 安装

安装依赖项

🛠️ macOS 安装指南

✅ 安装 Xcode 命令行工具

这些工具是编译部分 Python 依赖项所必需的。

xcode-select --install

注意

我们推荐使用完整的 Anaconda 发行版,而非较轻量的替代方案如 MinicondaAnaconda 包含更广泛的预装软件包,有助于避免 Miniconda 常见的依赖冲突和安装错误。

您可以通过图形界面或命令行安装 Anaconda。

🔹 选项 1:图形化安装程序(适合新手)

  1. 访问 anaconda.com/download
  2. 选择您的版本(Intel 或 Apple Silicon)
  3. 点击 下载适用于 Mac 的版本
  4. 按照安装向导提示操作

🔹 选项 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:

curl -O https://repo.anaconda.com/archive/Anaconda3-2024.10-1-MacOSX-arm64.sh
bash Anaconda3-2024.10-1-MacOSX-arm64.sh

🐧 Linux 安装指南

✅ 安装/更新系统软件包

sudo apt update && sudo apt upgrade -y && sudo apt install -y gcc build-essential

✅ 安装 Anaconda

curl -O https://repo.anaconda.com/archive/Anaconda3-2025.06-0-Linux-x86_64.sh
bash ~/Anaconda3-2025.06-0-Linux-x86_64.sh

🪟 Windows 安装指南

✅ 安装 WSL2 和 Ubuntu

此过程可能需要较长时间,并可能需要重启系统。

wsl --install -d Ubuntu

Ubuntu 发行版安装完成后,请打开 Ubuntu 终端,并按照 Linux 部分的说明安装依赖项。

注意

以下所有安装命令请在 Ubuntu 终端中运行,而非 Windows 命令提示符或 PowerShell。

安装步骤

克隆仓库

git clone https://github.com/hummingbot/hummingbot.git
cd hummingbot

安装环境与依赖项

./install

激活环境

conda activate hummingbot

编译代码

./compile

启动 Hummingbot

./start

您将看到 Hummingbot 欢迎界面:

welcome screen

要开始使用 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

旧版本

如需安装特定旧版本,请先列出可用标签以确定目标版本:

git tag

确定所需版本后(例如 v2.1.0),使用以下命令切换:

git checkout 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。