Skip to content
🔥 Telegram MTProto API Client Library and Framework for Python
Python PLpgSQL
Branch: develop
Clone or download
Latest commit 5022b69 Oct 27, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github Update Aug 16, 2019
compiler Add set_slow_mode method Oct 27, 2019
docs Add FAQ about why stop, restart, add/remove_handler could make the co… Oct 27, 2019
pyrogram Add set_slow_mode method Oct 27, 2019
.gitignore Update .gitignore with vscode and alternate docs build dir Jul 15, 2019
COPYING Initial commit Dec 5, 2017
COPYING.lesser Initial commit Dec 5, 2017 Update errors prune path Jun 30, 2019
NOTICE Update copyright year Jan 1, 2019 Drop Python 3.4 support (EOL). Bump minimum requirement to Python 3.5.3 Aug 15, 2019
requirements.txt Drop Python 3.4 support (EOL). Bump minimum requirement to Python 3.5.3 Aug 15, 2019 Drop Python 3.4 support (EOL). Bump minimum requirement to Python 3.5.3 Aug 15, 2019

Telegram MTProto API Framework for Python
Documentation Releases Community


from pyrogram import Client, Filters

app = Client("my_account")

def hello(client, message):
    message.reply_text("Hello {}".format(message.from_user.first_name))

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

Pyrogram in fully-asynchronous mode is also available »

Working PoC of Telegram voice calls using Pyrogram »


  • 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.
  • Documented: Pyrogram API methods, types and public interfaces are well documented.
  • Type-hinted: Exposed Pyrogram types and method parameters are all type-hinted.
  • 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



Pyrogram is brand new, and you are welcome to try it and help make it even better by either submitting pull requests or reporting issues/bugs as well as suggesting best practices, ideas, enhancements on both code and documentation. Any help is appreciated!

Copyright & License

You can’t perform that action at this time.