pyrofork
Fork of pyrogram. Elegant, modern and asynchronous Telegram MTProto API framework in Python for users and bots
What it is and what it does
Pyrofork is a fork providing a modern, asynchronous interface to Telegram's MTProto API. It abstracts low-level protocol details and presents them through Python patterns, making it straightforward to build Telegram bots and user clients without deep protocol knowledge. The framework handles authentication, message routing, event dispatching, and cryptography transparently.
The package depends on pyaes for AES encryption, pymediainfo-pyrofork for media metadata extraction, and pysocks for proxy support. It supports Python 3.10 through 3.14 and is marked production-stable. The framework is fully asynchronous but can also be used synchronously for convenience, and it provides type hints throughout for editor support.
Use it for:
- Build a Telegram bot that responds to messages and manages user interactions without using the Bot API.
- Create a user client that automates personal Telegram account tasks like message forwarding or bulk operations.
- Develop a Telegram notification service that sends alerts or updates to channels or groups programmatically.
- Implement a Telegram bridge or relay that connects Telegram to other messaging platforms or services.
- Build interactive Telegram applications that leverage the full MTProto API for features beyond standard bot capabilities.
Worth the install?
AI-flagged interpretation of the facts on this page — verify before relying
Pyrofork is an asynchronous Python framework for interacting with Telegram's MTProto API, enabling you to build user clients and bots that send messages, handle events, and execute Telegram actions programmatically.
Yes, if you need to build Telegram bots or user clients in Python. Pyrofork is actively maintained, production-stable, has low install friction, and carries no known security vulnerabilities. The LGPL-3.0-or-later license is permissive for most use cases but requires source availability if you distribute modifications. The 247-day gap since the last release is notable but not alarming given recent commit activity.
Install
pyrofork on PyPI
pip
pip install pyroforkuv
uv add pyroforkpoetry
poetry add pyroforkInstalling pyrofork
Before you install
Low install friction with a pure-Python wheel distribution. The package is actively maintained with a recent commit on 2026-07-01 and carries production-stable status, though it has been 247 days since the last release.
License in practice
Pyrofork is licensed under LGPL-3.0-or-later (copyleft). You may use and modify it freely, but any distributed modifications must remain under the same license and include source code availability.
Quickstart
pip install pyrofork
from pyrofork import Client
app = Client("my_account")
app.run()
Requires Python 3.10 or later. Telegram account credentials and network access to Telegram servers are needed to authenticate and use the API.
Verify before relying
- Whether the C-based cryptography library mentioned in the description is bundled or requires separate installation.
- Performance characteristics and rate-limiting behavior when handling high-volume message operations.
- Stability guarantees for the fork relative to the original project.
Package facts
| License | LGPL-3.0-or-later (copyleft) |
| Python support | supports the current Python release (~=3.10) |
| Install friction | low — pure-Python wheel |
| Runtime dependencies | 3 — pyaes, pymediainfo-pyrofork, pysocks |
| Maintenance | actively maintained — 247 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 247,237/month — #8,696 on PyPI (30-day window, as of 2026-08-14) |
| Known vulnerabilities | none known (OSV.dev, checked 2026-08-14) |
Evidence: pyrofork-2.3.69-py3-none-any.whl
Keywords: telegram, chat, messenger, mtproto, api, client, library, python
Tags
More Libraries packages
urllib3 is an HTTP client library that provides…
permissive · top 100 on PyPI
requestsRequests is a Python HTTP library that…
permissive · top 100 on PyPI
pluggyPluggy provides a plugin system that lets you…
permissive · top 100 on PyPI
python-dateutilProvides parsing, arithmetic, and recurrence…
permissive · top 100 on PyPI
sixSix provides utility functions to write Python…
permissive · top 100 on PyPI
pytestpytest is a testing framework that lets you…
permissive · top 100 on PyPI
PyrogramPyrogram is an asynchronous Python framework…
copyleft · top 15,000 on PyPI
TelethonTelethon is an asyncio-based Python library…
permissive · top 5,000 on PyPI
KurigramKurigram is an asynchronous Python framework…
copyleft · top 15,000 on PyPI
telebotA Telegram bot library with route-based message…
permissive · top 15,000 on PyPI
rlbotRLBot is a framework for writing Python bots…
permissive · top 15,000 on PyPI
python-telegram-botProvides a pure Python asynchronous interface…
copyleft · top 1,000 on PyPI
pyTelegramBotAPIA Python library that wraps the Telegram Bot…
copyleft · top 5,000 on PyPI
pytgcallsEnables Python bots to join Telegram voice…
copyleft · top 5,000 on PyPI
apache-airflow-providers-telegramIntegrates Apache Airflow with Telegram to send…
permissive · top 15,000 on PyPI
nonebot2NoneBot2 is an asynchronous Python framework…
permissive · top 15,000 on PyPI