Skip to content

Installation

Hummingbot is a local software client that helps you run trading strategies that automate the execution of orders and trades on various cryptocurrency exchanges and protocols.

Releases

Hummingbot's code is publicly hosted at https://github.com/hummingbot/hummingbot, and the development branch is continually updated.

Approximately once a month, we publish an official release of Hummingbot onto the master branch. See Releases.

Installation options

🌎 Test-Drive (web)

You can initially try out hummingbot in your browser without installing anything by simply visiting the Test-Drive page.

💻 Binary (Mac/Windows)

Warning

Binary releases are no longer maintained. The last available version is 0.46. We recommend enabling WSL on Windows 10/11 and running Hummingbot on the integrated Linux Virtual Machine. Instructions here

Download and run the binary installer to install the last available binary release of Hummingbot:

Windows MacOS

🐳 Docker

The Hummingbot DockerHub publishes Docker images for the master (latest) and development builds of Hummingbot, as well as past versions.

We recommend this path for users who run Hummingbot on Linux, in the cloud, and/or multiple bots.

Read the Docker installation guide: Install Hummingbot on Docker

🛠️ Source

Install Hummingbot from source, including all dependencies.

We recommend this path for developers who want to customize Hummingbot's behavior or to build new connectors and strategies.

Read the source installation guide: Install Hummingbot from Source

🍓 Raspberry Pi

Hummingbot doesn't require much power, so some users have run successfully run multiple instances on a single Raspberry Pi. We maintain an experimental build that shows users how to do this.

Install on Raspberry Pi

System requirements

Hummingbot has been successfully tested with the following specifications:

Resource Requirement
Operating System Linux: Ubuntu 16.04 or later (recommended) *Other Linux installations: Debian GNU/Linux 9, CentOS 7, Amazon Linux 2 AMI
MacOS: macOS 10.12.6 (Sierra) or later
Windows: Windows 10 or later
Memory/RAM 1 GB one instance +250 MB per additional instance
Storage Install using Docker: 5 GB per instance
Install from source: 3 GB per instance
Network A reliable internet connection is critical to keeping Hummingbot connected to exchanges.

Last update: 2022-05-15