Introduction to Artemis (u/AssistantBOT), Round V

https://www.reddit.com/r/AssistantBOT/comments/jdnged/introduction_to_artemis_uassistantbot_round_v/

created by AssistantBOT on 18/10/2020 at 20:18 UTC*

22 upvotes, 10 top-level comments (showing 10)

❓ FAQ[1] • 🔎️ Guide[2] • 📓 Change Log[3] • 🎚️ Advanced[4]

1: https://www.reddit.com/r/AssistantBOT/wiki/faq

2: https://www.reddit.com/r/AssistantBOT/wiki/guide

3: https://www.reddit.com/r/AssistantBOT/wiki/changelog

4: https://www.reddit.com/r/AssistantBOT/wiki/advanced

Introducing Artemis (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 (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 1,000+ subreddits with over 80 million subscribers combined!)

*Feel free to comment below if you have questions about Artemis.** Or if you prefer Discord, click **this link[5].**

5: https://discordapp.com/invite/K3yu8g8

This is a repost of previous introduction posts, which have now been automatically archived.* (I[6], II[7], III[8], IV[9].)

6: https://www.reddit.com/user/AssistantBOT/comments/9usj60/introduction_to_artemis_uassistantbot/

7: https://www.reddit.com/user/AssistantBOT/comments/bm11lh/introduction_to_artemis_uassistantbot_ii/

8: https://www.reddit.com/r/AssistantBOT/comments/dc6i1a/introduction_to_artemis_uassistantbot_iii/

9: https://www.reddit.com/r/AssistantBOT/comments/g34kmk/introduction_to_artemis_uassistantbot_round_iv/

Functions (TL;DR)

Artemis has two primary functions:

1. **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 FrontPageMetrics[10]). * 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).

2. **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[11]**.

10: http://frontpagemetrics.com/

11: https://www.reddit.com/r/AssistantBOT/wiki/faq

I want Artemis to assist my subreddit!

Awesome! It's super easy to add Artemis as a moderator to your subreddit:

1. Use the guide below to determine what kind of mode suits your subreddit best.

2. Invite **u/AssistantBOT1** (**please note the number!**) from your subreddit's moderators page at `https://www.reddit.com/r/SUBREDDIT/about/moderators` with the most suitable moderator permissions.

3. 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 500 subscribers and resume statistics-gathering when it has reached that threshold.

As of January 2021, the original instance of Artemis is no longer accepting new invites - invites should instead be sent to the instance at **u/AssistantBOT1**.

Flair Enforcing Modes

Artemis's flair enforcing modes are determined by the moderator permissions[12] it has:

12: https://www.reddit.com/r/modhelp/wiki/mod_permissions

`Default` mode * If you just want Artemis to provide statistics information and *remind* OPs but **not** remove unflaired posts, invite it with the `wiki` permission.
`Strict` mode (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 `wiki` *and* the `posts` permissions.
`+` 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 `flair` permission. * This enhancement is recommended as it allows users across all platforms to easily select flairs.

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  │
╞════════════════════════════════╪════════════════════════════════╪════════════╡
│                                │ Flair reminder messages are    │            │
│ `wiki`                         │ sent to submitters who submit  │ `Default`  │
│                                │ an unflaired post.             │            │
├────────────────────────────────┼────────────────────────────────┼────────────┤
│                                │ Flair reminder messages are    │            │
│                                │ sent to submitters who submit  │            │
│ `wiki`, `flair`                │ an unflaired post. Submitters  │ `Default+` │
│                                │ can select a flair by          │            │
│                                │ responding to the messages     │            │
│                                │ with a flair text.             │            │
├────────────────────────────────┼────────────────────────────────┼────────────┤
│                                │ Flair reminder messages are    │            │
│                                │ sent to submitters who submit  │            │
│ `wiki`, `posts`                │ an unflaired post. Unflaired   │ `Strict`   │
│                                │ posts are removed until        │            │
│                                │ submitters select a flair.     │            │
├────────────────────────────────┼────────────────────────────────┼────────────┤
│                                │ Flair reminder messages are    │            │
│                                │ sent to submitters who submit  │            │
│                                │ an unflaired post. Unflaired   │            │
│ `wiki`, `posts`, `flair` /     │ posts are removed until        │ `Strict+`  │
│ `all`                          │ submitters select a flair.     │            │
│                                │ Submitters can select a flair  │            │
│                                │ by responding to the messages  │            │
│                                │ with a flair text.             │            │
└────────────────────────────────┴───────��────────────────────────┴────────────┘

Settings

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[13] for information on the optional advanced configuration.

13: https://www.reddit.com/r/AssistantBOT/wiki/advanced

Data

All of the data that Artemis collects, except for an individual subreddit's traffic data, is publicly available through Reddit's API[14] or through other public data sources like Pushshift[15]. Posts and subscriber statistics are pulled once daily and traffic data is pulled every month.

14: https://www.reddit.com/dev/api/

15: https://pushshift.io/

Removing Artemis from a subreddit's moderation team automatically terminates all statistics-gathering for the sub. You can find the source code for Artemis here[16].

16: https://github.com/kungming2/AssistantBOT

About the Writer

I (u/kungming2) am the writer and maintainer of u/translator-BOT (Wenyuan[17] and Ziwen[18]) and u/LEGO_IDEAS_BOT, among many others. My bot Wenyuan has been keeping detailed statistics[19] for r/translator for four 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.

17: https://www.reddit.com/r/translatorBOT/wiki/wenyuan

18: https://www.reddit.com/r/translatorBOT/wiki/ziwen

19: https://www.reddit.com/r/translator/wiki/overall_statistics

Please feel free to comment below if you have any questions about Artemis or its operations!*

Comments

Comment by kungming2 at 18/10/2020 at 20:20 UTC

1 upvotes, 1 direct replies

Whoa, Artemis is almost two years old!

Please mention my username (u/kungming2) in your comment so that I can see your question/comment more quickly, as I do not receive reply notifications for this post.

Comment by Ex_iledd at 25/10/2020 at 01:53 UTC

2 upvotes, 1 direct replies

/u/KungMing2 Heya. I just made this post[1] and recalled an event a few weeks ago where some community figures wanted to know which of their admins had image flair in our sub. Thanks to pushshift we were able to find them, though it'd have been much easier if the usernames were made available to us within the userflair part of the wiki page stats.

1: https://www.reddit.com/r/wowmeta/comments/jhl8pm/user_flair_stats/

Obviously for a sub like r/wow where some seventy thousand people have a single flair that list would be quite long, though for flairs that only two or three people have it would be greatly beneficial. Is there any way you could implement such a list?

Comment by HAHA-LOLoff at 20/10/2020 at 20:33 UTC

1 upvotes, 1 direct replies

u/kungming2 How do I summon Arteris?

Comment by SabreYT at 31/10/2020 at 13:45 UTC

1 upvotes, 2 direct replies

u/kungming2,

The bot accepted my invite but never sent me a confirmation message or anything. Any idea what's up?

Comment by HumanCriticismSux at 02/11/2020 at 22:02 UTC

1 upvotes, 0 direct replies

u/kungming2

Hello! What "off mode" means? I gave the bot wiki and posts permission, my sub is r/MaisBarato

Comment by Txur-Itan at 03/11/2020 at 02:15 UTC

1 upvotes, 0 direct replies

Happy cake day!!

Comment by cyrilio at 10/11/2020 at 00:32 UTC

1 upvotes, 1 direct replies

Couldn't Artemis use https://subredditstats.com[1] as a source for subscriber tracking?

1: https://subredditstats.com

Comment by ACE415_ at 24/11/2020 at 17:41 UTC

1 upvotes, 1 direct replies

u/kungming2 is it possible to remove list of available flairs from the Assistant bots message?

Comment by [deleted] at 21/02/2021 at 16:42 UTC

1 upvotes, 1 direct replies

u/kungming2 When I perform test posts I am not receiving any notifications for lack of flair. Does it skip this for a Mod performing this action? I believe I have this setup. Statistics show messages for this reason are being sent. I just have not personally seen one while testing with my account.

Comment by aldinefe at 09/02/2022 at 14:00 UTC

1 upvotes, 1 direct replies

u/kungming2 - I am excited to set this up for my sub (FamiliesYouChoose). Unfortunately, when I go to the page to add moderators and search for u/AssistantBOT1, it says "No results for u/AssistantBOT1". Any idea what's going on?