Welcome to Hydrogram

Hydrogram

Python Framework for the Telegram MTProto API
Homepage • Development • Releases • News

from hydrogram import Client, filters

app = Client("my_account")


@app.on_message(filters.private)
async def hello(client, message):
    await message.reply("Hello from Hydrogram!")


app.run()

Hydrogram is a Python library for interacting with the Telegram MTProto API. It provides a simple and intuitive interface for developers to leverage the power of Telegram’s API in their Python applications.

Support

Hydrogram is an open source project. Your support helps us maintain and improve the library. You can support the development of Hydrogram through the following platforms:

• LiberaPay.

• OpenCollective.

How the Documentation is Organized

Contents are organized into sections composed of self-contained topics which can be all accessed from the sidebar, or by following them in order using the Next button at the end of each page. You can also switch to Dark or Light theme or leave on Auto (follows system preferences) by using the dedicated button in the top left corner.

Here below you can, instead, find a list of the most relevant pages for a quick access.

First Steps

Migration Guide: Migration guide from Pyrogram. Quick Start: Overview to get you started quickly. Invoking Methods: How to call Hydrogram’s methods. Handling Updates: How to handle Telegram updates. Error Handling: How to handle API errors correctly.

API Reference

Hydrogram Client: Reference details about the Client class. Available Methods: List of available high-level methods. Available Types: List of available high-level types. Enumerations: List of available enumerations. Bound Methods: List of convenient bound methods.

Meta

Hydrogram FAQ: Answers to common Hydrogram questions. Support Hydrogram: Ways to show your appreciation. Release Notes: Release notes for Hydrogram releases. Hydrogram vs Pyrogram: Comparison between Hydrogram and Pyrogram.