🔥 Telegram MTProto API Client Library and Framework for Python
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Dan 428cbf56a6
Read integers first when size matches
1 day ago
.github Use a cleaner link 3 months ago
compiler Update API schema to Layer 133 (patch) 1 day ago
docs Update handling errors example 4 months ago
pyrogram Read integers first when size matches 1 day ago
tests Fix Message.command when case is different (#757) 1 week ago
.gitignore .gitignore docs generated files 1 year ago
COPYING Initial commit 3 years ago
COPYING.lesser Initial commit 3 years ago
MANIFEST.in Remove non-python files 9 months ago
NOTICE Update copyright notice 8 months ago
README.md Update copyright year in forgotten places (#583) 8 months ago
dev-requirements.txt Update configuration for tests 4 months ago
requirements.txt Deep rewrite: preparing for v1.0 1 year ago
setup.py Update copyright notice 8 months ago
tox.ini Update configuration for tests 4 months ago


Telegram MTProto API Framework for Python
Documentation Releases Community


from pyrogram import Client, filters

app = Client("my_account")

async def hello(client, message):
    await message.reply_text(f"Hello {message.from_user.mention}")


Pyrogram is a modern, elegant and easy-to-use Telegram client library framework written from the ground up in Python and C. It enables you to easily create custom Telegram client applications for both user and bot identities (bot API alternative) via the MTProto API.


  • Easy: You can install Pyrogram with pip and start building your applications right away.
  • Elegant: Low-level details are abstracted and re-presented in a much nicer and easier way.
  • Fast: Crypto parts are boosted up by TgCrypto, a high-performance library written in pure C.
  • Asynchronous: Allows both synchronous and asynchronous models to fit all usage needs.
  • Documented: API methods, types and public interfaces are all well documented.
  • Type-hinted: Types and methods are all type-hinted, enabling excellent editor support.
  • Updated, to make use of the latest Telegram API version and features.
  • Bot API-like: Similar to the Bot API in its simplicity, but much more powerful and detailed.
  • Pluggable: The Smart Plugin system allows to write components with minimal boilerplate code.
  • Comprehensive: Execute any advanced action an official client is able to do, and even more.



pip3 install pyrogram