This folder helps you install Condor (a Telegram bot for trading) and, if you want, Hummingbot API (a web service on your computer). You do not need to be a programmer: copy one of the commands below, paste it into Terminal, press Enter, and answer any questions the installer asks.
- A Mac or Linux computer (Windows users: install WSL2 with Ubuntu, then use Terminal inside Ubuntu).
- The Terminal app open.
- A stable internet connection.
- For Hummingbot API (the API-only install below, or if you choose to add the API during Condor setup): Docker Desktop (Mac/Windows) or Docker on Linux, installed and running on that machine before you run the command.
Open Terminal, go to an empty folder where you are happy to create files (for example your home folder, or cd Desktop first), then paste:
curl -fsSL https://raw.githubusercontent.com/hummingbot/deploy/main/setup.sh | bashThe installer walks you through setup—for example your Telegram bot token and your Telegram user id—and can also install Hummingbot API on the same machine if you choose that when it asks. When it finishes, continue to After installation below.
Use this when you are deploying Hummingbot API on its own machine (for example a VPS or another remote server), or any time you only need the API and database stack and not Condor. Docker must be installed and running on that server before you run the command:
curl -fsSL https://raw.githubusercontent.com/hummingbot/deploy/main/setup.sh | bash -s -- --hummingbot-apiEasiest — from Telegram: open your Condor bot and send /update. Condor checks whether newer code is available and shows buttons so you can update and restart without using Terminal. That only works for the Telegram account you set as admin when you first set up the bot.
Manual — from the computer: if you prefer to run the installer again yourself, go back to the same folder where you first installed (where the condor folder lives), open Terminal there, then paste:
curl -fsSL https://raw.githubusercontent.com/hummingbot/deploy/main/setup.sh | bash -s -- --upgradeOpen Telegram and your Condor bot chat. If the bot started correctly, you should see a message like:
Condor is online and ready.
If you do not see that after a minute or two, use the next step to read error messages.
Paste this, then press Enter:
tmux attach -t condorYou will see text scrolling by—that is the bot’s log. To close the log but keep the bot running: press Ctrl+B, let go, then press D.
On the same computer, open:
- “Docker” errors — Start Docker Desktop (or your Linux Docker service), wait until it is fully running, then run the command again.
- Telegram bot silent — Open the log (
tmux attach -t condor) and check that the token and admin id you entered are correct. - Still stuck — Ask on Discord or open an issue on GitHub.
Only try this if the curl command fails or your network blocks the download. You need more technical comfort here.
Condor — clone the Condor repository, then in that folder run make install and start the app with make run
Hummingbot API (Docker):
git clone --depth 1 https://github.com/hummingbot/hummingbot-api.git hummingbot-api
cd hummingbot-api && make setup && docker compose pull && make deployUse the same commands, but start with bash instead of curl:
bash setup.sh
bash setup.sh --hummingbot-api
bash setup.sh --upgrade- Documentation: Hummingbot Docs
- Discord: Hummingbot Discord
- Problems with this installer: GitHub — hummingbot/deploy
Hummingbot Deploy is licensed under the HUMMINGBOT OPEN SOURCE LICENSE AGREEMENT. See the LICENSE file in this repository for details.