46 lines
941 B
Markdown
46 lines
941 B
Markdown
|
# Hemppa - generic Matrix bot
|
||
|
|
||
|
## First
|
||
|
|
||
|
* Create a Matrix user
|
||
|
* Get user's access token - In Riot Web see Settings / Help & about
|
||
|
|
||
|
## Running on host
|
||
|
|
||
|
Run something like:
|
||
|
|
||
|
``` bash
|
||
|
pip3 install pipenv
|
||
|
pipenv shell
|
||
|
pipenv install
|
||
|
MATRIX_USER="@user:matrix.org" MATRIX_ACCESS_TOKEN="MDAxOGxvYlotofcharacters53CgYAYFgo" MATRIX_SERVER="https://matrix.org" JOIN_ON_INVITE=True python3 bot.py
|
||
|
```
|
||
|
|
||
|
## Running with Docker
|
||
|
|
||
|
Create .env file and set variables:
|
||
|
|
||
|
``` bash
|
||
|
MATRIX_USER=@user:matrix.org
|
||
|
MATRIX_ACCESS_TOKEN=MDAxOGxvYlotofcharacters53CgYAYFgo
|
||
|
MATRIX_SERVER=https://matrix.org
|
||
|
JOIN_ON_INVITE=True
|
||
|
```
|
||
|
|
||
|
Note: without quotes!
|
||
|
|
||
|
Just run:
|
||
|
|
||
|
``` bash
|
||
|
docker-compose up
|
||
|
```
|
||
|
|
||
|
## Env variables
|
||
|
|
||
|
User, access token and server should be self-explanatory. Set JOIN_ON_INVITE to anything if you want the bot to
|
||
|
join invites automatically.
|
||
|
|
||
|
You can set MATRIX_PASSWORD if you want to get access token. Normally you can use Riot to get it.
|
||
|
|
||
|
## Testing
|