A chatbot framework+implementation for XMPP-based MUC room chats and IRC.
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
tgdcb
README.md
bot.py
cb_repl.py
cli.py
clone.py
config
dependencies.py
evalbot.py
shakespeare.py

README.md

This is the README for TheGoddamnChatbot.

What is this?, you ask. It's the Goddamn Chatbot, that's what!

Getting this code to work

For starters, you're going to need to meet a few dependencies:

The dependencies.py script can tell you which modules you're missing. It also patches some old-style classes in the pyxmpp module. Once it reports that everything is in order, you should be able to run cb_repl.py and experiment with the triggers.

To actually run chatbot in a MUC room, edit the constants in config to point to your room and server.

Playing with this code

  • The easiest (but least fun) thing to play with is cb_repl.py.
    • It provides a REPL-like environment for running chatbot's trigger commands.
    • Note that not all of them will work outside of the chatroom context.
  • Load up chatbot by running bot.py
  • Load an evalbot by running evalbot.py
    • Warning! Very little security is in place. Use with discretion.
  • Load an auto-responding Shakespeare bot with shakespeare.py
  • Load a clone of someone in your Pidgin logs with clone.py
  • Chat from the comfort of your terminal with cli.py