Skip to main content
Python Software Foundation 20th Year Anniversary Fundraiser  Donate today!

A telegram bot for

Project description

keel-telegram-bot Build Status PyPI version

keel-telegram-bot is a telegram bot for Keel.


  • <input type="checkbox" checked="" disabled="" /> Receive notifications (via Webhook)
  • <input type="checkbox" checked="" disabled="" /> List approvals
  • <input type="checkbox" checked="" disabled="" /> Approve pending approvals
  • <input type="checkbox" checked="" disabled="" /> Reject pending approvals
  • <input type="checkbox" checked="" disabled="" /> Delete archived approvals

How to use

Manual installation


Install keel-telegram-bot using pip:

pip3 install keel-telegram-bot


keel-telegram-bot uses container-app-conf to provide configuration via a YAML file as well as ENV variables. Have a look at the documentation about it.

See keel-telegram-bot_example.yaml for an example in this repo.


Start the bot by using:



To run keel-telegram-bot using docker you can use the markusressel/keel-telegram-bot image from DockerHub:

sudo docker run -t \

Configure the image using either environment variables, or mount the configuration file from your host system to /app/keel-telegram-bot.yaml.


This bot uses the REST api provided by Keel to interact with it and relies on the Webhook functionality to receive and forward notifications to telegram chats. On one hand keel-telegram-bot acts like the web interface, on the other hand it acts like a proxy, both combined into a single package.

To get the commands working simply provide all the necessary details of the configuration file.

To get notifications working you will have to provide the address of keel-telegram-bot to Keel using the WEBHOOK_ENDPOINT env variable. The simplest way to achieve this is by running both Keel and keel-telegram-bot on the same host and specifying http://localhost:5000/.


GitHub is for social coding: if you want to write code, I encourage contributions through pull requests from forks of this repository. Create GitHub tickets for bugs and new features and comment on the ones that you are interested in.


keel-telegram-bot by Markus Ressel
Copyright (C) 2020  Markus Ressel

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program.  If not, see <>.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for keel-telegram-bot, version 1.2.0
Filename, size File type Python version Upload date Hashes
Filename, size keel_telegram_bot-1.2.0-py3-none-any.whl (30.8 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size keel-telegram-bot-1.2.0.tar.gz (26.1 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page