Install Guide

Being a modern Python framework, Hydrogram requires an up to date version of Python to be installed in your system. We recommend using the latest versions of both Python 3 and pip.


Install Hydrogram

  • The easiest way to install and upgrade Hydrogram to its latest stable version is by using pip:

    $ pip3 install -U hydrogram
    
  • or, with TgCrypto and uvloop as extra requirements (recommended for better performance):

    $ pip3 install -U "hydrogram[fast]"
    

Bleeding Edge

The development version from the git dev branch contains the latest features and fixes, but it may also include unfinished changes, bugs, or unstable code. Using this version can lead to unexpected behavior, or compatibility issues. It is recommended only for advanced users who want to test new features and are comfortable troubleshooting problems.

You can install the development version using this command:

$ pip3 install -U https://github.com/hydrogram/hydrogram/archive/dev.zip

Verifying

To verify that Hydrogram is correctly installed, open a Python shell and import it. If no error shows up you are good to go.

>>> import hydrogram
>>> hydrogram.__version__
'x.y.z'