Queer European MD passionate about IT

Asyncronous python framework for Telegram bot development.

Davte fd4374f328 Compliance with bot API 7.7 1 week ago
davtelepot fd4374f328 Compliance with bot API 7.7 1 week ago
examples 48b7e1e4a2 Updated examples 3 years ago
.gitignore 4f827587ee Mutable defaults removed 4 years ago
LICENSE 4b04d10f78 First commit 5 years ago
MANIFEST.in e8cf7cd421 Version 13 exposed secrets 5 years ago
README.md 925c03b1ed Information updated 5 years ago
push_to_remotes.sh 0c3ed2070d Compliance with Telegram Bot API 6.5 1 year ago
requirements.txt fda4cac348 Import statements refactored 3 years ago
setup.py edb2201773 Package updates checker implemented 4 years ago
update_package.sh 0c3ed2070d Compliance with Telegram Bot API 6.5 1 year ago



This project conveniently mirrors the Telegram bot API with the class Bot.

Please note that Python3.5+ is needed to run async code.

Check requirements.txt for third party dependencies.

Check out help(Bot) for detailed information.

Project folders

davtelepot/data folder

  • config.py contains configuration settings (e.g. certificate path, local_host, port etc.)
  • passwords.py contains secret information to be git-ignored (e.g. bot tokens)
  • *.db files are SQLite databases used by bots
  • *.log: log files (store log_file_name and errors_file_name in data/config.py module)

examples folder

This folder contains full-commented and ready-to-run examples for simple davtelepot.bot Telegram bots.


import sys

from davtelepot.bot import Bot

from data.passwords import my_token, my_other_token

long_polling_bot = Bot(token=my_token, database_url='my_db')
webhook_bot = Bot(token=my_other_token, hostname='example.com',

async def foo_command(bot, update, user_record):
    return "Bar!"

async def bar_command(bot, update, user_record):
    return "Foo!"

exit_state = Bot.run(

Check out help(Bot) for detailed information.

Webhook additional information

To run a bot in webhook modality, you have to provide a hostname and certificate at bot instantiation and a local_host and port when calling Bot.run method.

  • Telegram will send POST requests at https://{hostname}/webhook/{tokens}/ using certificate for encryption
  • aiohttp.web.Application server will listen on http://{local_host}:{port} for updates

It is therefore required a reverse proxy passing incoming requests to local_host.

Example of nginx reverse proxy serving this purpose

server {
  listen 8553 ssl;
  listen [::]:8553 ssl;

  server_name example.com www.example.com;

  location /telegram/ {

  ssl_certificate /path/to/fullchain.pem;
  ssl_certificate_key /path/to/privkey.pem;

Example of python configuration file in this situation

# File data/config.py, gitignored and imported in main script
hostname = "https://www.example.com:8553/telegram"
certificate = "/path/to/fullchain.pem"
local_host = ""
port = 8552

# Main script
from data.config import hostname, certificate, local_host, port
from data.passwords import bot_token
from davtelepot.bot import Bot

my_bot = Bot(

# ...