Awesome IRC bot
Go to file
2017-05-14 12:42:57 -07:00
bin Support reading config from stdin 2017-05-01 08:29:20 -07:00
docs Support monolithic configs 2017-04-30 23:27:40 -07:00
examples Add highlight mode for ascii module for real legit spamming 2017-05-13 21:48:14 -07:00
pyircbot Fix configurable activity timeout 2017-05-14 12:42:57 -07:00
.gitignore Add _recv hook 2015-12-13 13:40:44 -08:00 Update readme #nobuild 2015-12-13 14:17:15 -08:00 Misc & lint fixes 2017-01-01 16:26:54 -08:00


A modular python IRC bot

Quick start

  • Install: python3 install
  • Configure: cd examples ; vim config.json data/config/Services.json
  • Run: pyircbot -c config.json

Running in docker

A dockerfile is included at examples/docker/. From the root of this repository, run docker build -t pyircbot -f examples/docker/Dockerfile . to build it. Typical use is mounting a directory from the host onto /srv/bot; this dir should contain config.json and any other dirs it references.

Building Docs

  • Install sphinx and all modules pyircbot depends on
  • cd docs ; make html
  • Open _build/index.html

Or, use my pre-built copy here.

Alternatively, use the included Dockerfile to create an environment for building the docs. Check docs/builder/

Developing Modules

Check Module Developers Guide in the docs


  • Improve/complete docs
  • Write config checker