Quick Start

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

Get Hydrogram Real Fast

  1. Install Hydrogram with pip3 install -U hydrogram.

  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.

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

    import asyncio
    from hydrogram 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 **Hydrogram**!")
  2. Replace api_id and api_hash values with your own.

  3. Save the file as hello.py.

  4. Run the script with python3 hello.py

  5. Follow the instructions on your terminal to login.

  6. Watch Hydrogram 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.