Matrix-chatbot connects to a Matrix (Matrix.org) server and responds to messages at a configurable reponse rate.
It automatically joins any rooms it is invited to and replies to any messages containing its username.
Its response rate per-room may be configured by issuing a !rate command to the bot in that room. To tell the bot to reply to about a tenth of messages, message !rate 0.1.
Its response rate may be queried by messaging !rate without any arguments.
- Python v3.5
- matrix-client
- SQLAlchemy v1.1.4
pip install -r requirements.txt
$ python3 main.py
The first time you run it, a config file will be generated for you to edit as needed.
You may also "train" your bot with a UTF-8 text file before you run it. This can be done with
$ python3 main.py --train trainfile.txt
A dockerfile is also provided for running in docker.
To build the image locally and run the chatbot:
$ docker build . -t matrix-chatbot
$ docker run -it -v /host/data/path/:/matrixbot/data/ matrix-chatbot
A config has been generated. Please set your bot's username, password, and homeserver in /host/data/path/config.cfg then run this again.
$ vim /host/data/path/config.cfg
$ docker run -d -v /host/data/path/:/matrixbot/data/ matrix-chatbot