https://github.com/TelegramPlayGround/pyrogram
PyroGram (https://github.com/pyrogram/pyrogram) FORK | Telegram MTProto API framework in Python for users and bots
https://github.com/TelegramPlayGround/pyrogram
bot-api hacktoberfest mtproto pyrogram pyrotgfork python python3 telegram telegram-api
Last synced: 4 months ago
JSON representation
PyroGram (https://github.com/pyrogram/pyrogram) FORK | Telegram MTProto API framework in Python for users and bots
- Host: GitHub
- URL: https://github.com/TelegramPlayGround/pyrogram
- Owner: TelegramPlayground
- License: lgpl-3.0
- Created: 2022-01-21T16:30:05.000Z (almost 4 years ago)
- Default Branch: dev
- Last Pushed: 2025-08-27T13:40:32.000Z (4 months ago)
- Last Synced: 2025-08-27T22:45:02.935Z (4 months ago)
- Topics: bot-api, hacktoberfest, mtproto, pyrogram, pyrotgfork, python, python3, telegram, telegram-api
- Language: Python
- Homepage: https://telegramplayground.github.io/pyrogram/
- Size: 70.4 MB
- Stars: 153
- Watchers: 1
- Forks: 38
- Open Issues: 34
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: COPYING
Awesome Lists containing this project
README
Telegram MTProto API Framework for Python
Documentation
•
Releases
•
News
## Pyrogram
> Elegant, modern and asynchronous Telegram MTProto API framework in Python for users and bots
``` python
from pyrogram import Client, filters
app = Client("my_account")
@app.on_message(filters.private)
async def hello(client, message):
await message.reply("Hello from Pyrogram!")
app.run()
```
**Pyrogram** is a modern, elegant and asynchronous [MTProto API](https://telegramplayground.github.io/pyrogram/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.
### Key Features
- **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/TelegramPlayGround/pyrogram-tgcrypto), a high-performance cryptography library written in 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.
### Installing
``` bash
pip3 install pyrotgfork
```
### Resources
- Check out [the docs](https://telegramplayground.github.io/pyrogram) 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 [PyroTGFork](https://PyroTGFork.t.me/2) and stay tuned for news, updates and announcements.