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

Component	Description
Condor	Telegram bot interface for trading
Hummingbot API	REST API server for bot management
PostgreSQL	Database for configurations and history
EMQX	MQTT broker for real-time communication

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

Port	Service	Check
8000	API	lsof -i :8000
5432	PostgreSQL	lsof -i :5432
1883	EMQX	lsof -i :1883

View logs

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