Installation Guide

Using PIP

$ pip install -U aiogram

Using Pipenv

$ pipenv install aiogram

Using Pacman

aiogram is also available in Arch Linux Repository, so you can install this framework on any Arch-based distribution like Arch Linux, Antergos, Manjaro, etc. To do this, just use pacman to install the python-aiogram package:

$ pacman -S python-aiogram

From sources

Development versions:

$ git clone https://github.com/aiogram/aiogram.git
$ cd aiogram
$ python setup.py install

Or if you want to install stable version (The same with version from PyPi):

$ git clone https://github.com/aiogram/aiogram.git
$ cd aiogram
$ git checkout master
$ python setup.py install

Recommendations

You can speedup your bots by following next instructions:

  • Use uvloop instead of default asyncio loop.

    uvloop is a fast, drop-in replacement of the built-in asyncio event loop. uvloop is implemented in Cython and uses libuv under the hood.

    Installation:

    $ pip install uvloop
    
  • Use ujson instead of the default json module.

    UltraJSON is an ultra fast JSON encoder and decoder written in pure C with bindings for Python 2.5+ and 3.

    Installation:

    $ pip install ujson
    
  • Use aiohttp speedups

    • Use cchardet instead of the chardet module.

      cChardet is a high speed universal character encoding detector.

      Installation:

      $ pip install cchardet
      
    • Use aiodns for speeding up DNS resolving.

      aiodns provides a simple way for doing asynchronous DNS resolutions.

      Installation:

      $ pip install aiodns
      
    • Installing speedups altogether.

      The following will get you aiohttp along with cchardet, aiodns and brotlipy in one bundle.

      Installation:

      $ pip install aiohttp[speedups]
      

In addition, you don’t need do anything, aiogram automatically starts using that if it is found in your environment.