Skip to main content

​
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

Clone the repository and run the install script: 
git clone https://github.com/hummingbot/condor.git
cd condor

make install     # Interactive setup + dependencies + AI CLI tools
make run         # Start the bot
The install script will prompt for:
  • Your Telegram bot token (see Quickstart to create one)
  • Your authorized Telegram user IDs

​
Verify Installation

Open your Telegram bot and send /start. You should see the main menu.

​
Access Points

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

​
Managing Services

# Start Condor
make run

# Stop Condor (Ctrl+C or from another terminal)
make stop

# View logs
make logs

​
Next Steps

Quickstart

Connect Telegram, add keys, and start using Condor

Trading Agents

Learn about the agent framework