Just focus on your bots.
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
botogram Changed old years text to 2018 Aug 20, 2018
docs Changed old years text to 2018 Aug 20, 2018
i18n Changed old years text to 2018 Aug 20, 2018
tests Changed old years text to 2018 Aug 20, 2018
website Changed old years text to 2018 Aug 20, 2018
.gitattributes And ignore also this from GitHub language stats Jul 18, 2015
.gitignore Fix the i18n mess Dec 1, 2015
.travis.yml Replace the makefile with invoke Dec 1, 2015
AUTHORS Update authors Jun 13, 2018
LICENSE Changed old years text to 2018 Aug 20, 2018
MANIFEST.in Added support for internationalization Aug 1, 2015
README.md Replace botogram.pietroalbini.io with botogram.pietroalbini.org Oct 15, 2017
requirements-build.in Use pip-tools to manage development dependencies Feb 28, 2016
requirements-build.txt Update pinned development dependencies Jun 10, 2016
requirements-docs.in Use pip-tools to manage development dependencies Feb 28, 2016
requirements-docs.txt Update pinned development dependencies Jun 10, 2016
requirements-lint.in Use pip-tools to manage development dependencies Feb 28, 2016
requirements-lint.txt Update development dependencies Feb 28, 2016
requirements-test.in Use pip-tools to manage development dependencies Feb 28, 2016
requirements-test.txt Update pinned development dependencies Jun 10, 2016
requirements-tools.in Use pip-tools to manage development dependencies Feb 28, 2016
requirements-tools.txt Update pinned development dependencies Jun 10, 2016
setup.py Update authors Jun 13, 2018
tasks.py Changed old years text to 2018 Aug 20, 2018

README.md

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")

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

if __name__ == "__main__":
    bot.run()

You can find the documentation at botogram.pietroalbini.org. 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, 3.5
License: MIT

Installation

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

$ python3 -m pip install botogram

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 https://github.com/pietroalbini/botogram.git
$ 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.