Switch branches/tags
Nothing to show
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
72 lines (53 sloc) 2.7 KB
README FOR pyGBot 0.1.2 - Alpha release
pyGBot - Versatile IRC Bot
Copyright (C) 2008 Morgan Lokhorst-Blight, Alex Soborov, Paul Rotering
This program 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.
This program 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 this program. If not, see <>.
Based on pyTBot, (c) 2007 Paul Rotering
Licensed under GPLv2
Uses ConfigObj, (c) 2008 Michael Foord and Nicola Larosa
Licensed under modified (3 clause) BSD License
Uses "C# Events in Python", (c) 2005 Zoran Isailovski
Licensed under MIT License
Simple Disclaimer:
THIS IS AN ALPHA RELEASE. It it provided AS-IS, with no warranty or support.
If it breaks your computer, it's not our fault.
- Python >= 2.5
- Twisted >= 2.0 (including twisted.words)
To run:
Uncompress, go to src/ and modify the values in pyGBot.ini. The main ones
you're interested in are host, port, nick, and channel. Once that's done, run
To add users to the Auth system:
Run, it will prompt you for the relevant details.
To modify:
Your best bet is to look at the existing plugins, as well as src/
All plugins must subclass BasePlugin. If you design a new plugin, you'll have
to add it to the list of plugins to be loaded and started in pyGBot.ini.
[Plugins] is plugins to load, and [Plugins.system.Startup] is plugins which
will be activated immediately.
Command system:
The system.Commands plugin provides a set of commands (extensible of course!)
which are single-line calls made by users to enact some immediate response or
action. The existing ones are primarily related to controlling the bot (join /
part channel, send public message, etc) but any single-line command could
conceivably be implemented here. Have a look at the existing commands in
src/Plugins/system/CommandSpec, and the BaseCommand class in
If you have any further questions please respond via email or the forums, both
can be found at the project page:
- The pyGBot team