hummingbot-deploy

hummingbot-deploy

部署 Hummingbot 交易基础设施。开始前，向用户说明将安装哪些内容：

将安装的内容

1. Hummingbot API（必需）：您的个人交易服务，可提供标准化的 REST API，用于在许多 CEX 和 DEX 上进行交易、获取市场数据和部署机器人策略。

2. Hummingbot MCP（可选）：帮助 AI Agent（Claude、Gemini、Codex 等）与 Hummingbot API 交互的 MCP 服务。仅在使用 AI Agent CLI 时需要。

3. Condor（可选）：面向 Hummingbot API 的终端和 Telegram 界面。

组件

组件	仓库
Hummingbot API	hummingbot/hummingbot-api
MCP 服务	hummingbot/mcp
Condor	hummingbot/condor

安装前检查

只需安装 Hummingbot API。 MCP 和 Condor 是可选的附加组件。

首先，运行环境检查以验证前置条件：

bash <(curl -s https://raw.githubusercontent.com/hummingbot/skills/main/skills/hummingbot-deploy/scripts/check_env.sh)

此检查会验证：容器检测、TTY、Docker、Docker Compose、Git、Make。

安装 Hummingbot API

如果 ./hummingbot-api 已存在，请检查 Docker 日志，确认其正在运行：

cd ./hummingbot-api && make deploy && sleep 2 && docker logs hummingbot-api 2>&1 | grep -i "uvicorn running"

如果日志显示 "Uvicorn running"，请跳过并转到“安装 MCP 服务”。否则，请重置并重新安装。

全新安装：

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

在普通机器上（交互式 TTY - check_env.sh 显示 "Interactive TTY: Yes"）：

make setup    # Prompts for: API username, password, config password (defaults: admin/admin/admin)
make deploy

在容器中（无 TTY - 使用 [ -t 0 ] && echo "TTY" || echo "No TTY" 检查）：

# Set USER env var and create sudo shim if needed
export USER=${USER:-root}
[ "$(id -u)" = "0" ] && ! command -v sudo &>/dev/null && echo -e '#!/bin/bash\nwhile [[ "$1" == *=* ]]; do export "$1"; shift; done\nexec "$@"' > /usr/local/bin/sudo && chmod +x /usr/local/bin/sudo

# Create .env manually (skip interactive setup)
# Note: In containers, services communicate via Docker network (use container names, not localhost)
cat > .env << EOF
API_USER=admin
API_PASS=admin
CONFIG_API_PASS=admin
DEBUG_MODE=false
BROKER_HOST=hummingbot-broker
BROKER_PORT=1883
BROKER_API_USER=admin
BROKER_PASSWORD=password
DATABASE_URL=postgresql+asyncpg://hbot:hummingbot-api@hummingbot-postgres:5432/hummingbot_api
BOTS_PATH=/hummingbot-api/bots
EOF

# Patch docker-compose.yml (bind mounts don't work in Docker-in-Docker)
sed -i 's|./bots:/hummingbot-api/bots|hummingbot-bots:/hummingbot-api/bots|g' docker-compose.yml
sed -i '/init-db.sql.*docker-entrypoint/d' docker-compose.yml
# Add volume definition (check last 5 lines to avoid false positive from service definition)
tail -5 docker-compose.yml | grep -q "hummingbot-bots:" || echo "  hummingbot-bots: { }" >> docker-compose.yml

touch .setup-complete
make deploy

**验证：**等待 2 秒，然后检查日志是否显示 "Uvicorn running on http://0.0.0.0:8000"：

sleep 2 && docker logs hummingbot-api 2>&1 | grep -i "uvicorn running"

安装 MCP 服务

使用 CLI 自带的命令安装 MCP 服务。使用 API 设置时的相同凭据。

**重要：**不要询问用户要使用哪个 CLI。你已经知道自己是什么 CLI：

• 如果你是 Claude Code，请使用 claude
• 如果你是 Gemini CLI，请使用 gemini
• 如果你是 Codex CLI，请使用 codex

bash <(curl -s https://raw.githubusercontent.com/hummingbot/skills/main/skills/hummingbot-deploy/scripts/install_mcp.sh) \
  --agent <YOUR_CLI> --user <API_USER> --pass <API_PASS>

Claude 示例（替换为实际的 CLI 名称和凭据）：

bash <(curl -s https://raw.githubusercontent.com/hummingbot/skills/main/skills/hummingbot-deploy/scripts/install_mcp.sh) \
  --agent claude --user admin --pass admin

安装完成

所有组件安装完成后，告知用户：

1. 重启 AI Agent（Claude Code、Gemini CLI、Codex CLI 等）以加载 MCP 服务
2. 安装 Hummingbot Skills 以启用交易功能：

   npx skills add hummingbot/skills
   

安装 Condor（可选）

git clone https://github.com/hummingbot/condor.git ./condor
cd ./condor
bash setup-environment.sh  # Prompts for Telegram bot token
make deploy

升级

cd ./hummingbot-api && git pull && make deploy

验证安装

bash <(curl -s https://raw.githubusercontent.com/hummingbot/skills/main/skills/hummingbot-deploy/scripts/verify.sh)

故障排除

# View logs
cd ./hummingbot-api && docker compose logs -f

# Reset
cd ./hummingbot-api && docker compose down -v && rm -rf ./hummingbot-api

另请参阅

• Hummingbot API 文档
• MCP 服务文档