mastodon-random-sentence-bot/README.md

# Mastodon Random Sentence Bot

[![no github badge](https://nogithub.codeberg.page/badge.svg)](https://nogithub.codeberg.page/)

A mastodon bot posting random sentences. Forked from [Misskey Random Sentence Bot](https://git.worldc.one/worldcone/misskey-random-sentence-bot)

## How to run with docker compose

1. clone repo

2. change setting

```bash
# copy compose file
cp docker-compose.example.yml docker-compose.yml

# copy and edit .env
cp .example.env .env
vim .env
```

3. add your access token
```bash
touch token.secret
vim token.secret
```

4. RUN

```bash
docker compose up
docker compose down
```

## How to run manually

1. clone repo

2. make venv

```bash
python3 -m venv venv
source ./venv/bin/activate
```

3. install modules

```bash
pip install -r requirements.txt
```

4. change setting(changing the sentences and words directories as a absolute path is recommended)

```bash
# copy example setting file
cp .example.env .env

# edit setting file
vim .env
```

5. RUN

```bash
python main.py
```

# Contribute

To contribute to this project is free!

## Contributors

**Thank you for your contribution!**

<a class="contributor" href="https://codeberg.org/kdh8219"><img src="https://codeberg.org/avatars/6529ee7f1f363a06741ed8851c08e94b77d27e83003d1a58f59e1e936087728c?size=512" alt="kdh8219" width="70" style="border-radius: 50%"></a>