telegram.py

An async API wrapper for the Telegram bot API in Python

Features

• Clean Object Oriented interface with async and await syntax
• Easy to use commands framework that integrates with with Telegram
• Modular bot structure, allowing for reloading of individual components

Installation

Python 3.10 or higher is required to install and use telegram.py.

Install the latest stable release from PyPI:

# Mac/Linux
python3 -m pip install telegram.py

# Windows
py -3 -m pip install telegram.py

Or install the development version from GitHub:

# Mac/Linux
python3 -m pip install git+https://github.com/ilovetocode2019/telegram.py

# Windows
py -3 -m pip install git+https://github.com/ilovetocode2019/telegram.py

Quick Example

import logging

import telegrampy
from telegrampy.ext import commands

logging.basicConfig(level=logging.INFO, format="(%(asctime)s) %(levelname)s %(message)s", datefmt="%m/%d/%y - %H:%M:%S %Z")
logger = logging.getLogger("telegrampy")

bot = commands.Bot("token here")

@bot.command()
async def hi(ctx):
    await ctx.send("Hello")

bot.run()

For a line-by-line walkthrough for this example, see the quickstart.

Important Links

• Documentation
• Telegram Group
• Telegram Channel