Skip to main content
Condor uses a two-server architecture: the Condor Server (agentic layer) and the Hummingbot API Server (execution layer). This guide installs both.

​
Quick Install

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:

​
Create a Telegram Bot

  1. Open @BotFather in Telegram
  2. Send /newbot and follow the prompts to name your bot
  3. Copy the bot token (format: 123456789:ABCdefGHIjklMNOpqrsTUVwxyz)

​
Get Your User ID

  1. Open @userinfobot in Telegram
  2. Send /start to receive your user ID

​
Verify Installation

  1. Open your Telegram bot and send /start
  2. You should see the main menu with commands like /portfolio, /trade, /agent
Welcome to Condor! 🦅

Commands:
/portfolio - View balances
/trade - Place orders
/agent - Trading Agents
/keys - Manage credentials
/config - Settings

​
Access Points

ServiceURLDescription
TelegramYour botPrimary interface
APIhttp://localhost:8000REST API
Swaggerhttp://localhost:8000/docsAPI documentation
Web DashboardRun /web in TelegramBrowser interface

​
Managing Services

# Start Condor
make run

# Stop Condor
make stop

# View logs
make logs

​
Troubleshooting

  1. Check that Condor is running: make logs
  2. Verify your bot token is correct
  3. Ensure your user ID is in the allowed list
  1. Check Hummingbot API is running: docker ps
  2. Verify port 8000 is accessible
  3. Check credentials in config

​
Next Step

Adding Credentials

Connect your exchange accounts