2019-05-13 15:15:00 +00:00
|
|
|
<p align="center">
|
|
|
|
<a href="https://github.com/pyrogram/pyrogram">
|
2022-01-07 09:18:51 +00:00
|
|
|
<img src="https://docs.pyrogram.org/_static/pyrogram.png" alt="Pyrogram" width="128">
|
2019-05-13 15:15:00 +00:00
|
|
|
</a>
|
|
|
|
<br>
|
|
|
|
<b>Telegram MTProto API Framework for Python</b>
|
|
|
|
<br>
|
2019-05-19 19:40:41 +00:00
|
|
|
<a href="https://docs.pyrogram.org">
|
2019-05-13 15:15:00 +00:00
|
|
|
Documentation
|
|
|
|
</a>
|
|
|
|
•
|
2022-01-07 09:18:51 +00:00
|
|
|
<a href="https://docs.pyrogram.org/releases">
|
2019-05-13 15:15:00 +00:00
|
|
|
Releases
|
|
|
|
</a>
|
|
|
|
•
|
2022-01-07 09:18:51 +00:00
|
|
|
<a href="https://t.me/pyrogram">
|
|
|
|
News
|
2019-05-13 15:15:00 +00:00
|
|
|
</a>
|
|
|
|
</p>
|
|
|
|
|
|
|
|
## Pyrogram
|
|
|
|
|
2022-01-07 09:18:51 +00:00
|
|
|
> Elegant, modern and asynchronous Telegram MTProto API framework in Python for users and bots
|
|
|
|
|
2019-05-13 15:15:00 +00:00
|
|
|
``` python
|
2020-08-22 06:05:05 +00:00
|
|
|
from pyrogram import Client, filters
|
2019-05-13 15:15:00 +00:00
|
|
|
|
|
|
|
app = Client("my_account")
|
|
|
|
|
|
|
|
|
2020-08-22 06:05:05 +00:00
|
|
|
@app.on_message(filters.private)
|
|
|
|
async def hello(client, message):
|
2022-01-07 09:18:51 +00:00
|
|
|
await message.reply("Hello from Pyrogram!")
|
2019-05-13 15:15:00 +00:00
|
|
|
|
|
|
|
|
|
|
|
app.run()
|
|
|
|
```
|
|
|
|
|
2022-01-07 09:18:51 +00:00
|
|
|
**Pyrogram** is a modern, elegant and asynchronous [MTProto API](https://docs.pyrogram.org/topics/mtproto-vs-botapi)
|
|
|
|
framework. It enables you to easily interact with the main Telegram API through a user account (custom client) or a bot
|
|
|
|
identity (bot API alternative) using Python.
|
2019-05-13 15:15:00 +00:00
|
|
|
|
2022-01-07 09:18:51 +00:00
|
|
|
### Support
|
2019-05-13 15:15:00 +00:00
|
|
|
|
2022-01-07 09:18:51 +00:00
|
|
|
If you'd like to support Pyrogram, you can consider:
|
|
|
|
|
|
|
|
- [Become a GitHub sponsor](https://github.com/sponsors/delivrance).
|
|
|
|
- [Become a LiberaPay patron](https://liberapay.com/delivrance).
|
|
|
|
- [Become an OpenCollective backer](https://opencollective.com/pyrogram>).
|
2019-05-13 15:15:00 +00:00
|
|
|
|
2022-01-07 09:18:51 +00:00
|
|
|
### Key Features
|
2019-05-13 15:15:00 +00:00
|
|
|
|
2022-01-07 09:18:51 +00:00
|
|
|
- **Ready**: Install Pyrogram with pip and start building your applications right away.
|
|
|
|
- **Easy**: Makes the Telegram API simple and intuitive, while still allowing advanced usages.
|
|
|
|
- **Elegant**: Low-level details are abstracted and re-presented in a more convenient way.
|
|
|
|
- **Fast**: Boosted up by [TgCrypto](https://github.com/pyrogram/tgcrypto), a high-performance crypto library written in pure C.
|
|
|
|
- **Type-hinted**: Types and methods are all type-hinted, enabling excellent editor support.
|
|
|
|
- **Async**: Fully asynchronous (also usable synchronously if wanted, for convenience).
|
|
|
|
- **Powerful**: Full access to Telegram's API to execute any official client action and more.
|
2019-05-13 15:15:00 +00:00
|
|
|
|
|
|
|
### Installing
|
|
|
|
|
|
|
|
``` bash
|
|
|
|
pip3 install pyrogram
|
|
|
|
```
|
|
|
|
|
|
|
|
### Resources
|
|
|
|
|
2022-01-07 09:18:51 +00:00
|
|
|
- Check out the docs at https://docs.pyrogram.org to learn more about Pyrogram, get started right
|
|
|
|
away and discover more in-depth material for building your client applications.
|
|
|
|
- Join the official channel at https://t.me/pyrogram and stay tuned for news, updates and announcements.
|