steffo/greed
steffo/greed
1
Fork 0
mirror of https://github.com/Steffo99/greed.git synced 2024-10-16 13:47:27 +00:00
Code Activity
Customizable, multilanguage Telegram shop bot with Payments support
111 commits 13 branches 4 tags 1,008 KiB
Python 99.6%
Dockerfile 0.4%
Find a file
Darren 7d4d5f966e Add English translations en_US
2020-02-04 15:14:04 +02:00
config Add language switcher 2020-02-04 15:13:14 +02:00
strings Add English translations en_US 2020-02-04 15:14:04 +02:00
.gitignore Add transaction file 2018-04-19 09:37:42 +02:00
configloader.py Don't crash if config.ini does not exist 2019-09-02 16:05:37 +02:00
CONTRIBUTING.md Add CONTRIBUTING.md 2018-05-03 09:00:58 +02:00
core.py Add language switcher 2020-02-04 15:13:14 +02:00
database.py Add language switcher 2020-02-04 15:13:14 +02:00
LICENSE.txt Rename LICENSE 2018-05-03 08:51:44 +02:00
README.md Update README.md 2019-10-20 19:14:14 +02:00
requirements.txt Create requirements and update README 2018-05-03 08:48:31 +02:00
utils.py Add language switcher 2020-02-04 15:13:14 +02:00
worker.py Add language switcher 2020-02-04 15:13:14 +02:00

README.md

greed

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

Requirements

  • 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 sentry.io token

Installation

  1. Download the project files through git clone https://github.com/Steffo99/greed.git or this link.
  2. Install the project requirements with pip install -r requirements.txt
  3. Run python -OO core.py 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 database.py to generate the database tables.
  6. Optional: customize the strings.py file
  7. Run python -OO core.py again to run the bot.
  8. Open Telegram, and send a /start command to your bot to be promoted to administrator.

Usage

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.

Documentation

greed currently does not have a documentation page, but you can try to read the paper (in Italian) I wrote for my final Scuola Superiore exam about it.