Important: This repository is a legacy version of Cloudbot, whereas the Refresh version of CloudBot is a newer version, which runs on Python 3.4. This version is discontinued and no longer maintained by the core team, so we suggest you update to CloudBotRefresh.
Getting and using CloudBot
Get CloudBot at https://github.com/ClouDev/CloudBot/zipball/develop.
Unzip the resulting file, and continue to read this document.
Before you can run the bot, you need to install a few Python dependencies. LXML is required while Enchant and PyDNS are needed for several plugins.
These can be installed with
pip (The Python package manager):
[sudo] pip install -r requirements.txt
If you use
pip, you will also need the following packages on linux or
pip will fail to install the requirements.
python, python-dev, libenchant-dev, libenchant1c2a, libxslt-dev, libxml2-dev.
How to install
curl -O http://python-distribute.org/distribute_setup.py # or download with your browser on windows python distribute_setup.py easy_install pip
Before you run the bot, rename
config and edit it with your preferred settings.
Once you have installed the required dependencies and renamed the config file, you can run the bot! Make sure you are in the correct folder and run the following command:
On Windows you can usually just double-click
bot.py to start the bot, as long as you have Python installed correctly.
Getting help with CloudBot
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.
(some of the information on the wiki is outdated and needs to be rewritten)
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.
CloudBot runs on Python 2.7.x. It is currently developed on Windows 8 with Python 2.7.5.
It requires the Python module lXML.
Enchant is needed for the spellcheck plugin.
PyDNS is needed for SRV record lookup in the mcping plugin.
Windows users: Windows compatibility some plugins is broken (such as ping), but we do intend to add it. Eventually.
You can find a number of example bots in #CloudBot.
CloudBot is licensed under the GPL v3 license. The terms are as follows.
CloudBot Copyright © 2011-2014 Luke Rogers and CloudBot Contributors 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/>.