Telegram MTProto API Framework for Python
Documentation • Changelog • Community

Pyrogram

A fully asynchronous variant is also available!

from pyrogram import Client, Filters

app = Client("my_account")


@app.on_message(Filters.private)
def hello(client, message):
    message.reply("Hello {}".format(message.from_user.first_name))


app.run()

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 build custom Telegram applications that interact with the MTProto API as both user and bot.

Features

• Easy: You can install Pyrogram with pip and start building your app 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 the latest Telegram API version, currently Layer 91 on top of MTProto 2.0.
• 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.

Requirements

• Python 3.4 or higher.
• A Telegram API key.

Installing

pip3 install pyrogram

Getting Started

• The Docs contain lots of resources to help you getting started with Pyrogram: https://docs.pyrogram.ml.
• Reading Examples in this repository is also a good way for learning how Pyrogram works.
• Seeking extra help? Don't be shy, come join and ask our Community!
• For other requests you can send an Email or a Message.

Contributing

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

• Copyright (C) 2017-2019 Dan Tès <https://github.com/delivrance>
• Licensed under the terms of the GNU Lesser General Public License v3 or later (LGPLv3+)