ModReplyBot Reddit Bot

This bot watches a subreddit for moderator reports containing triggers, approves posts, and leaves stickied comments. Triggers and comments are configured via a subreddit wiki page. All other settings are handled via environment variables.

Features

• Watches for moderator reports with triggers
• Approves posts and leaves stickied comments
• Triggers/comments configured via subreddit wiki
• Supports multiple triggers/comments
• Docker and baremetal support

Configuration

1. Subreddit Wiki Page

Create a wiki page (e.g. modreplybot-config) in your subreddit using Automoderator YAML format. Example:

triggers:
  - trigger: help
    comment: |
      Thank you for your report!
      This post is now approved.

  - trigger: question
    comment: |
      This post has been approved.
      Your question will be answered soon.

Each entry under triggers defines a trigger and its associated multi-line comment.

2. Environment Variables

Create a .env file (or set env variables directly) with:

REDDIT_CLIENT_ID=your_client_id
REDDIT_CLIENT_SECRET=your_client_secret
REDDIT_USERNAME=your_username
REDDIT_PASSWORD=your_password
REDDIT_USER_AGENT=modreplybot by /u/your_username
REDDIT_SUBREDDIT=your_subreddit
REDDIT_WIKI_PAGE=modreplybot-config

Installation

Docker Compose (Recommended)

1. Copy .env.example to .env and fill in your values.
2. Run:

docker compose up -d

Docker Run

1. Copy .env.example to .env and fill in your values.
2. Run:

docker run --env-file .env slfhstd.uk/slfhstd/modreplybot:latest

Baremetal (Direct Python)

1. Install Python 3.11+
2. Install dependencies:

pip install -r requirements.txt

3. Set environment variables or create a .env file.
4. Run:

python modbot.py

Building the Docker Image

If you want to build your own image:

docker build -t modreplybot .

Troubleshooting

• Ensure your Reddit credentials are correct and have moderator permissions.
• The bot must be able to read the wiki page and approve posts.
• Check logs for errors.

License

MIT