Skip to main content

Python Telegram Bots made easy

Project description

Pytbo is a module aimed at simplifying the creation of Telegram Bots using Python.

A minimum familiarity with Telegram Bots is required to use this library. Please take a look at the introduction and the FAQ before starting.

Getting Started

To start working with Pytbo, you must have a Bot token. If you don’t know what we’re talking about, read how to create your first bot with BotFather.

This is a simple _echo_ bot done with Pytbo that looks for updates every 5 seconds.

import pytbo
import time

# Bot Token received from Telegram
# Polling interval in seconds

# Create bot object
bot = pytbo.BareBot(BOT_TOKEN)
# Print bot information
print("Bot ID......: %s" % (
print("Bot username: %s" % (bot.username))

# Initialize offset
offset = 0
# Infinite polling loop
while True:
    # Look for updates
    updates = bot.getUpdates(offset)
    # Handle them
    for u in updates:
        if u.message:
            if u.message.text:
                # If the update contains a message
                # that contains text, we reply to the
                # sender with the same text.
        # Update offset to avoid receiving
        # the same update again
        offset = u.update_id + 1
    # Sleep


To install Pytbo, simply:

$ pip install pytbo


A proper documentation is not yet available, but it will be. However, useful methods and classes are documented inside the source code.

Don’t be afraid to have a look inside, sometimes is the best way to learn.

How to Contribute

  1. Fork this repository on GitHub to start making your changes to the master branch (or branch off of it).

  2. Send a pull request.


Thanks to Kenneth Reitz and to all the other developers of the requests module, which is used inside Pytbo and also as a blueprint for this repository and documentation layout.

Release History

0.1.0 (2016-04-23)

  • BareBot class that wraps Telegram Bot APIs methods

  • Types classes that wraps Telegram Bot APIs types

0.0.1 (2016-04-14)

  • Conception

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pytbo-0.1.0.tar.gz (16.7 kB view hashes)

Uploaded source

Built Distribution

pytbo-0.1.0-py2.py3-none-any.whl (19.9 kB view hashes)

Uploaded py2 py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page