Awesome IRC bot
Go to file
dave d55e111767 modernize module system: 5.0.0 2017-11-27 19:00:26 -08:00
bin modernize module system: 5.0.0 2017-11-27 19:00:26 -08:00
docs modernize module system: 5.0.0 2017-11-27 19:00:26 -08:00
examples modernize module system: 5.0.0 2017-11-27 19:00:26 -08:00
pyircbot modernize module system: 5.0.0 2017-11-27 19:00:26 -08:00
.gitignore Add _recv hook 2015-12-13 13:40:44 -08:00
README.md modernize module system: 5.0.0 2017-11-27 19:00:26 -08:00
run-example.sh modernize module system: 5.0.0 2017-11-27 19:00:26 -08:00
setup.py fix unicode error 2017-10-12 23:35:42 -07:00

README.md

pyircbot3

A modular python IRC bot

Quick start

  • Install: python3 setup.py install
  • Configure: vim examples/config.json examples/data/config/Services.json
  • Run: pyircbot -c examples/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/README.md.

Developing Modules

Check Module Developers Guide in the docs

TODO

  • Improve/complete docs
  • Write config checker