Quick Start#

The next few steps serve as a quick start to see Pyrogram in action as fast as possible.

Get Pyrogram Real Fast#

Cloud Credits

If you need a cloud server to host your applications, try Hetzner Cloud. You can sign up with this link to get €20 in cloud credits.

  1. Install Pyrogram with pip3 install -U pyrogram.

  2. Obtain the API key by following Telegram’s instructions and rules at https://core.telegram.org/api/obtaining_api_id.


    Make sure you understand and abide to the rules for third-party clients and libraries explained in the link above.

  3. Open the text editor of your choice and paste the following:

    import asyncio
    from pyrogram import Client
    api_id = 12345
    api_hash = "0123456789abcdef0123456789abcdef"
    async def main():
        async with Client("my_account", api_id, api_hash) as app:
            await app.send_message("me", "Greetings from **Pyrogram**!")
  4. Replace api_id and api_hash values with your own.

  5. Save the file as hello.py.

  6. Run the script with python3 hello.py

  7. Follow the instructions on your terminal to login.

  8. Watch Pyrogram send a message to yourself.

Enjoy the API#

That was just a quick overview. In the next few pages of the introduction, we’ll take a much more in-depth look of what we have just done above.

If you are feeling eager to continue you can take a shortcut to Invoking Methods and come back later to learn some more details.