Thorin is a chat bot for telegram that makes is easy to add new commands. You can even add new commands while he's running!
Thorin will listen for all messages in a given chat (either directly with him or in a chat room which you invite him to) starting with "/".
All you have to do is create a new python script in commands/ that has a function called run which takes three arguments, the first argument is the id of the chat to reply to, the second is the name of the user to address when replying (I'm going to change this to message_id in the future so the bot can reply to that message) and the third is the incoming message text.
tl;dr: Look at one of the existing commands, you must have a run(chat_id, user, message) function.
Go to https://console.developers.google.com and create a Google App Engine project. Then take that project id (it will be two random words and a number eg. gorilla-something-374635) and your Telegram Bot ID which the Bot Father gave you and do the following:
- Copy app.yaml.template and rename the copy to to app.yaml.
- Update {GOOGLE APP ENGINE PROJECT ID} in app.yaml.
- Copy keys.ini.template and rename the copy to keys.ini.
- Update {Your Telegram Bot ID here} in keys.ini OPTIONAL:
- Update the rest of keys.ini with keys for each command you want to use.
git clone (url for your thorin fork) ~/bot
cd ~/bot
(PATH TO PYTHON27 INSTALL)\scripts\pip.exe install -t lib python-telegram-bot bs4 xmltodict six soundcloud feedparser requests tungsten mcstatus google-api-python-client
(PATH TO GOOGLE APP ENGINE LAUNCHER INSTALL)appcfg.py -A {GOOGLE APP ENGINE PROJECT ID} update .In lib\SoundCloud\Client.py set enable_ssl = False (Unsupported by Google App Engine) oh ja, /launch command needs a module called "dateutil" clone from https://github.com/dateutil/dateutil and copy the folder "dateutil" into lib.
Finally go to https://{GOOGLE APP ENGINE PROJECT ID}.appspot.com/set_webhook?url=https://{GOOGLE APP ENGINE PROJECT ID}.appspot.com/webhook (replace both {GOOGLE APP ENGINE PROJECT ID}s with the Google App Engine Project ID) to tell Telegram where to send web hooks. This is all that is required to setup web hooks, you do not need to tell the Bot Father anything about web hooks.
I'm an alpha nerd and play Dungeons and Dragons, currently I'm playing a Dwarf Tempest Cleric in 5th edition named Thorin. I love Thorin and his name so that's how I named the bot.
I love getting contributions, well I haven't gotten any yet but I'm sure that I'll love it!
The only thing I ask that if adding a new command that you include a description of it and how to configure it in the PR (using a module with it's on README would be da bomb, I'm working on this for my own commands now.) If you have an idea for a command or how we can add multiple backends to Thorin let me know via a Github Issue! I'd love to use Thorin on other chat services.
Thorin is distributed under the Apache 2.0 License