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:
🐳 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.
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. |