name: hummingbot-api-setup
description: Deploy Hummingbot infrastructure including API server, Condor Telegram bot, PostgreSQL, and Gateway for DEX trading. Use this skill when the user wants to install, deploy, or set up Hummingbot.
license: Apache-2.0
creator-github-handle: david-hummingbot

hummingbot-api-setup

Deploy Hummingbot infrastructure using the official installer from hummingbot/deploy.

Quick Start

# Fresh install (Condor + API)
./scripts/setup.sh

# Install API only
./scripts/setup.sh --api

# Upgrade existing installation
./scripts/setup.sh --upgrade

What Gets Installed

Installation Options

./scripts/setup.sh [OPTIONS]

Options:
  --upgrade    Upgrade existing installation
  --api        Install only Hummingbot API (standalone)
  -h, --help   Show help message

After Installation

Hummingbot API

• URL: http://localhost:8000
• Docs: http://localhost:8000/docs
• Default credentials: admin/admin

Condor (Telegram Bot)

1. Open Telegram
2. Search for your bot (configured during setup)
3. Use /config to add API servers
4. Use /start to begin trading

Health Check

Verify installation is running:

./scripts/health_check.sh

System Requirements

• OS: Linux or macOS
• Docker: Required (script will guide installation)
• Disk Space: 2GB minimum
• Dependencies: git, curl, make (auto-installed)

Troubleshooting

Docker not running

macOS:

open -a Docker

Linux:

sudo systemctl start docker

Port conflicts

View logs

cd ~/hummingbot-api && docker compose logs -f
cd ~/condor && docker compose logs -f