Knowledge (IRC) Database Bot
kdb is a small pluggable IRC Bot framework utilizing the circuits Python Application Framework.
kdb was one of the first “test” applications written in circuits and is still maintained and kept up-to-date with new features and changes in circuits.
You may use kdb as a framework to build your own projects that use the IRC protocol. kdb itself comes with a suite of useful plugins and features. If you’d like to see it in action, feel free to get in touch with the developer James Mills (prologic) on the FreeNode IRC Network who resides in the #circuits channel.
kdb was created by and is primarily maintained by James Mills
$ pip install kdb
$ kdb irc.freenode.net
For other options:
$ kdb --help
Installation and Usage on Docker
kdb is now Docker ready and can be run with:
$ CID=$(docker run -d -p 8000:8000 -v $(pwd)/etc:/etc/kdb --name="kdb" prologic/kdb --config=/etc/kdb/kdb.ini)
kdb has a full complementary set of plugins available.
For a list of available plugins, see:
You may install the latest Development Version via:
$ pip install kdb==dev
kdb 1.0.2 (2014-04-27)
Fixed a bug in the new Web API.
Fixed a bug with kdb.plugins.help.format_msg().
Updated the Web Plugin UI to use jQuery Terminal.
Added a JSON RPC Plugin.
Updated Drone Plugin to listen to registered and nick events.
Fixed a typo in Greeting Plugin
kdb 1.0.1 (2014-04-16)
Fixed Web Plugin proper and make package non zip_safe.
Fixed templates path in Web Plugin.
Fixed the Web Plugin so it works if installed as a package and run separately.
kdb 1.0.0 (2014-04-16)
Fixed missing html2text and aspell-en dependency.
Updated requirements and Dockerfile
Moved example config into etc/
Print a treceback on plugin load failure.
Use os.path.exists to check for --config file.
Added Remote Plugin Plugin
Fixed sub-commands for Channels Plugin.
Fixed state management.
Set a filename to save RSS Feeds to for the RSS Plugin in the default sample configuration file.
Fixed sub-commands with the Channels Plugin.
Fixed display of RLIST command in RSS Plugin.
Fixed counting usage statistics of commands.
kdb 0.9.0 (2014-04-14)
Ported to circuits 3.0
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.