Skip to content

Installation Overview

The Hummingbot ecosystem consists of several repositories that work together to provide a complete algorithmic trading platform. This page provides an overview of each component and links to their installation guides.

Hummingbot Ecosystem

graph TB
    subgraph "User Interfaces"
        CONDOR[Condor]
        MCP[MCP<br/>AI Agents]
    end

    subgraph "Server"
        API[Hummingbot API]
    end

    subgraph "Core Components"
        CLIENT[Hummingbot Client]
        GATEWAY[Gateway]
    end

    CONDOR --> API
    MCP --> API
    API --> CLIENT
    API --> GATEWAY
    CLIENT <--> GATEWAY

Repository Overview

Repository Description Quickstart Source Install
Hummingbot API REST API backend for managing bots, portfolios, and trading via Condor Source
Hummingbot Client Core trading client with CLI interface for CEX trading Quickstart Source
Gateway DEX middleware for Uniswap, PancakeSwap, Raydium, and 30+ DEXs - Installation
Condor Telegram bot for monitoring and controlling Hummingbot instances Quickstart Docs
MCP Server Connects AI assistants (Claude, Gemini, ChatGPT) to Hummingbot - Installation
Skills Agent skills for AI assistants to manage strategies, executors, and infrastructure - GitHub
Dashboard Web-based UI for bot management (deprecated, use Condor) - GitHub
Quants Lab Research environment for backtesting and strategy analysis - GitHub

Hummingbot Client

The legacy CLI-based trading client. Best for:

  • Getting started - Most users begin here to learn Hummingbot
  • Local usage - Running on your local machine
  • V1 strategies - Pure Market Making, Cross-Exchange Market Making, etc.
  • Single instance - Running one bot at a time

Hummingbot Client Quickstart →

Condor

The modern Telegram-based interface for Trading Agents. Best for:

  • Trading Agents - Build and run autonomous trading agents
  • Multiple instances - Deploy and manage many bots simultaneously
  • Production environments - Running on cloud servers (AWS, Digital Ocean, etc.)
  • Modern interfaces - Control via Telegram or AI agents via MCP

Condor Quickstart →

For full documentation, see condor.hummingbot.org.

Developers

For developers who want to add/customize exchange connectors, extend strategies, or otherwise modify the Hummingbot codebase:

Source Installation

Building Connectors

API Development