Flexible IRC bot framework.
Switch branches/tags
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
bots
labots
.gitignore
CHANGELOG
LICENSE
README
config.yaml
labots.py
setup.py

README

LABots
======

v1.3

Flexible IRC bot framework.

Features
--------

* Run multiple bots with single IRC instance
* Bots do not affect each other
* Useful and flexible IRC bot interface
* Dynamic {load,unload} bots when they are modified
* Asynchronous socket


Requires
--------

* python 3
* python-pyinotify >= 0.9.4
* python-tornado >= 3.2.2
* python-yaml


Usage
-----

Install LABots (optional): `python setup.py install`

Run LABots: Create file `config.yaml` as follow, and run `labots -c config.yaml`
in the same directory (If you don't want to install LABots in your system,
just run `./labots.py -c config.yaml` in project directory).

    config.yaml
    e.g:
        host: irc.freenode.net  # IRC server
        port: 6666              # Port
        nick: labots            # IRC bot nick name
        path: bots              # Path of bot scripts

    LABots will loads all bot scripts in `bots` directory, when script file
    (*.py) or configure file (*.json) changed, bot script will be reload
    automatically. file which name starts with `_` or `.` will be ignored.

Write a bot: See `bots/example.py` or <https://github.com/SilverRainZ/bots>


Bots
----

See <https://github.com/SilverRainZ/bots>.


References
----------

* https://github.com/lilydjwg/archrepo2
* https://github.com/nod/iobot
* https://github.com/LukeusMaximus/Python-IRC-Bot-Framework
* https://github.com/lilydjwg/winterpy


License
-------

GPL3