Skip to content

WalletBuddy is an easy-to-use Telegram Bot that assists you in recording your daily expenses on a local system without any hassle.

License

Notifications You must be signed in to change notification settings

smanishs175/WalletBuddy

 
 

Repository files navigation

WalletBuddy

MIT License Python 3.8 GitHub repo size GitHub GitHub contributors DOI Platform Build Status


About WalletBuddy

WalletBuddy is an easy-to-use Telegram Bot that assists you in recording your daily expenses on a local system without any hassle.
With simple commands, this bot allows you to:

  • Add/Record a new spending
  • Add shared expenses with friends
  • Show the sum of your expenditure for the current day/month
  • Display your spendings plot : All expenses, Category expenses, Group Expenses
  • Clear/Erase all your records

Previous version (old video)

old.mp4

Updated version (new video)

Untitled.1.mp4

Installation guide

The below instructions can be followed in order to set-up this bot at your end in a span of few minutes! Let's get started:

  1. Set up your own server for deployment.

  2. This installation guide assumes that you have already installed Python (Python3 would be preferred) and setup your own server.

  3. Install git and add your account details using terminal.

  4. Clone this repository to your local system at a suitable directory/location of your choice

  5. Start a terminal session, and navigate to the directory where the repo has been cloned

  6. Run the following command to install the required dependencies:

  pip3 install -r requirements.txt
  1. Download and install the Telegram desktop application for your system from the following site: https://desktop.telegram.org/

  2. Once you login to your Telegram account, search for "BotFather" in Telegram. Click on "Start" --> enter the following command:

  /newbot
  1. Follow the instructions on screen and choose a name for your bot. Post this, select a username for your bot that ends with "bot" (as per the instructions on your Telegram screen)

  2. BotFather will now confirm the creation of your bot and provide a TOKEN to access the HTTP API - copy this token for future use.

  3. Paste the token copied in step 8 in the config.ini file under settings in ApiToken variable.

  4. In the Telegram app, search for your newly created bot by entering the username and open the same. Once this is done, go back to the terminal session. Navigate to the directory containing the "main" folder inside your application code:

  run python3 main/main py
  1. A successful run will generate a message on your terminal that says "TeleBot: Started polling."

  2. Post this, navigate to your bot on Telegram, enter the "/start" or "/menu" command, and you are all set to track your expenses!

Running publicly available bot:

If you want to run publicly hosted bot then got to :

  https://t.me/niharrao_bot

send message to the bot named "sebot" and start managing your expanses using different functionalities.


--------------------------------------------------------------------------------------------------

Title:'WalletBuddy'

Version: '1.0'

Description: 'A one-stop solution to track your expenses with your friends'

Authors:'Nihar, Shruti, Palash, Saksham, Manish'

--------------------------------------------------------------------------------------------------

About

WalletBuddy is an easy-to-use Telegram Bot that assists you in recording your daily expenses on a local system without any hassle.

Resources

License

Code of conduct

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Python 100.0%