Awesome Open Source
Awesome Open Source


.. image:: :target:

Asynchronous Python API for building Telegram bots, featuring:

  • Easy and declarative API
  • Hassle-free setup - no need for SSL certificates or static IP
  • Built-in support for analytics via
  • Automatic handling of Telegram API throttling or timeouts

Install it with pip:

.. code:: sh

pip install aiotg

Then you can create a new bot in few lines:

.. code:: python

from aiotg import Bot, Chat

bot = Bot(api_token="...")

@bot.command(r"/echo (.+)")
def echo(chat: Chat, match):
    return chat.reply(

Now run it with a proper API_TOKEN and it should reply to /echo commands.

.. note:: Type annotations are not required but will help your editor/IDE to provide code completion.

The example above looks like a normal synchronous code but it actually returns a coroutine. If you want to make an external request (and that's what bots usually do) just use aiohttp and async/await syntax:

.. code:: python

import aiohttp
from aiotg import Bot, Chat

bot = Bot(api_token="...")

async def bitcoin(chat: Chat, match):
    url = ""
    async with aiohttp.ClientSession() as session:
        response = await session.get(url)
        info = await response.json()
        await chat.send_text(str(info["averages"]["day"]))

But what if you just want to write a quick integration and don't need to provide a conversational interface? We've got you covered! You can send messages (or any other media) by constructing a Chat object with user_id or channel name. We even saved you some extra keystrokes by providing handy Channel constructors:

.. code:: python

channel ="@yourchannel")
private = bot.private("1111111")

async def greeter():
    await channel.send_text("Hello from channel!")
    await private.send_text("Why not greet personally?")


  • Async IO <>__
  • Send image <>__
  • Post to channel <>__
  • Webhooks mode <>__
  • Sender id <>__

For a real world example, take a look at WhatisBot <>__ or Music Catalog Bot <>__.

For more information on how to use the project, see the project's documentation <>__.

Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
python (54,447
bot (778
telegram (364
asyncio (280