/j4nn0-b0t

Python Telegram BOT ables to store and retrive data from database (create, delete and read items from your personal list) and set alarms

Primary LanguagePythonGNU General Public License v3.0GPL-3.0

J4NN0 B0T

https://telegram.me/J4NN0_Bot https://pypi.org/project/python-telegram-bot/ https://www.gnu.org/licenses/lgpl-3.0.html

The BOT is hosted on Heroku and it has been tested using Python v3.9.7. Also, python-telegram-bot API and sqlite3 are needed.

J4NN0 BOT main features:

  1. Store and retrieve data from a database: you can save/delete/show items on your personal list.
  2. Set an alarm: when time is up the BOT will remind you what you asked for.

Check it out on telegram: @J4NN0_Bot

Demo

Watch the video

Table of Contents

Database

list.db

It is composed by a single table, REMINDERS:

  • CHATID: chat id for that user.
  • USRNAME: username of the user.
  • ITEM: the item added by the user.

Every time an user add/remove one or more item(s), these are added/removed to/from the db.

I also suggest you to download DB Browser for SQLite to easily manage (create, read, delete, modify, etc.) the database(s).

BOT usage

  • ⭕ Developer

    • /about: to see info about developer

  • 📝 List

    • /addtolist <item>: to add one or several items to your personal list.
    • /rmfromlist <item>: to remove one or several items from your personal list.
    • /show_list: it shows all items in your personal list.
    • /clear_list: to delete all items from your personal list.

  • 🔀 Random value

    • /random <number>: it will return a random number between 0 and .

  • ⏰ Alarm

    • /timer <seconds>: to set a timer and wait for your message.

  • 🤖 Info about bot

    • /help: to have info about all commands.

Easter egg

There are also a lot of Easter eggs (you can't find them in this code) that i wrote to have fun with my friends. Try to find them and enjoy!

How to host BOT on Heroku

  1. Register on Heroku.

  2. Download and install Heroku CLI and git.

  3. Create a project folder and put inside it the following files

    bot.py
Procfile
runtime.txt
requirements.txt

    You can also have a app.json schema in order to declare environment variables, add-ons, and other information required to run an app on Heroku. More info here.

  4. Put inside Procfile

    worker: python script.py

  5. Put the python version you want to use in runtime.txt.

    For instance, if you want to use Python v3.6.6 just put inside the file:

    python-3.6.6

  6. Specify explicit dependencies versions inside requirements.txt.

    For instance, I'm using python-telegram-bot API. So my file requirements.txt will look like

    python-telegram-bot==8.1.1

    To update this file, you can use the pip freeze command in your active virtual environment:

    pip freeze > requirements.txt

    More info here.

  7. At this stage, if you haven't already, log in to your Heroku account and follow the prompts to create a new SSH public key

    heroku login

  8. Create git repository

    git init

    or clone this repo

    git clone https://github.com/J4NN0/j4nn0-b0t.git

  9. Create heroku app

    heroku create

  10. Push your code (or deploy changes) into heroku app

    git add .
git commit -m 'message'
git push heroku master

  11. Run your worker

    heroku ps:scale worker=1

  12. Check logs with and enjoy your bot

    heroku logs --tail

Official Heroku Guide

Checkout also the offical heroku guide: Getting Started on Heroku with Python.

Resources