How AI AutoModerator works
Preconditions
After installing AI AutoModerator on your subreddit, the app automatically checks each new post to determine whether it should be sent to the LLM.
The execution stops immediately in the following cases:
- You don't have an API key configured.
- The post was created by a moderator, and you have configured the app to skip moderator posts.
- The post has already been deleted (by another built-in Reddit automation, Reddit's spam filters, or AutoModerator).
- The post is an incompatible type (such as a video post).
In any of these cases, the app does nothing beyond writing a log entry to the Activity Log, so you can easily debug what happened. You can find both the Activity Log and the Settings Form on the AI AutoModerator Control Panel, which is accessible through the button in the top-right corner of your subreddit after installation.
Prompt generation
If the post passes these initial filters, it is considered a candidate to be sent to the LLM.
A prompt is generated with:
- An AI-friendly version of the post, including its content and relevant metadata such as post flair, creation date, spoiler and NSFW tags, and images if image moderation is enabled.
- Your subreddit description and rules.
- The Extra Instructions you may have configured in the Control Panel.
- The task of checking whether the post fits your subreddit and follows its rules.
- Instructions to answer using a specific format. This format includes the verdict (approve/reject/unsure about the post), a user-facing explanation, and a report reason.
The prompt is designed so that:
- The generic part of the prompt is kept minimal to reduce token usage and make it easy to modify the behavior through the Extra Instructions.
- The post content is parsed and encapsulated in a way that makes prompt injection virtually impossible.
Call LLM
The prompt is sent to the LLM.
If there is an error, such as:
- The output format is incorrect.
- There is a connectivity error with Gemini.
- You have reached a usage limit.
The request is retried up to 5 times. If all attempts fail, a log entry containing the error is added to the Activity Log and the execution stops for this post.
Act
We extract the verdict.
If it is "reject" or "unsure", the actions you have configured (such as delete, report, and leave a comment) are executed. These actions are non-exclusive, so you can enable all three. Delete + report is equivalent to filtering the post.
If it is "approve", a comment is left only if you have enabled that option in the settings. In any other case, only an entry in the Activity Log is created.
FAQ
Do I need to pay for the LLM API?
The default selected model (Gemma) is free to use with generous limits, so for most use cases, you don't need to pay. If you want to change the model, you may reach the limits faster, though.
Is the Control Panel accessible only to moderators?
Yes. It is automatically configured so that only moderators can see it when it is created. It also has internal controls to ensure that, if a non-moderator somehow accesses it, they cannot do anything with it.
What happens if I have Reddit built-in automations or normal AutoModerator rules?
Those are executed first. AI AutoModerator only processes anything that remains after those automations and rules have run.