🔥 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 ab63abe6fd Update API schema to Layer 129 1 week ago
.github Use a cleaner link 1 week ago
compiler Update API schema to Layer 129 1 week ago
docs Update handling errors example 1 month ago
pyrogram Merge branch 'chat-permissions-others' 1 week ago
tests Fix duplicated commands in Message.command 1 month ago
.gitignore .gitignore docs generated files 9 months ago
COPYING Initial commit 3 years ago
COPYING.lesser Initial commit 3 years ago
MANIFEST.in Remove non-python files 5 months ago
NOTICE Update copyright notice 5 months ago
README.md Update copyright year in forgotten places (#583) 5 months ago
dev-requirements.txt Update configuration for tests 1 month ago
requirements.txt Deep rewrite: preparing for v1.0 9 months ago
setup.py Update copyright notice 5 months ago
tox.ini Update configuration for tests 1 month 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