Skip to main content
Join the official Python Developers Survey 2018 and win valuable prizes: Start the survey!

Telegram MTProto API Client Library for Python

Project description


Telegram MTProto API Client Library for Python

Scheme Layer TgCrypto


from pyrogram import Client, Filters

app = Client("my_account")

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

Pyrogram is a brand new Telegram Client Library written from the ground up in Python and C. It can be used for building custom Telegram applications that interact with the MTProto API as both User and Bot.


  • Easy to use: You can easily install Pyrogram using pip and start building your app right away.
  • High-level: The low-level details of MTProto are abstracted and automatically handled.
  • Fast: Crypto parts are boosted up by TgCrypto, a high-performance library written in pure C.
  • Updated to the latest Telegram API version, currently Layer 82 on top of MTProto 2.0.
  • Documented: The Pyrogram API is well documented and resembles the Telegram Bot API.
  • Full API, allowing to execute any advanced action an official client is able to do, and more.



pip3 install pyrogram

Getting Started

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


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!

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
Pyrogram-0.8.0-py3-none-any.whl (1.5 MB) Copy SHA256 hash SHA256 Wheel py3 Sep 19, 2018
Pyrogram-0.8.0.tar.gz (232.2 kB) Copy SHA256 hash SHA256 Source None Sep 19, 2018

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page