Skip to content

ebrpol/creep

 
 

Repository files navigation

creep

XMPP-based chatbot that's easy to extend. Originally inspired by gozerbot. Easy & minimal plugin structure, couple of useful plugins out-of-the-box:

  • http-json: provides HTTP interface that lets you POST messages to a XMPP conference rooms
  • quotes: add & ask about quotes
  • dns-resolver: resolve domains from within the bot. Useful for situations where your bot is running behind your firewall but you want to quickly resolve a host on that local network

requirements

see requirements.txt

  • pyyaml
  • sleekxmpp
  • dnspython (optional, for dns plugin)

installation

Recommended way of installing is via virtualenv:

virtualenv venv
venv/bin/pip install -r requirements.txt

running

See example config: creep.yaml.example At the very least, jid, password & default room configured (you can use your gmail/gchat account if you want to mess around and test)

Running:

venv/bin/python creep #from parent directory

To test you can edit & run:

echo "test" | ./examples/usr/local/bin/creep.sh

Be sure to base64 encode your secret (if you changed it) before pasting it in examples/usr/local/bin/creep.sh

About

Easily log events to xmpp chatrooms

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages

  • CSS 70.7%
  • Python 28.2%
  • Shell 1.1%