Skip to content
A customizable Telegram shop bot
Branch: master
Clone or download
Type Name Latest commit message Commit time
Failed to load latest commit information.
.gitignore Add transaction file Apr 19, 2018 Add May 3, 2018
LICENSE.txt Rename LICENSE May 3, 2018 Added possible fix to a common problem Sep 24, 2018 Don't crash if config.ini does not exist Sep 2, 2019 Small generic improvements May 30, 2018
requirements.txt Create requirements and update README May 3, 2018 Fixed typo Jul 1, 2018 Display the full error in debug mode Sep 18, 2018 Another bug fixed Jun 10, 2018


A customizable Telegram shop bot, developed as a project for the final exam.


  • Python 3.6 (or higher)
  • The packages specified in requirements.txt (install with pip install -r requirements.txt)
  • An Internet connection
  • A Telegram bot token (obtainable at @Botfather)
  • A payment provider token (obtainable by connecting a provider with your bot)
  • Optional: a token


  1. Download the project files through git clone or this link.
  2. Install the project requirements with pip install -r requirements.txt
  3. Run python -OO to generate the configuration file.
  4. Open the config folder and edit the config.ini file following the contained instructions.
    Ensure the is_template field is set to no.
  5. Run python -OO to generate the database tables.
  6. Optional: customize the file
  7. Run python -OO again to run the bot.
  8. Open Telegram, and send a /start command to your bot to be promoted to administrator.


All the bot features are available through Telegram.
As the administrator, you can add new products, check the placed orders, create new transactions and generate .csv log files.
Users will be able to add credit to their wallet, place orders and contact you in case they require assistance.

You can’t perform that action at this time.