---
id: pyrofork
version: "2.3.69"
license: LGPL-3.0-or-later
license_treatment: copyleft
maintenance: active
---

# pyrofork — Fork of pyrogram. Elegant, modern and asynchronous Telegram MTProto API framework in Python for users and bots

License: copyleft · Maintenance: active · Downloads: 247.2K/mo

## 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 above — 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

pip install pyrofork
uv add pyrofork
poetry add pyrofork

## Installing 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_current
- Install friction: low
- Maintenance: active
- Downloads: 247.2K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

telegram bot framework python, mtproto api client, telegram user client library, async telegram messaging, telegram bot development, telegram api wrapper, telegram automation python, telegram-api, async-framework, mtproto

[View on SkillFed](https://skillfed.io/packages/pyrofork) · [View on PyPI](https://pypi.org/project/pyrofork/)