Skip to content
CloudBot - The simple, fast, expandable, open-source Python IRC Bot!
Branch: master
Clone or download
daboross Further fix async stuff for python3.7 compat.
This takes from snoonetIRC@899cd32

A proper git merge worked this time, so the author is correctly

Merge branch 'async-fix-from-snoonetirc'
Latest commit 6c5a88f Dec 11, 2018
Type Name Latest commit message Commit time
Failed to load latest commit information.
cloudbot Fix import error when merging. Dec 11, 2018
data Fix new food data. Dec 10, 2018
docs Create Config Docs Apr 12, 2015
plugins Use async_call in regular plugins for Python 3.7+ compat Dec 10, 2018
travis I suck Mar 27, 2015
.travis.yml Push 1.0.9 because I can Jun 16, 2015 Update Jan 10, 2015
config.default.json Made the ISBNdb plugin distributable Apr 10, 2017
requirements.txt Updated to not require importing the json library. Apr 20, 2017


CloudBot is a simple, fast, expandable open-source Python IRC Bot!

Project Status & A more updated CloudBot

CloudBot is currently unmaintained. The project possibly usable, but there are currently no developers building new features or fixing bugs.

There are several forks of CloudBot which you may want to use instead. These projects have much more work done on them, and are thus incompatible. If you already have a running CloudBot instance you will probably need to start over from scratch.

  • snoonetIRC/CloudBot :

    This is a more active fork being created by members of Snoonet that might be a better option for your needs. Keep in mind that, as a project more than a thousand commits ahead of this one, if you already have a running CloudBot instance you will probably need to start over from scratch.

  • gonzobot :

If there are any other maintained forks of CloudBot, pull requests to add them to the README are welcome.

Getting CloudBot

There are currently two different branches of this repository, each with a different level of stability:

  • master (stable): This branch contains stable, tested code. This is the branch you should be using if you just want to run your own CloudBot! Build Status
  • python3.4 (unstable): This branch is where we test and develop new features. If you would like to help develop CloudBot, you can use this branch. Build Status

New releases will be pushed from python3.4 to master whenever we have a stable version to release. This should happen on a fairly regular basis, so you'll never be too far behind the latest improvements.

Installing CloudBot

Firstly, CloudBot will only run on Python 3.4 or higher. Because we use the asyncio module, you will not be able to use any other versions of Python.

To install CloudBot on *nix (linux, etc), see here

To install CloudBot on Windows, see here

Running CloudBot

Before you run the bot, rename config.default.json to config.json and edit it with your preferred settings. You can check if your JSON is valid using!

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:

python3.4 -m cloudbot

Note that you can also run the cloudbot/ file directly, which will work from any directory.

python3.4 CloudBot/cloudbot/

Specify the path as /path/to/repository/cloudbot/, where cloudbot is inside the repository directory.

Getting help with CloudBot


The CloudBot documentation is currently somewhat outdated and may not be correct. If you need any help, please visit our IRC channel and we will be happy to assist you.

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

More at the Wiki Main Page.


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

If you think you have found a bug/have an idea/suggestion, please open an issue here on Github and contact us on IRC!

Example CloudBots

You can find a number of example bots in #CloudBot.




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



Copyright © 2011-2015 Luke Rogers / CloudBot Project

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
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 <>.

This product includes GeoLite2 data created by MaxMind, available from GeoLite2 databases are distributed under the Creative Commons Attribution-ShareAlike 3.0 Unported License

Powered by wordnik

This product uses data from in accordance with the API terms of service.

You can’t perform that action at this time.