CuervoBot is a Bot that learns new commands as i get more things to study. Studying sometimes is boring. Coding is always fun (and a good excuse to not feel guilty about not studying).

It can set reminders, search series or movies for you, tell you if you should take the subway or not, and even help you solve system of linear equations!

First clone the project and install requirements.

$ git clone https://github.com/Ambro17/AmbroBot.git
$ cd AmbroBot
$ pip install -r requirements.txt

Then open telegram and chat @BotFather to get a bot token. Once you have it add PYTEL environment variable with the token. For example, if you use Linux with zsh shell you should add this line to the end of your ~/.zshrc file

export PYTEL=<BotToken>

If you are on windows you can do it with a GUI, or with powershell. See this link for instructions

Additional environment variables are needed for the bot to work properly.

TMDB_KEY # To access movies and series
DATABASE_URL # Database to persist information
CABA_SECRET # Transport updates
CABA_CLI_ID # Transport updates

Once you have all packages installed and all environment variables set you can run the bot with

$ python3 main.py

/serie Sherlock

/pelicula The Matrix 2

/yts

/subte

or if you want to receive updates without needing to ask every time.. /suscribe <line_letter>

/partido

Outputs San Lorenzo's next match

/dolar

Outputs USD->ARS exchange rates from different banks.

/remind <something>

Set reminders of todo tasks with recurrent notifications

/rofex

Outputs the rofex expected USD->ARS exchange rate in the following months

/posiciones

Outputs Liga Argentina standings

/subte

Outputs status of CABA subway lines.

/cartelera

Outputs the most popular movies available at the cinemas

/hoypido

Outputs hoypido food offers of the week

/pelicula <pelicula>

Outputs rating, description and imdb, yt and .torrent links to the requested movie.

/serie <serie>

Outputs all series episodes along with small description of the series.

/yts

Show latest movies added on yts.ag

/feriados

Show next feriados for Argentina

/aproximar

Determine solution of diagonally dominant system of linear equations via Jacobi or Gauss Seidel iterative methods

/suscribe <line>

Suscribe to the updates of the subway line <line> on CABA. You will receive notifications of delays, suspensions, service normalization, etc.

/yttomp3

Given a youtube url, download its audio in the best quality available. Useful if you want to make your own ringtones 🎶

/feedback

Give feedback for the bot. Bugs, feature requests, questions, ideas, nuclear secrets, conspiracy theories, or whatever you feel worth sharing with the dev.

Feedback was received from diffferent users that use AmbroBot source code to create nice keyboard layouts/more complex callback interactions. As a consecuence, i decided to leave master branch as is with no further changes as it uses the ptb api 'the right way'. Nevertheless, on style-improvements branch you can peek on a custom decorator that automagically adds handlers just by decorating handler functions avoiding boilerplate code. It's really handy!

Feel free to modify this code to suit your needs. If you get inspired by this bot please reference this repo as source of inspiration. ⭐️ Stars, 🐞 issues and 🔀 PRs are appreciated!