Being a Python library, Pyrogram requires Python to be installed in your system. We recommend using the latest version of Python 3 and pip.

Get Python 3 from https://www.python.org/downloads/ (or with your package manager) and pip by following the instructions at https://pip.pypa.io/en/latest/installing/.

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

  $ pip3 install -U pyrogram
  

• or, with TgCrypto as extra requirement (recommended):

  $ pip3 install -U pyrogram[fast]
  

If you want the latest development version of Pyrogram, you can install it straight from the develop branch using this command (note "develop.zip" in the link):

$ pip3 install -U https://github.com/pyrogram/pyrogram/archive/develop.zip

Pyrogram heavily depends on IO-bound network code (it's a cloud-based messaging client library after all), and here's where asyncio shines the most by providing extra performance while running on a single OS-level thread only.

A fully asynchronous variant of Pyrogram is therefore available (Python 3.5+ required). Use this command to install (note "asyncio.zip" in the link):

$ pip3 install -U https://github.com/pyrogram/pyrogram/archive/asyncio.zip

Pyrogram API remains the same and features are kept up to date from the non-async, default develop branch, but you are obviously required Python asyncio knowledge in order to take full advantage of it.

.. centered:: Subscribe to `@Pyrogram <https://t.me/Pyrogram>`_ for news and announcements

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

>>> import pyrogram
>>> pyrogram.__version__
'0.10.3'