Welcome to BOTLIB,

BOTLIB is a pure python3 bot library you can use to program bots, uses a JSON in file database with a versioned readonly storage and reconstructs objects based on type information in the path. It can be used to display RSS feeds, act as a UDP to IRC relay and you can program your own commands for it.

BOTLIB is placed in the Public Domain and has no COPYRIGHT and no LICENSE.


BOTLIB can be found on pypi, see

installation is through pypi:

> sudo pip3 install botlib --upgrade --force-reinstall


BOTLIB has it’s own CLI, the bot program, you can run it on the shell prompt and, as default, it won’t do anything:

$ bot

use bot <cmd> to run a command directly, e.g. the cmd command shows a list of commands:

$ bot cmd

configuration is done with the cfg command:

$ bot cfg channel=\#dunkbots nick=botje

users need to be added before they can give commands, use the met command:

$ bot met ~botfather@jsonbot/daddy


BOTLIB provides, with the use of feedparser, the possibility to serve rss feeds in your channel. Install python3-feedparser if you want to display rss feeds in the channel:

$ sudo apt install python3-feedparser

To add an url use the rss command with an url:

$ bot rss

run the fnd (find) command to see what urls are registered:

$ bot fnd rss

the ftc (fetch) command can be used to poll the added feeds:

$ bot ftc
fetched 20

adding rss to mods= will load the rss module and start it’s poller:

$ bot krn mods=rss


BOTLIB also has the possibility to serve as a UDP to IRC relay where you can send UDP packages to the bot and have txt displayed in the channel. Output to the IRC channel is done with the use python3 code to send a UDP packet to BOTLIB, it’s unencrypted txt send to the bot and displayed in the joined channels:

import socket

def toudp(host=localhost, port=5500, txt=""):
    sock = socket.socket(socket.AF_INET, socket.SOCK_DGRAM)
    sock.sendto(bytes(txt.strip(), "utf-8"), host, port)


BOTLIB provides a library you can use to program objects under python3. It provides a basic BigO Object, that mimics a dict while using attribute access and provides a save/load to/from json files on disk. Objects can be searched with a little database module, provides read-only files to improve persistence and use a type in filename reconstruction.

Basic usage is this:

>>> from obj import Object
>>> o = Object()
>>> o.set("key", "value")
>>> o.key

objects try to mimic a dictionary while trying to be an object with normal attribute access as well. Hidden methods are provided as are the basic methods like get, items, keys, register, set, update, values.

The bot.obj module provides the basic methods like load and save as a object function using an obj as the first argument:

>>> import obj
>>> obj.wd = "data"
>>> o = obj.Object()
>>> o["key"] = "value"
>>> p =
>>> p
>>> oo = obj.Object()
>>> oo.load(p)
>> oo.key

great for giving objects peristence by having their state stored in files.


BOTLIB provides the following modules:

| adm           - admin
| all           - load modules
| cmn           - common
| irc           - bot
| rss           - feeds
| tdo           - todo
| fnd           - find
| log           - log
| udp           - relay


programming your own commands is easy, open mod/ and add the following code:

def hlo(event):
    event.reply("hello %s" % event.origin)

now you can type the “hlo” command, showing hello <user>

$ bot hlo
hello root@console


have fun coding

botfather on #dunkbots