Binary, Docker, and Source Installation Guide
The macOS install package allows very easy installation and running Hummingbot on Mac computers. macOS install packages are released with every Hummingbot release starting from v0.18.
To install Hummingbot with macOS install package:
- Download Hummingbot .dmg file from our download page.
- Open the downloaded .dmg file, drag and drop the application bundle into the
- Launch Hummingbot just like any other installed application on your Mac. You can also add it to your Dock for easy access.
When you start Hummingbot for the first time, it will ask for permission to launch Terminal since it is a Terminal application. Press "OK" to allow it to open.
The application data files (e.g., logs and config files) are located differently for binary package installed Hummingbot vs. source compiled Hummingbot.
For the macOS .dmg distribution, the application data files are located in
- Install Docker
Skip this step if you already have Docker installed. You can install Docker by downloading an installer from the official page. After you have downloaded and installed Docker, restart your system if necessary.
- Install Hummingbot
You can install Hummingbot by selecting either of the following options from the tabs below:
- Scripts: download and use automated install scripts.
- Manual: run install commands manually.
# 1) Download Hummingbot install, start, and update script curl https://raw.githubusercontent.com/CoinAlpha/hummingbot/development/installation/docker-commands/create.sh -o create.sh curl https://raw.githubusercontent.com/CoinAlpha/hummingbot/development/installation/docker-commands/start.sh -o start.sh curl https://raw.githubusercontent.com/CoinAlpha/hummingbot/development/installation/docker-commands/update.sh -o update.sh # 2) Enable script permissions chmod a+x *.sh # 3) Create a hummingbot instance ./create.sh
# 1) Create a folder for your new instance mkdir hummingbot_files # 2) Create folders for logs, config files and database file mkdir hummingbot_files/hummingbot_conf mkdir hummingbot_files/hummingbot_logs mkdir hummingbot_files/hummingbot_data mkdir hummingbot_files/hummingbot_scripts # 3) Launch a new instance of hummingbot docker run -it \ --network host \ --name hummingbot-instance \ --mount "type=bind,source=$(pwd)/hummingbot_files/hummingbot_conf,destination=/conf/" \ --mount "type=bind,source=$(pwd)/hummingbot_files/hummingbot_logs,destination=/logs/" \ --mount "type=bind,source=$(pwd)/hummingbot_files/hummingbot_data,destination=/data/" \ --mount "type=bind,source=$(pwd)/hummingbot_files/hummingbot_scripts,destination=/scripts/" \ coinalpha/hummingbot:latest
This section walks you through how to prepare your development environment.
- Install Xcode command line tools
Running Hummingbot on macOS requires Xcode and Xcode command line tools.
- Install Anaconda3
Hummingbot requires Python 3 and other Python libraries. To manage these dependencies, Hummingbot uses Anaconda, an open-source environment, and package manager for Python that is the current industry standard for data scientists and data engineers.
To install Anaconda, go to the Anaconda site and download the Python 3.7 installer for your operating system. Both the graphical installer and the command line installer will work. Run the installer, and it will guide you through the installation process.
Afterward, open a Terminal window and try the
conda command. If the command is valid, then Anaconda has been successfully installed, even if the graphical installer says that it failed.
__conda_setup="$(CONDA_REPORT_ERRORS=false '/anaconda3/bin/conda' shell.bash hook 2> /dev/null)" if [ $? -eq 0 ]; then \eval "$__conda_setup" else if [ -f "/anaconda3/etc/profile.d/conda.sh" ]; then . "/anaconda3/etc/profile.d/conda.sh" CONDA_CHANGEPS1=false conda activate base else \export PATH="/anaconda3/bin:$PATH" fi fi unset __conda_setup
- Install Hummingbot
# 1) Clone Hummingbot repo git clone https://github.com/CoinAlpha/hummingbot.git # 2) Navigate into the hummingbot folder cd hummingbot # 3) Run install script ./install # 4) Activate the environment conda activate hummingbot # 5) Compile ./compile # 6) Run Hummingbot bin/hummingbot.py
After installing Hummingbot from source, see Launch Hummingbot from source for instructions on starting and running Hummingbot from source.