hummingbot /hummingbot

Open source software that helps you create and deploy high-frequency crypto trading bots

★ 21,231⑂ 5,151👁 201⑃ 4,950● 3,508▤ 111
PythonApache-2.0Created 2019-04-02hummingbot.org
Download: v2.17.0v2.17.0 ↓2.17.02026-09-22
+20
Daily
21,231
stars
5,151
forks
201
watchers
4,950
prs
3,508
issues
111
releases

README

!Hummingbot

----





Hummingbot is an open-source framework that helps you design and deploy automated trading strategies, or bots, that can run on many centralized or decentralized exchanges. Over the past year, Hummingbot users have generated over $34 billion in trading volume across 140+ unique trading venues.

The Hummingbot codebase is free and publicly available under the Apache 2.0 open-source license. Our mission is to democratize high-frequency trading by creating a global community of algorithmic traders and developers that share knowledge and contribute to the codebase.

 Quick Links

 Website and Docs: Official Hummingbot website and documentation
 Installation: Install Hummingbot on various platforms
 Discord: The main gathering spot for the global Hummingbot community
 YouTube: Videos that teach you how to get the most out of Hummingbot
 Twitter: Get the latest announcements about Hummingbot
 Reported Volumes: Reported trading volumes across all Hummingbot instances
 Newsletter: Get our newsletter whenever we ship a new release

 Getting Started

 Condor (AI harness)

Condor is the AI harness for building and running agentic strategies and bot instances. It connects LLM-powered decision-making to deterministic trade execution via the Hummingbot API, controlled through Telegram or its web dashboard. See condor.hummingbot.org to get started.

 hbot CLI

The recommended way to run the Hummingbot client directly is the hbot command-line interface, installed from
source. hbot runs, controls, and monitors a trading bot non-interactively: start/stop a bot, author
and tune configs, and read trades, PnL, logs, and status — all scriptable, as compact Markdown with
stable exit codes. See the hbot CLI guide for the full reference.

Requires Anaconda or Miniconda.

bash
 Clone the repository
git clone https://github.com/hummingbot/hummingbot.git
cd hummingbot

 Create the conda environment, build extensions, and expose the hbot CLI
make install

 Activate the environment
conda activate hummingbot
hbot --help


To use hbot outside the conda environment, run make link-cli to add it to your host PATH.

On first use, hbot prompts for a keystore password that encrypts your exchange API keys — set HBOT_PASSWORD or pass --password-stdin to run non-interactively (e.g. in scripts or agent workflows).

Then create a config and run the simple_pmm paper trading script — it simulates trading against live Binance market data, so no API keys are required:

bash
hbot create simple_pmm --name conf_paper_bot.yml \
     --set exchange=binance_paper_trade --set trading_pair=BTC-USDT
hbot start conf_paper_bot.yml                           run it (one bot per install)
hbot status                                             check on it
hbot stop                                               stop gracefully


To trade live, connect your exchange API keys and run a strategy controller like pmm_mister — a reusable V2 strategy whose settings can be tuned live while the 

Top issues

Latest release

v2.17.0 v2.17.0 2026-09-22
What's Changed
 Update README exchange tables for v2.16.0 by @fengtality in https://github.com/hummingbot/hummingbot/pull/8402
 Update README for master: exchange tables, Getting Started, Strategies by @fengtality in https://github.com/hummingbot/hummingbot/pull/8403
 Feat/std executor config failures by @cardosofede in https://github.com/hummingbot/hummingbot/pull/8421
 fix / Hyperliquid auth silently accepting wrong private keys (7866) by @ipezygj in https://github.com/hummingbot/hummingbot/pull/8212
 Fix Hyperliquid builder fee not resolving when connector is embedded by @fengtality in

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON