• Python 3.2 or higher
• BeautifulSoup 4
• Lxml or html5lib
• python-dateutil
• pystemmer (for Cobe)
• python3-selenium and phantomjs (for fmi.py)

Debian based distros:

• apt-get install python3 python3-dateutil python3-stemmer python3-lxml python3-bs4 python3-selenium

In a case where you dont have the system administrators rights you may use easy install for these plugins for example:

• easy_install3 --user pystemmer
• easy_install3 --user python-dateutil

-- ###Running the bot###

• Unpack the source code to the destination of your choice

1. Modify the config.py file to meet your needs
2. Run the bot with command ./pyBotDaemon.sh on unix based system (cygwin on windows)
   • Or run python3 pyBot.py

-- ###Something about modules###

• Some of the modules (the most of them) are designed to meet our own needs (as we use the bot as well), so in some cases the language might be in finnish. modules/fmi.py as in this particular case.

• Cobe plugin is written in python 2.x by [Peter Teichman] (https://github.com/pteichman/cobe), but we have modified it to run smoothly also on python 3.x

• Callable modules below: * !automodes set <nick> <flag> (current flags are ao/av) * !automodes me !automodes reset <nick> * !clock current time * !conv <amount> <unit> | !conv units * !currency <amount> <from> <to> * !fap for random porn * !fmi set <city> saves preferred city, now you can call !fmi or !fmi <city> * !geo <ip/host> tells the physical location of the switch * !git lets you pull the latest update from our git branch * !google <search term> * !google next for the next result * !gt <from> <to> <word/sentence> (google translate) * !isup <http://domain.com> * !op(op for operators) * !seen <nick> * !stats <nick/word> * !sysinfo * !tell <nick> <message> (check config for options for this module) * !version * !wiki <lang> <search term> - e.g. !wiki en finland * !wiki next for the next result * !ylilauta random post from ylilauta * !youtube <search term> * !youtube next for the next result * !game to play the slotmachine game

-- ###About the pyBot project###

• All the development is done on Linux and OS X. We don't officially support Windows, but the bot should run just fine :)

• Feel free to dig in the code, use the bot, write your own modules as you desire or get in touch with us if you want to contribute to this project

• Now as im writing this, we are about to launch pyBot version 1.0 and planning to continue the development further forward. Our goal is to improve our skills related to python and over all coding :)

• We have been working on with this while keeping in our minds that someday this would have a multi chan support. Some of the features are KINDA supporting it, but in the long run it is still far far away from it.

• So for now the preferred way of using it, would be on a single channel. Some of the features interracts with each other causing confusion within the bot. But we are looking into that.