Telegram MTProto API Framework for Python
GitHub • Community • Changelog • PyPI

from pyrogram import Client, Filters

app = Client("my_account")


@app.on_message(Filters.private)
def hello(client, message):
    message.reply("Hello {}".format(message.from_user.first_name))


app.run()

Pyrogram is an elegant, easy-to-use Telegram client library and framework written from the ground up in Python and C. It enables you to easily create custom apps using both user and bot identities (bot API alternative) via the MTProto API.

Contents are organized into self-contained topics and can be accessed from the sidebar, or by following them in order using the Next button at the end of each page.

• Quick Start - Concise steps to get you started as fast as possible.
• API Usage - Guide on how to use Pyrogram's API.
• Update Handling - Guide on how to handle Telegram updates.
• Client - Reference details about the Client class.
• Types - All the available Pyrogram types.
• Methods - All the available Pyrogram methods.

To get started, press the Next button

.. toctree::
    :hidden:
    :caption: Introduction

    intro/start
    intro/install
    intro/setup
    intro/auth

.. toctree::
    :hidden:
    :caption: Topic Guides

    topics/usage
    topics/update-handling
    topics/using-filters
    topics/more-on-updates
    topics/configuration-file
    topics/smart-plugins
    topics/auto-authorization
    topics/customize-sessions
    topics/tgcrypto
    topics/text-formatting
    topics/socks5-proxy
    topics/bots-interaction
    topics/error-handling
    topics/test-servers
    topics/advanced-usage
    topics/voice-calls
    topics/changelog

.. toctree::
    :hidden:
    :caption: API Reference

    core/client
    core/types
    core/methods
    core/handlers
    core/decorators
    core/filters
    core/errors

.. toctree::
    :hidden:
    :caption: Telegram API

    functions/index
    types/index