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 Quickstart 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 via API Quickstart -
MCP Server Connects AI assistants (Claude, Gemini, ChatGPT) to Hummingbot - Installation
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 →

Hummingbot API

The modern REST API backend for managing multiple bots. Best for:

  • Multiple instances - Deploy and manage many bots simultaneously
  • Production environments - Running on cloud servers (AWS, Digital Ocean, etc.)
  • Modern interfaces - Use Condor (Telegram) or AI agents via MCP
  • Portfolio management - Track balances across all exchanges in one place

Hummingbot API Quickstart →

Developers

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

Source Installation

Building Connectors

API Development