skillfed

pyrofork

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

pyrofork v2.3.69 247.2K downloads/30d#8,696 on PyPI292
Copyleft license LGPL-3.0-or-later Active released

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 pyrofork

uv

uv add pyrofork

poetry

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 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

Development Status :: 5 - Production/StableIntended Audience :: DevelopersLicense :: OSI Approved :: GNU Lesser General Public License v3 (LGPLv3)Natural Language :: EnglishOperating System :: OS IndependentProgramming Language :: PythonProgramming Language :: Python :: 3Programming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.14Programming Language :: Python :: ImplementationProgramming Language :: Python :: Implementation :: CPythonProgramming Language :: Python :: Implementation :: PyPyTopic :: CommunicationsTopic :: Communications :: ChatTopic :: InternetTopic :: Software Development :: LibrariesTopic :: Software Development :: Libraries :: Application FrameworksTopic :: Software Development :: Libraries :: Python Modules

Tags

telegram bot framework pythonmtproto api clienttelegram user client libraryasync telegram messagingtelegram bot developmenttelegram api wrappertelegram automation python
telegram-apiasync-frameworkmtproto

More Libraries packages