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 as extra requirement (recommended):

    $ pip3 install -U hydrogram tgcrypto

Bleeding Edge

You can install the development version from the git dev branch using this command:

$ pip3 install -U


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__