Introducing Artemis (u/AssistantBOT), a flair enforcer and statistics bot for any subreddit!
- Looking for an easy-to-use bot to help make sure your community's submitters remember to choose a post flair?
- Want more detailed and extensive statistics on the health and growth of your community?
Artemis (u/AssistantBOT) is an easy-to-use and helpful Reddit bot written by a moderator for moderators to assist them with organizing and gaining insights into their own communities. (Now used on 550+ subreddits with over 30 million subscribers and 2700+ moderators combined!)
Artemis has two primary functions:
- Recording useful statistics for your subreddit. Artemis will compile statistics on the following and format it in a summary wikipage that's updated daily (see the sidebar on New Reddit or mobile of this subreddit for examples). This wikipage includes:
- A monthly statistics breakdown of your community's posts and its activity (most active days, top submitters/commenters, top-voted posts).
- Daily subscriber growth, both future and historical, as well as past and future subscriber milestones. (replacement and complement for RedditMetrics).
- Traffic data, including the average uniques and pageviews for your community and its estimated traffic for the current month.
- A breakdown of the userflairs of your community and how many people have each userflair (optional).
- Enforcing post flairs on your subreddit. Artemis will help make sure submitters choose an appropriate flair for their post. (flair enforcing can be turned off, if desired)
For more detailed information, please see the FAQ.
Awesome! It's super easy to add u/AssistantBOT as a moderator to your subreddit:
- Use the guide below to determine what kind of mode suits your subreddit best.
- Invite u/AssistantBOT from your subreddit's moderators page at
https://www.reddit.com/r/SUBREDDIT/about/moderatorswith the most suitable moderator permissions. - The bot will accept your invite and reply with a confirmation message.
Note: Artemis will enforce post flairs for subreddits of any size, but will pause statistics-gathering if a subreddit is below 25 subscribers and resume statistics-gathering when it has reached that threshold.
Artemis's flair enforcing modes are determined by the moderator permissions it has:
Defaultmode- If you just want Artemis to provide statistics information and remind OPs but not remove unflaired posts, invite it with the
wikipermission.
- If you just want Artemis to provide statistics information and remind OPs but not remove unflaired posts, invite it with the
Strictmode (optional)- If you'd like Artemis to proactively remove posts that do not have a flair until their author selects one, invite it with the
wikiand thepostspermissions.
- If you'd like Artemis to proactively remove posts that do not have a flair until their author selects one, invite it with the
+enhancement (optional, but recommended)- If you would like submitters to be able to simply select a flair with a reply to Artemis's flair enforcement messages, also invite Artemis with the
flairpermission. - This enhancement is recommended as it allows users across all platforms to easily select flairs.
- If you would like submitters to be able to simply select a flair with a reply to Artemis's flair enforcement messages, also invite Artemis with the
Artemis will start enforcing post flairs once it accepts your moderator invite and will generate the first statistics page after midnight UTC.
Here's a table with a detailed breakdown of what the different flair enforcement modes are:
| Moderator Permissions | Flair Enforcement Actions | Mode Name |
|---|---|---|
wiki |
Flair reminder messages are sent to submitters who submit an unflaired post. | Default |
wiki, flair |
Flair reminder messages are sent to submitters who submit an unflaired post. Submitters can select a flair by responding to the messages with a flair text. | Default+ |
wiki, posts |
Flair reminder messages are sent to submitters who submit an unflaired post. Unflaired posts are removed until submitters select a flair. | Strict |
wiki, posts, flair / all |
Flair reminder messages are sent to submitters who submit an unflaired post. Unflaired posts are removed until submitters select a flair. Submitters can select a flair by responding to the messages with a flair text. | Strict+ |
Artemis is explicitly designed to be easy-to-use and consequently by default doesn't have "settings" apart from the moderator permissions noted in the table above. Moderators can choose to turn off flair enforcing if they want, retaining only Artemis's statistics-gathering function.
If you are comfortable with code and want to change some finer aspects of flair enforcing, please see this page for information on the optional advanced configuration.
All of the data that Artemis collects, except for an individual subreddit's traffic data, is publicly available through Reddit's API or through other public data sources like Pushshift. Posts and subscriber statistics are pulled once daily and traffic data is pulled every month.
Removing u/AssistantBOT from a subreddit's moderation team automatically terminates all statistics-gathering for the sub.
I (u/kungming2) am the writer and maintainer of u/translator-BOT (Wenyuan and Ziwen) and u/LEGO_IDEAS_BOT, among others. My bot Wenyuan has been keeping detailed statistics for r/translator for over three years. I wanted to write a new statistics and flair enforcement bot for some of the other communities that I moderate and decided to share it with fellow moderators as well.