hummingbot-deploy

hummingbot-deploy

Hummingbot のトレーディングインフラストラクチャをデプロイします。開始する前に、何がインストールされるかをユーザーに説明してください。

インストールされるもの

1. Hummingbot API（必須）: トレーディング、マーケットデータの取得、多数の CEX および DEX にまたがるボット戦略のデプロイのための標準化された REST API を公開する、あなた専用のトレーディングサーバーです。

2. Hummingbot MCP（オプション）: AI エージェント（Claude、Gemini、Codex など）が Hummingbot API とやり取りするのを支援する MCP サーバーです。AI エージェント CLI を使用する場合にのみ必要です。

3. Condor（オプション）: Hummingbot API 向けのターミナルおよび Telegram ベースの UI です。

コンポーネント

コンポーネント	リポジトリ
Hummingbot API	hummingbot/hummingbot-api
MCP Server	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 Server のインストール」に進んでください。そうでない場合は、リセットして再インストールします。

新規インストール:

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 Server のインストール

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 エージェントを再起動（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 Docs
• MCP Server Docs