Skip to main content

the Xtensible XMPP Chat Bot

Project description

The Xtensible XMPP Chat Bot


  • python 3
  • python3-gi
  • python3-nbxmpp


  • pipenv


with pipenv

$ pipenv --site-packages --python 3
$ pipenv install
$ pipenv run ./

on osx:

$ brew install python3 pygobject3 pipenv

on Arch

# pacman -S python-gobject python-nbxmpp
$ ./

on Debian:

# apt install python3-gi python3-nbxmpp
$ ./


The script loads a configuration file called after the bot class name. For a bot class EchoBot the script will look for './echobot.rc', '~/.echobot.rc' and '/etc/echobot.rc' in this order, and will load the first it find.

An example config file is provided as echobot.rc.dist, with comments.


Subclass XChatBot class in xchatbot module and implement your commands as method of your class. Methods must be named cmd_yourcommand and must get a peer parameter and a number of args. A docstring should be provided that is used by help command to build the help message.

The bot is started calling the classmethod start()

In this example a simple echo bot. The bot has one command, echo and will send back all arguments back to the peer

from xchatbot import XChatBot

class MyEchoBot(XChatBot):
    def cmd_echo(self, peer, *args):
        """Echo back what you typed"""
        msg = "You said: "
        msg = msg + " ".join(args)

if __name__ == "__main__":

create a myechobot.rc config file and run the bot:

$ python

private commands

A command can be marked as private using the @private decorator. A private command is list in help and is executed only if the message comes from the admin JID setted in config file

from xchatbot import XChatBot, private

class MyEchoBot(XChatBot):
    def cmd_echo(self, peer, *args):
        """Echo back what you typed"""
        msg = "You said: "
        msg = msg + " ".join(args)

    dev cmd_admin(self, peer, *args):
        """Bot administration"""
        peer.send("The admin was succesfull")

Project details

Release history Release notifications

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for xchatbot, version 0.1.0
Filename, size File type Python version Upload date Hashes
Filename, size xchatbot-0.1.0-py2.py3-none-any.whl (7.6 kB) File type Wheel Python version py2.py3 Upload date Hashes View hashes
Filename, size xchatbot-0.1.0.tar.gz (7.3 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page