Skip to content


Repository files navigation

botogram Build Status News channel

Just focus on your bots.

botogram is a Python framework, which allows you to focus just on creating your Telegram bots, without worrying about the underlying Bots API.

While most of the libraries for Telegram out there just wrap the Bots API, botogram focuses heavily on the development experience, aiming to provide you the best API possible. Most of the Telegram implementation details are managed by botogram, so you can just focus on your bot.

import botogram
bot = botogram.create("YOUR-API-KEY")

def hello_command(chat, message, args):
    """Say hello to the world!"""
    chat.send("Hello world")

if __name__ == "__main__":

You can find the documentation at Also, you can get all the news about botogram in its Telegram channel.

Please note botogram currently doesn't support some of the upstream API features. All of them will be implemented in botogram 1.0

Supported Python versions: 3.4+ License: MIT


You can install easily botogram with pip (be sure to have Python 3.4 or higher installed):

$ python3 -m pip install botogram2

If you want to install from the source code, you can clone the repository and install it with setuptools. Be sure to have Python 3.4 (or a newer version), pip, virtualenv, setuptools and invoke installed:

$ git clone
$ cd botogram
$ invoke install

On some Linux systems you might need to wrap the invoke install command with sudo, if you don't have root privileges.