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¶
┌─────────────────────────────────────────────────────────────────┐
│ User Interfaces │
├───────────────────┬─────────────────────┬───────────────────────┤
│ Condor │ MCP │ Dashboard │
│ (Telegram UI) │ (AI Agents) │ (Web UI, deprecated) │
└─────────┬─────────┴──────────┬──────────┴───────────┬───────────┘
│ │ │
└────────────────────┼──────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────────┐
│ Hummingbot API │
│ REST API for bot management & trading │
└─────────────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────────┐
│ Core Components (can be run standalone without API) │
│ │
│ ┌─────────────────────────────┐ ┌─────────────────────────┐ │
│ │ Hummingbot Client │──►│ Gateway │ │
│ │ (CLI, CLOB Connectors) │ │ (AMM DEX Connectors) │ │
│ └─────────────────────────────┘ └─────────────────────────┘ │
└─────────────────────────────────────────────────────────────────┘
┌─────────────────────────────────────────────────────────────────┐
│ Quants Lab │
│ Standalone research environment for backtesting, │
│ data collection, and strategy analysis │
│ │ │
│ ▼ │
│ Hummingbot Library │
│ Python package for data and backtesting tools │
└─────────────────────────────────────────────────────────────────┘
Repository Overview¶
| Repository | Description | Installation | Quickstart |
|---|---|---|---|
| Hummingbot API | REST API backend for managing bots, portfolios, and trading | Installation | Quickstart |
| Hummingbot Client | Core trading client with CLI interface for CEX trading | Installation | Quickstart |
| Gateway | DEX middleware for Uniswap, PancakeSwap, Raydium, and 30+ DEXs | Installation | - |
| Condor | Telegram bot for monitoring and controlling Hummingbot instances | Installation | - |
| MCP Server | Connects AI assistants (Claude, Gemini, ChatGPT) to Hummingbot | Installation | - |
| Dashboard | Web-based UI for bot management (deprecated, use Condor) | GitHub | Quickstart |
| Quants Lab | Research environment for backtesting and strategy analysis | GitHub | - |
Recommended Paths¶
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
Developers¶
For developers who want to add/customize exchange connectors, extend strategies, or otherwise modify the Hummingbot codebase:
Source Installation
- Hummingbot Client from Source - Install the core trading client for development
- Gateway from Source - Install the DEX connector middleware for development
Building Connectors
- Building CLOB Connectors - Add new CEX/DEX order book connectors to Hummingbot Client
- Building Gateway Connectors - Add new AMM DEX connectors to Gateway
API Development
- Hummingbot API Developer Guide - Use the REST API with curl or Python client