Awesome IRC bot
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Dave Pedu 13ea0fe52f
Merge pull request #3 from r3cursive/patch-1
8 months ago
docs Add stockindex module 1 year ago
examples add announce channel 2 years ago
pyircbot Update 8 months ago
tests add replyto field to privmsg ircevent messages 1 year ago
tools Add metadata interchange to pubsub mode 4 years ago
.dockerignore Docs update 3 years ago
.gitignore Ignore test asciis 4 years ago
Dockerfile Move dockerfile 3 years ago Update docs with testing info 4 years ago
requirements-test.txt Docs update 3 years ago
requirements.txt Docs update 3 years ago py 3.7 3 years ago Move dockerfile 3 years ago Add 24h historical loss/gain to StockPlay 3 years ago


A modular python IRC bot

Quick start

  • Install: python3 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/

Developing Modules

Check Module Developer’s Guide in the docs


PyIRCBot has great test coverage. After installing the contents of requirements-test.txt, the script ./ will run all tests. See the contents of the script for more information. See in ./tests/ for more info.


  • Improve/complete docs
  • Write config checker