OS : Debian10

Objectif : Installer le Bot "ASMODEE" pour [Matrix] .

1) Installation des prérequis Debian

apt install python3-pip git

2) Installation du SDK MATRIX

pip3 install matrix_client

3) installation de l’API pour le BOT

adduser botmatrix

su botmatrix

cd

git clone https://github.com/shawnanastasio/python-matrix-bot-api.git

cd python-matrix-bot-api

su

python3 setup.py install

exit

4) Installation du BOT ASMODEE

cd

git clone https://git.ombreport.info/nemesis/asmodee_matrix.git

cd asmodee_matrix

5) Configuration du BOT ASMODEE

vi asmodee.ini

Exemple:
[AUTH]
username = totolebot
password = MonGrosPassword
server = https://mmonserveurmatrix.machin.truc
admin = @moi:mmonserveurmatrix.machin.truc

PS: il faut deja avoir créé un compte MATRIX pour le bot sur l’instance

6) Lancer le BOT

python3 asmodee.py

7) Installation du lanceur systemd

vi asmodee.service

[Unit]
Description=Bot Matrix Asmodee
After=syslog.target
After=network.target

[Service]
Type=simple
User=matrixbot
Group=users
Environment=PYTHONUNBUFFERED=1
Environment=HOME=/home/matrixbot/asmodee_matrix
WorkingDirectory=/home/matrixbot/asmodee_matrix
ExecStartPre=/bin/sleep 30
ExecStart=/usr/bin/python3 -u /home/matrixbot/asmodee_matrix/asmodee.py
ExecStop=/bin/kill -9 $MAINPID
Restart=on-failure
RestartSec=30
SyslogIdentifier=asmodee
StandardOutput=syslog
StandardError=syslog

[Install]
WantedBy=multi-user.target

su

cp asmodee.service /etc/systemd/system/

systemctl enable asmodee

systemctl start asmodee

exit

9) Utilisation

Une fois le Bot lancé, il existe en tant qu'utilisateur Matrix sur l'instance [MATRIX]. Il faut l'inviter dans le salon dans lequel vous souhaitez le voir travailler. Seul l'admin déclaré dans asmodee.ini peut administrer le Bot.

Commencez par lui dire "!help".

have fun!

Merci à @nemesis:ombreport.info

Sources:
https://github.com/matrix-org/matrix-python-sdk
https://github.com/shawnanastasio/python-matrix-bot-api
https://git.ombreport.info/nemesis/asmodee_matrix

Previous Post