nealetham / split-later-telegram

I'm SplitLaterBot, here to help calculate who you should pay after a group evening out!

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Introduction

This creation of this Telegram bot was motivated after attending several outings which resulted in payment confusion amongst the group.

The bot features a number of commands to aid in settling debts. All expenses added into the receipt is assumed to be split evenly amongst members included. But special expenses meant to be split amongst a subgroup can be specified as well!

The bot can be used in a private conversation, or added into a group!

Note

The Telegram bot is not currently being hosted, you may refer to the instructions below to test, or host it on your own!

Installing (Dev)

To begin, you'll need an Access Token. To generate an Access Token, you have to talk to @BotFather and follow a few simple steps (described here).

You can install the Telegram bot via

$ git clone https://github.com/nealetham/split-later.git
$ cd split-later
$ pip install requirements.txt

Open up the .env file, and replace <BOT_TOKEN> with your own Access Token.

To start the bot, just run

$ python bot.py

You may now interact with the bot on Telegram!

Hosting

In the other branch of the repository, the bot.py has been edited with the sole purpose of hosting on AWS Lambda.

References - Hosting on AWS Lambda, Lambda Integration

About

I'm SplitLaterBot, here to help calculate who you should pay after a group evening out!


Languages

Language:Python 96.4%Language:Dockerfile 3.6%