https://github.com/aiogram/aiogram

aiogram is a modern and fully asynchronous framework for Telegram Bot API written in Python using asyncio
https://github.com/aiogram/aiogram

aiogram asyncio bot bot-framework python telegram-bot telegram-bot-api

Last synced: 3 days ago
JSON representation

aiogram is a modern and fully asynchronous framework for Telegram Bot API written in Python using asyncio

• Host: GitHub
• URL: https://github.com/aiogram/aiogram
• Owner: aiogram
• License: mit
• Created: 2017-11-18T14:11:13.000Z (about 7 years ago)
• Default Branch: dev-3.x
• Last Pushed: 2024-10-27T18:03:21.000Z (about 2 months ago)
• Last Synced: 2024-10-29T11:13:12.646Z (about 1 month ago)
• Topics: aiogram, asyncio, bot, bot-framework, python, telegram-bot, telegram-bot-api
• Language: Python
• Homepage: https://aiogram.dev
• Size: 7.98 MB
• Stars: 4,699
• Watchers: 102
• Forks: 835
• Open Issues: 29
• Metadata Files:
  • Readme: README.rst
  • Changelog: CHANGES.rst
  • Contributing: CONTRIBUTING.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE
  • Citation: CITATION.cff

Awesome Lists containing this project

• awesome-telegram-bots - aiogram - Is are pretty simple and fully asynchronously library for Telegram Bot API (Libraries / Python)
• awesome-python-resources - Source
• awesome-telegram - AIOGram - A pretty simple and fully asynchronous framework for Telegram Bot API. (Bots / Bot Libs)
• StarryDivineSky - aiogram/aiogram
• awesome-telegram - AIOGram
• awesome-telegram - AIOGram

README

        
#######

aiogram

#######

.. image:: https://img.shields.io/pypi/l/aiogram.svg?style=flat-square

    :target: https://opensource.org/licenses/MIT

    :alt: MIT License

.. image:: https://img.shields.io/pypi/status/aiogram.svg?style=flat-square

    :target: https://pypi.python.org/pypi/aiogram

    :alt: PyPi status

.. image:: https://img.shields.io/pypi/v/aiogram.svg?style=flat-square

    :target: https://pypi.python.org/pypi/aiogram

    :alt: PyPi Package Version

.. image:: https://img.shields.io/pypi/dm/aiogram.svg?style=flat-square

    :target: https://pypi.python.org/pypi/aiogram

    :alt: Downloads

.. image:: https://img.shields.io/pypi/pyversions/aiogram.svg?style=flat-square

    :target: https://pypi.python.org/pypi/aiogram

    :alt: Supported python versions

.. image:: https://img.shields.io/badge/dynamic/json?color=blue&logo=telegram&label=Telegram%20Bot%20API&query=%24.api.version&url=https%3A%2F%2Fraw.githubusercontent.com%2Faiogram%2Faiogram%2Fdev-3.x%2F.butcher%2Fschema%2Fschema.json&style=flat-square

    :target: https://core.telegram.org/bots/api

    :alt: Telegram Bot API

.. image:: https://img.shields.io/github/actions/workflow/status/aiogram/aiogram/tests.yml?branch=dev-3.x&style=flat-square

    :target: https://github.com/aiogram/aiogram/actions

    :alt: Tests

.. image:: https://img.shields.io/codecov/c/github/aiogram/aiogram?style=flat-square

    :target: https://app.codecov.io/gh/aiogram/aiogram

    :alt: Codecov

**aiogram** is a modern and fully asynchronous framework for

`Telegram Bot API `_ written in Python 3.8+ using

`asyncio `_ and

`aiohttp `_.

Make your bots faster and more powerful!

Documentation:

 - 🇺🇸 `English `_

 - 🇺🇦 `Ukrainian `_

Features

========

- Asynchronous (`asyncio docs `_, :pep:`492`)

- Has type hints (:pep:`484`) and can be used with `mypy `_

- Supports `PyPy `_

- Supports `Telegram Bot API 8.0 `_ and gets fast updates to the latest versions of the Bot API

- Telegram Bot API integration code was `autogenerated `_ and can be easily re-generated when API gets updated

- Updates router (Blueprints)

- Has Finite State Machine

- Uses powerful `magic filters `_

- Middlewares (incoming updates and API calls)

- Provides `Replies into Webhook `_

- Integrated I18n/L10n support with GNU Gettext (or Fluent)

.. warning::

    It is strongly advised that you have prior experience working

    with `asyncio `_

    before beginning to use **aiogram**.

    If you have any questions, you can visit our community chats on Telegram:

    - 🇺🇸 `@aiogram `_

    - 🇺🇦 `@aiogramua `_

    - 🇺🇿 `@aiogram_uz `_

    - 🇰🇿 `@aiogram_kz `_

    - 🇷🇺 `@aiogram_ru `_

    - 🇮🇷 `@aiogram_fa `_

    - 🇮🇹 `@aiogram_it `_

    - 🇧🇷 `@aiogram_br `_