Repolode
Submit
hummingbot

hummingbot/condor

A Telegram bot and web dashboard for monitoring and trading with Hummingbot through the Hummingbot API.

View on GitHubWebsite
Stars
252
Forks
119
Open issues
77
Last commit
11 hours ago

Repolode describes open-source projects and does not give investment advice. Trading and investing can lose money: assess the risk yourself and follow the laws where you live before using this project.

What is it?

Condor is a Telegram bot that lets you check a portfolio, watch running Hummingbot trading bots, and place orders on centralized exchanges or swap tokens and manage CLMM liquidity positions on DEXs through Gateway. It connects to a Hummingbot API server and can also run without Telegram in a local mode, where the dashboard is served on localhost.

Beyond trading commands, Condor includes a browser dashboard with a live trade panel, an AI assistant accessible via /agent that supports OpenAI, OpenRouter, or custom OpenAI-compatible endpoints, and Python routines that can be scheduled. Access is controlled by admin and user roles, and exchange credentials are managed per account through the bot.

Installation uses a shell script that can also deploy the Hummingbot API with Docker. The project recommends placing the API on a private Tailscale network rather than exposing its port publicly.

Key features

  • 01Portfolio dashboard with PNL tracking across 24h, 7d and 30d periods
  • 02Monitoring of active Hummingbot bots with status and metrics
  • 03CEX order placement and position management via interactive menus
  • 04DEX swaps and CLMM liquidity position management through Gateway
  • 05Browser dashboard with a live trade panel for order books, swaps and LP positions
  • 06AI assistant and domain agents with optional OpenAI, OpenRouter or custom LLM endpoints

Use cases

  • Checking balances and bot performance from a phone via Telegram
  • Placing and managing orders on Binance or Bybit without opening the exchange app
  • Running a Hummingbot API server on a VPS and connecting to it privately through Tailscale
  • Scheduling custom Python routines that interact with trading bots

Quick start

  1. 1

    Install Docker Desktop (or Docker on Linux) and make sure it is running

  2. 2

    Run the official install script from the README

  3. 3

    Start Condor

    make run
  4. 4

    Check that the install is working

    make doctor

Things to know

  • Runs on Mac or Linux; Windows users need WSL2 with Ubuntu.
  • Needs Docker running for the Hummingbot API install.
  • Local mode has no login, so anyone who can reach the dashboard port has full trading control.
  • Production use is recommended with Tailscale and strong passwords, which adds setup effort.

In collections

Open-source AI agent frameworks & appsDashboards & business intelligence toolsOpen-source personal AI agents

Topics

#trading#telegram-bot#hummingbot#crypto#dashboard#defi#ai-agent#personal-agent

FAQ

What is condor?
A Telegram bot and web dashboard for monitoring and trading with Hummingbot through the Hummingbot API. Condor is a Telegram bot that lets you check a portfolio, watch running Hummingbot trading bots, and place orders on centralized exchanges or swap tokens and manage CLMM liquidity positions on DEXs through Gateway. It connects to a Hummingbot API server and can also run without Telegram in a local mode, where the dashboard is served on localhost.
Is condor free to use? What license does it have?
condor is open source under the MIT license. Check the license terms before using it in commercial products.
Is condor still maintained?
Actively maintained. The last commit to condor was on Nov 6, 2026.
What can I use condor for?
Checking balances and bot performance from a phone via Telegram Placing and managing orders on Binance or Bybit without opening the exchange app Running a Hummingbot API server on a VPS and connecting to it privately through Tailscale Scheduling custom Python routines that interact with trading bots
How do I install condor?
Install Docker Desktop (or Docker on Linux) and make sure it is running Run the official install script from the README Start Condor: make run Check that the install is working: make doctor
Where can I get condor?
The source code and installation instructions are on GitHub: https://github.com/hummingbot/condor

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects