Skip to main content

Documentation Index

Fetch the complete documentation index at: https://condor.hummingbot.org/llms.txt

Use this file to discover all available pages before exploring further.

​
Prerequisites

ComponentMinimumRecommended
OSLinux x64 or ARM (Ubuntu 20.04+), macOSUbuntu 22.04 LTS
Memory4 GB RAM8 GB RAM
Storage10 GB SSD20 GB SSD
CPU2 vCPUs4 vCPUs
Any cloud provider works. Popular choices:
  • AWS EC2: t3.medium or larger
  • Google Cloud: e2-medium or larger
  • Digital Ocean: Basic Droplet with 4GB RAM
  • Hetzner: CX21 or larger
Configure security group to allow ports 22 (SSH) and 8000 (API).

​
Install Condor

From an empty directory on the machine where you want Condor (and optionally the Hummingbot API on the same host), run: 
curl -fsSL https://raw.githubusercontent.com/hummingbot/deploy/main/setup.sh | bash
For API-only installs, manual git clone setup, and more detail, see Installing Condor. The installer will prompt for:
  • Your Telegram bot token (see Create a Telegram Bot or @BotFather)
  • Your authorized Telegram user ID(s)
  • Whether to configure and launch Hummingbot API with Docker—answer yes if you are deploying Condor and the API on the same machine locally. Have Docker installed and running first. If the API runs on another server, you can skip this step and add that API URL later in Telegram under /servers.

​
Verify Installation

Open your Telegram bot and send /start. You should see the main menu.
Note: After a successful start, admins should receive “Condor is online and ready.” in Telegram. If not, see Installing Condor — Troubleshooting.

​
Access Points

ServiceURLDescription
APIhttp://localhost:8000REST API endpoints
Swagger UIhttp://localhost:8000/docsInteractive API documentation

​
Managing Services

After the deploy installer: Condor runs in a tmux session named condor. 
tmux attach -t condor
tmux kill-session -t condor   # stop Condor
Upgrade later from the directory that contains condor: 
curl -fsSL https://raw.githubusercontent.com/hummingbot/deploy/main/setup.sh | bash -s -- --upgrade
Hummingbot API: From the hummingbot-api directory: docker compose ps and docker compose logs -f. Manual / dev run (make run from a git clone): stop with Ctrl+C in that terminal.

​
Next Steps

Getting Started

Connect Telegram, add keys, and start using Condor

Trading Agents

Learn about the agent framework