CloudBot/README.md

CloudBot/DEV

About

CloudBot is a Python IRC bot based on Skybot by rmmh.

Goals

• Easy to use wrapper
• Intuitive configuration
• Fully controlled from IRC
• Fully compatable with existing skybot plugins
• Easily extendable
  • Thorough documentation
  • Cross-platform
• Muti-threaded, efficient
  • Automatic reloading
  • Little boilerplate

Getting and using CloudBot

Download

Get CloudBot at https://github.com/ClouDev/CloudBot/zipball/develop.

Unzip the resulting file, and continue to read this document.

Install

Install required Linux packages (check bottom)

Before you can run the bot, you need to install a few Python dependencies. These can be installed with pip (The Python package manager):

[sudo] pip install -r requirements.txt

How to install pip

curl -O http://python-distribute.org/distribute_setup.py # or download with your browser on windows
python distribute_setup.py
easy_install pip

Run

Once you have installed the required dependencies, you can run the bot!

python bot.py

On Windows you can usually just double-click the bot.py file to start the bot, as long as you have Python installed correctly.

Getting help with CloudBot

Documentation

To configure your CloudBot, visit the Config Wiki Page.

To write your own plugins, visit the Plugin Wiki Page.

More at the Wiki Main Page.

Support

The developers reside in #CloudBot on EsperNet and would be glad to help you.

If you think you have found a bug/have a idea/suggestion, please open a issue here on Github.

Requirements

Linux packages needed for install: python, python-dev, libenchant-dev, libenchant1c2a, libxslt-dev, libxml2-dev.

CloudBot runs on Python 2.7.x. It is developed on Ubuntu 12.04 with Python 2.7.3.

It requires the Python module lXML, and Enchant is needed for the spellcheck plugin. It also requires pydns and beautifulsoup4 and is needed for SRV record lookup for the mctools plugin.

Windows users: Windows compatibility some plugins is broken (such as ping), but we do intend to add it.³

Example CloudBots

The developers of CloudBot run two CloudBots on Espernet.

They can both be found in #CloudBot.

mau5bot is the semi-stable bot, and runs on the latest stable development version of CloudBot. (mau5bot is running on Ubuntu Server 12.04 with Python 2.7.3)

License

CloudBot is licensed under the GPL v3 license. The terms are as follows.

CloudBot/DEV

Copyright © 2011-2013 Luke Rogers / ClouDev - <[cloudev.github.com](http://cloudev.github.com)>

CloudBot is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

CloudBot is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with CloudBot.  If not, see <http://www.gnu.org/licenses/>.

Notes

³ eventually