J4NN0 B0T

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

Table of Contents

• Database
• BOT usage
• How to host BOT on Heroku
• Resources

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

• First steps
• Telegram Bot’s documentation
• Telegram Bot API
• Code snippets