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 "AI Harness"
CONDOR[Condor]
end
subgraph "Server"
API[Hummingbot API]
end
subgraph "Core Components"
CLIENT[Hummingbot Client]
GATEWAY[Gateway]
end
CONDOR --> API
API --> CLIENT
API --> GATEWAY
CLIENT <--> GATEWAY
Repository Overview¶
| Repository | Description | Quickstart | Source Install |
|---|---|---|---|
| Condor | AI harness for building and running agentic strategies and bot instances | Quickstart | Docs |
| Hummingbot Client | Core trading client with CLI interface for CEX trading | Quickstart | Source |
| Hummingbot API | REST API backend for managing bots, portfolios, and trading | via Condor | Source |
| Gateway | DEX middleware for Uniswap, PancakeSwap, Raydium, and 30+ DEXs | - | Installation |
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 →
Condor¶
The AI harness for building and running agentic strategies and bot instances. 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 the web dashboard
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
- 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