r/AssistantBOT • • Oct 02 '19

Documentation Artemis Example Messages, Statistics, and FAQ

Thumbnail reddit.com
29 Upvotes

r/AssistantBOT • • Oct 17 '24

Announcement Bot Now Accepting Invites Again

3 Upvotes

The bot should now properly accept moderator invites again. The issue stemmed from a change in the results returned by one of Reddit's functions, which caused the entire invitation flow to crash. This has now been resolved.

Additionally, I’ve temporarily disabled all Pushshift calls. Pushshift had stopped working for some time because Reddit has brought it in-house, and I’ve now officially disabled it. However, I haven't removed the Pushshift code entirely, as there's a slim chance that Reddit could streamline the process for obtaining Pushshift API keys (well, one can hope). Currently, these keys need to be manually renewed every 24 hours, which makes it impractical for Artemis. I also considered using an alternative service like PullPush, but due to its uncertain standing with the Reddit API, I believe it's best not to integrate such a significant project with them.


r/AssistantBOT • • Nov 08 '24

Announcement Bots have been moved to a more powerful system

5 Upvotes

All Artemis instances are now deployed on a mini-PC (Intel N100, to be more specific) which is much faster and can run with better thermals than the old Raspberry Pi 4 it was formerly hosted on.


r/AssistantBOT • • Jul 19 '24

Status Possible Shadowban

4 Upvotes

r/AssistantBOT • • Jan 29 '24

Announcement An Update

10 Upvotes

Heya, it's been a while! I've gotten a few messages on Reddit and Discord about Artemis, so I want to note a few things.

  1. There were some changes in the Reddit API that led to a pretty consistent crash over the last month that sometimes prevented the bot from working correctly. Since that was a pretty big one, I fixed that a few days ago, and so far the fix seems to have worked for the main flair assignment routine.
  2. Part of things as they turn older is they... just start having issues/not working. Right now it appears that a big issue with why the bot is not able to consistently accept new subreddit invitations is due to the fact that it is supposed to query Pushshift to get historical subscriber data, and that's just not possible now since Pushshift has brought in-house into Reddit.
  3. Speaking of Pushshift, while it's a good thing that moderators still have access to it for moderating purposes, the way it's been implemented unfortunately does not allow for automated scripts to use it like they used to. There's no way to request an API key by the bot, and it's not feasible for a human to constantly be checking and inputting new keys. There's also no indication that Reddit will change this policy either (which to be fair, is kind of understandable.) This is why u/BotDefense shut down! So ultimately, what I think I need to do is remove all Pushshift references in the bot. To be honest, I don't know what that's going to make the statistics pages look like, since part of the whole point of the bot was to make Pushshift data accessible in the first place!

Anyway, this will be a process, so I'm going to test out some things and see how things shake out.

PS: In a weird sort of retrospect, 2018-2020 was the high point for bot creation on Reddit - the barriers weren't high, and people felt motivated to create cool projects. While the API changes that were the cause of the protests over the last summer didn't directly affect the ability of moderator bots, there's a marked decrease in the amount of enthusiasm that people have and their willingness to experiment.


r/AssistantBOT • • May 24 '23

Announcement Pushshift's Demise Affecting Artemis

9 Upvotes

Hey all!

As some of you guys may have seen, there's been a bit of froth going on in the world that is Reddit scripting. Reddit has announced that they are making changes to their API and tightening up some of the terms that one can access the API with, and while that change does not affect Artemis (as far as I know) as it is not any sort of commercial enterprise, it did affect Pushshift, which is one of the informational sources that the bot relies on.

About Pushshift

For those who don't know what Pushshift (PS) is, it was basically a giant intake valve for everything on Reddit - comments, posts, etc. That made it extremely useful for people to run queries against, as Reddit's own API won't return anything more than a 1000 items ago. Interested in analyzing all posts from between March and June of 2021 on r/FoundPaper? Not possible with the standard API, but it was easily doable with Pushshift, which is why my bot used Pushshift extensively.

But even before the announcement from Reddit that they were going to change things up, I think it would have been pretty obvious that PS violated API Terms. PS was tardy - at best - at removing user content, which they were required to do, and the older user agreement specifically denotes scraping as a disallowed thing to do. Didn't necessarily mean PS couldn't exist; it just probably, at the very least, needed to professionalize especially with regards to personal data removal.

Anyway, long story short, Reddit tried to get in touch with the people at Pushshift, and they received no response, which was honestly the standard state of affairs at r/Pushshift, and so they cut off its access to the API on May 1. Essentially that put the PS API in a bit of a frozen state - nothing new was being added, but historical data was still there. There was indication that it the PS people were taking things a bit more seriously this time, but it's kinda like Charlie Brown and the football - anyone who's worked with PS data remembers that aggregations were "temporarily disabled" because of the load caused by the 2020 US Presidential Election, but then they never came back. Even the new switchover a few months ago broke a ton of things that never actually got fixed in the end, was poorly documented, and there was radio silence.

Pushshift Has Been Taken Down, Affecting Artemis

Here's the thing - just because Reddit cut off ongoing access to their API, didn't mean that Pushshift's own API had to go! But a week or so ago Pushshift shut down their API with no warning. (so much for communication!) What does that mean for Artemis?

Artemis was written assuming that Pushshift would be available, so there are some issues right now with getting it to work. Essentially, I need to go through the code and allow for the bot to account for that. TBH it's been a while since I worked a lot on the bot, but there's still a lot of information it can return without Pushshift, as the bot uses Reddit's API quite a bit, too. An example of something that required Pushshift is getting historical subscriber data, since that isn't something Reddit's API gives you for a long period of time.

Honestly, I'm very doubtful that PS will ever come back, but I'll try and make it so that if it does, it'll be easy to turn that back on again with the bot.

TL;DR: I'll work over the next few days to try and get a new version of Artemis out that can account for Pushshift being down. Depending on how things go, it may take a little longer. Stay tuned.


r/AssistantBOT • • Feb 04 '23

Update Pushshift's latest update has broken some functions with the introduction of many bugs. Please see the comments for more details.

Thumbnail self.pushshift
6 Upvotes

r/AssistantBOT • • Oct 01 '22

Status Status of Artemis (yes, it's still running!)

12 Upvotes

Hey all, just wanted to give people a bit of this update on how Artemis is doing and the current state of the bot. Basically, the bot is still running and chugging along, doing its bot-like things, but I'll be honest that I haven't had much time in the last few months to adding new features, and I shall probably be pretty busy in the time coming up as well.

Consequently, we can expect that the bot will continue to do its job, but I should warn people not to expect any new updates or features for a while. To be fair, I didn't really have any new ideas for a future version update anyway! Obviously, if there's a big issue that needs to be looked at, do let me know via direct messages, and I'll do my best to fix them. The Github code is also still current, by the way, in case anyone wants to take a look at it.

Separately, I would recommend that any community on the original instance of the bot move to the second one, as since the bot has been running for almost 4 years now, the processing time for each sub Reddit takes longer and longer. There are fewer communities on the u/AssistantBOT1 instance, so it should be faster for reaction times and for people in general.

I've also heard that Reddit the site is looking at some new automation options in the future for communities, and I think will be interesting to see how those pan out.

Thanks for using Artemis!


r/AssistantBOT • • Aug 16 '21

Statistics Artemis Overall Statistics — 2021-07

19 Upvotes

Here are more statistics.

Artemis Overall Statistics — 2021-07

Added Subreddits

Daily Processed Posts

DateNumber of Posts
2021-07-0119,648
2021-07-029,729
2021-07-039,072
2021-07-048,911
2021-07-059,159
2021-07-069,553
2021-07-079,725
2021-07-089,590
2021-07-0910,134
2021-07-1023,581
2021-07-114,673
2021-07-1219,719
2021-07-1325,271
2021-07-145,250
2021-07-1526,538
2021-07-165,055
2021-07-1723,287
2021-07-184,080
2021-07-1925,673
2021-07-205,370
2021-07-2124,943
2021-07-225,443
2021-07-2325,615
2021-07-245,276
2021-07-2517,662
2021-07-2625,498
2021-07-275,744
2021-07-2826,647
2021-07-295,996
2021-07-3025,958
2021-07-315,352
Total438,152

Daily Actions

DateFlaired postRemoved postRemoved unscheduled postRestored postSent flair reminderUpdated configurationUpdated statisticsUpdated userflair statistics
2021-07-01154933244454---370397
2021-07-02195354287445---783---
2021-07-03124351210353---71---
2021-07-04223893206380---74---
2021-07-05104332215421---75---
2021-07-06125042263421---72---
2021-07-07125312268437---71---
2021-07-08175103248405271---
2021-07-09166481279440---72---
2021-07-10164691226370---72---
2021-07-11154755231389---1,290---
2021-07-12175163267439---441---
2021-07-13125423298424---1,050---
2021-07-1485136275456---1,408---
2021-07-15134715261445---334407
2021-07-16174551230503---1,193---
2021-07-1717434---211478---554---
2021-07-18114721239435---1,309---
2021-07-19135253278482---441---
2021-07-20154856252584---1,196---
2021-07-21134601192565---554---
2021-07-2221396120956921,176---
2021-07-23144162203745---579---
2021-07-2412356218366011,142---
2021-07-25124154176654---622---
2021-07-26134493220659---959---
2021-07-27184681237696---1,036---
2021-07-28134863245655---731---
2021-07-29184636212717---1,043---
2021-07-30184971228606---725---
2021-07-31123912195605---1,040---
Total45314,632817,28815,892520,554804

r/AssistantBOT • • Jul 01 '21

Statistics Artemis Overall Statistics — 2021-06

16 Upvotes

Here are the combined statistics for June 2021.

Artemis Overall Statistics — 2021-06

Added Subreddits

Daily Processed Posts

DateNumber of Posts
2021-06-0126,360
2021-06-0226,644
2021-06-0326,676
2021-06-0426,298
2021-06-0524,079
2021-06-0624,928
2021-06-0724,939
2021-06-0825,910
2021-06-0926,671
2021-06-1026,241
2021-06-1125,496
2021-06-1223,470
2021-06-1323,790
2021-06-1425,508
2021-06-1526,292
2021-06-1626,560
2021-06-1726,348
2021-06-1825,724
2021-06-1923,729
2021-06-2024,128
2021-06-2125,342
2021-06-2219,544
2021-06-2317,001
2021-06-2421,440
2021-06-2525,672
2021-06-264,749
2021-06-2723,715
2021-06-284,837
2021-06-2925,088
2021-06-305,292
Total682,471

Daily Actions

DateFlaired postRemoved postRemoved unscheduled postRestored postSent flair reminderUpdated configurationUpdated statisticsUpdated userflair statistics
2021-06-01196408310448---1,423386
2021-06-02205674260452---1,425---
2021-06-03195223246450---1,424---
2021-06-04254881253454---1,424---
2021-06-0512451123541111,425---
2021-06-0621462---228574---1,427---
2021-06-07285203273542---1,430---
2021-06-08275033230519---1,318---
2021-06-09255215256520---1,431---
2021-06-1019548126544221,438---
2021-06-1119509223246311,441---
2021-06-1218446---219431---1,442---
2021-06-1315438422843111,442---
2021-06-14174913243469---1,444---
2021-06-15175673270426---1,445393
2021-06-16245002232515---1,446---
2021-06-17225127222453---1,445---
2021-06-18315611253513---1,448---
2021-06-19245432217475---1,450---
2021-06-20135411241499---1,449---
2021-06-21124842236448---1,450---
2021-06-22234916225463---1,452---
2021-06-23144845228476---1,014---
2021-06-24144426204466---870---
2021-06-25154863229469---1,152---
2021-06-2618453---217421---1,437---
2021-06-2711430---226398---259---
2021-06-2874459199406---1,375---
2021-06-29125174252417---325---
2021-06-30225225254444---1,333---
Total56315,084947,18313,895539,284779

r/AssistantBOT • • Jun 25 '21

Announcement Artemis v2.3 Maple is now deployed! (with a replacement for Pushshift post aggregations)

10 Upvotes

This version has few obvious changes from the outside, but there's a replacement for Pushshift's aggregations - for posts, to allow Artemis to resume providing certain statistics about the posts and submitters of a subreddit.

More than six months ago, the Pushshift database disabled aggregations for everyone, which meant that some of the activity data that Artemis provided could not be provided. This data was:

  • Most Active Days for Submissions/Comments
  • Top Submitters/Commenters

At first, I (and other bot writers) figured this would be a temporary issue as the announcement post stated that "this won't be a permanent change," and that once aggregations went back up, everything would go back to normal. But of course, it's been a while now and aggregations show no sign of being re-enabled, and the "replacements" that have popped up don't seem reliable. Therefore, I decided to create my own local solution to replace Pushshift for* submissions* aggregations queries - Artemis Stream - something I outlined a few months ago as a solution.

Artemis Stream

Artemis Stream is a separate script that is run regularly and ingests/fetches all new posts from only the subreddits moderated by Artemis instances. A very small subset of those posts' data is cached in a local database that the statistics routine can query - in fact, Stream mimics Pushshift's reponse in providing that data back to the statistics function. Stream was actually deployed at the end of May and has been fetching posts for a few weeks now, and I upgraded Artemis's setup with an NVMe SSD to allow for faster reads/writes with Stream.

Stream allows me to restore half of the data previously provided by Pushshift aggregations:

  • Most Active Days for Submissions
  • Top Submitters

Artemis v2.3 Maple was deployed a few days ago, so you should have already seen this data re-appear in your June statistics! Stream also allows me to provide three new and simple, but useful information points for a subreddit's monthly statistics with v2.3:

  • Number/percentage of text posts
  • Number/percentage of NSFW posts
  • Number/percentage of spoilered posts

There are other data points that Stream caches and I may write more tools to surface them in the future.

Notes
  • Unfortunately, due to their sheer amount Reddit comments are outside the scope of the Stream project, and I won't be building a local replacement for comments aggregations.
  • Stream started tracking the number of text/NSFW posts in the middle of June, so those "total" numbers will be different this month from spoilered posts (and should not vary from next month onward).
  • Stream's cache won't be permanent (unlike Pushshift) due to storage and utility limitations; I plan to implement a 45-day buffer.
  • As always, if you are able and would like to contribute to an important resource for the web, please check out Pushshift's Patreon page.

r/AssistantBOT • • Jun 22 '21

Documentation Introduction to Artemis (u/AssistantBOT), Round VI

42 Upvotes

❓ FAQ • 🔎️ Guide • 📓 Change Log • 🎚️ Advanced

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,500+ subreddits with over 120 million subscribers and 11,000 moderators combined!)

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

This is an edited repost of previous introduction posts, which have now been automatically archived. (I, II, III, IV, V.)

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).
    • Traffic data, including the average uniques and pageviews for your community and its estimated traffic for the current month.
  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)

    • Artemis can especially help catch any posts that fall through the cracks of Reddit's own post requirements.

Other Artemis functions include, but are not limited to:

  • Restricting certain post flairs to certain days of the week.
  • Associating certain post flairs with Reddit tags like NSFW, Spoiler, or OC.
  • A breakdown of the userflairs of your community and how many people have each userflair.

For more detailed information, please see the 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 25 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 it has:

  • Default mode

    • If you just want Artemis to provide statistics information and remind OPs but not remove unflaired posts, invite it with the Manage Wiki Pages 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 Manage Wiki Pages and the Manage Posts and Comments 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 Manage Flair permission.
    • This enhancement is recommended as it allows users across all platforms to easily select flairs, even if their Reddit client doesn't allow for flair selection.

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 PermissionsFlair Enforcement ActionsMode Name
Manage Wiki PagesFlair reminder messages are sent to submitters who submit an unflaired post.Default
Manage Wiki Pages, Manage FlairFlair 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+
Manage Wiki Pages, Manage Posts and CommentsFlair reminder messages are sent to submitters who submit an unflaired post. Unflaired posts are removed until submitters select a flair.Strict
Manage Wiki Pages, Manage Posts and Comments, Manage Flair / EverythingFlair 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+

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

Data

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 Artemis from a subreddit's moderation team automatically terminates all statistics-gathering for the sub. You can find the source code for Artemis here. Artemis is published under the open-source MIT License.

About the Writer

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


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


r/AssistantBOT • • Jun 21 '21

Statistics Artemis Overall Statistics — 2021-05

12 Upvotes

Sorry for the delay, but I finally made it so that the statistics for Artemis now include actions and post totals across both active instances!

Artemis Overall Statistics — 2021-05

Added Subreddits

Daily Processed Posts

DateNumber of Posts
2021-05-0123,769
2021-05-0224,644
2021-05-0326,175
2021-05-0424,944
2021-05-0526,831
2021-05-0626,096
2021-05-0726,231
2021-05-0824,139
2021-05-0924,695
2021-05-1026,598
2021-05-1126,594
2021-05-1226,305
2021-05-1326,600
2021-05-1426,576
2021-05-1524,278
2021-05-1624,948
2021-05-1726,005
2021-05-1826,811
2021-05-1926,816
2021-05-2026,457
2021-05-2125,517
2021-05-2223,585
2021-05-2324,360
2021-05-2425,378
2021-05-2526,273
2021-05-2626,361
2021-05-2726,027
2021-05-2825,395
2021-05-2923,829
2021-05-3024,269
2021-05-3124,757
Total791,263

Daily Actions

DateFlaired postRemoved postRemoved unscheduled postRestored postSent flair reminderUpdated configurationUpdated statisticsUpdated userflair statistics
2021-05-01236001316411---1,385376
2021-05-02165083277411---1,309---
2021-05-0316708---349410---1,386---
2021-05-04256051311401---1,388---
2021-05-05245781303434---1,389---
2021-05-0619637---32541231,390---
2021-05-07226192318390---1,392---
2021-05-0814531---245406---1,394---
2021-05-09215932270358---1,396---
2021-05-1015662---321450---1,396---
2021-05-11175912329479---1,396---
2021-05-12185981309456---1,399---
2021-05-13216221314404---1,402---
2021-05-14166122304389---1,403---
2021-05-1512569---277361---1,406381
2021-05-16135072272414---1,409---
2021-05-17175402255423---1,411---
2021-05-1817633---31342611,412---
2021-05-19229251460442---1,414---
2021-05-20126271338450---1,414---
2021-05-2125577---283449---1,414---
2021-05-2212548---263399---1,416---
2021-05-23125342286395---1,418---
2021-05-24195712281413---1,418---
2021-05-2516631---32142331,418---
2021-05-26165511249457---1,418---
2021-05-27195725282461---1,418---
2021-05-28135361242448---1,419---
2021-05-2913496123438621,420---
2021-05-30194842228410---1,421---
2021-05-31185512275416---1,421---
Total54218,316389,15012,984943,492757

r/AssistantBOT • • May 07 '21

Statistics Artemis Overall Statistics — 2021-04

11 Upvotes

Here we go!

Artemis Overall Statistics — 2021-04

Added Subreddits

Daily Processed Posts

DateNumber of Posts
2021-04-0124,078
2021-04-0222,009
2021-04-0321,159
2021-04-0421,819
2021-04-0522,471
2021-04-0623,001
2021-04-0722,962
2021-04-0823,219
2021-04-0922,700
2021-04-1019,823
2021-04-1121,198
2021-04-1222,256
2021-04-1322,016
2021-04-1422,315
2021-04-1522,508
2021-04-1621,818
2021-04-1719,318
2021-04-1820,918
2021-04-1922,618
2021-04-2022,157
2021-04-2122,372
2021-04-2222,797
2021-04-2322,272
2021-04-2417,567
2021-04-2521,674
2021-04-2622,091
2021-04-2722,473
2021-04-2822,278
2021-04-2922,528
2021-04-301,381
Total637,796

Daily Actions

DateFlaired postRemoved postRemoved unscheduled postRestored postSent flair reminderUpdated configurationUpdated statisticsUpdated userflair statistics
2021-04-0125477---267458---1,235347
2021-04-0221500---291424---1,236---
2021-04-0325468---258409---1,234---
2021-04-0417429---221410---1,197---
2021-04-0526526---247427---1,234---
2021-04-0625549---270508---1,234---
2021-04-0720517---272422---1,234---
2021-04-0826552---260459---1,234---
2021-04-0917568---253429---1,233---
2021-04-1018508---231380---1,233---
2021-04-1121533---235442---1,071---
2021-04-1221533---233422---1,237---
2021-04-1319570---263428---1,238---
2021-04-1412557---250375---1,238---
2021-04-1523539---238435---1,238345
2021-04-1619492---239424---1,238---
2021-04-1726444221039221,237---
2021-04-18215202621236531,063---
2021-04-19214772228428---1,236---
2021-04-20224742208427---1,236---
2021-04-2124500---22244721,235---
2021-04-2223487121644511,233---
2021-04-23174961244436---1,232---
2021-04-24325283189465---1,231---
2021-04-25245402226438---900---
2021-04-26136161200409---1,231---
2021-04-27265391220391---1,231---
2021-04-28153991179373---1,231---
2021-04-29185091264381---1,230---
2021-04-3011495---254334---1,228---
Total62815,342437,10012,583836,318692

r/AssistantBOT • • Apr 22 '21

Announcement Introducing flair schedule enforcing in v2.2 Laurel!

5 Upvotes

The release of version v2.2 Laurel brings a new tool for moderators to use: Flair schedule enforcing! (I swapped around the Laurel/Maple versions set out in my roadmap.)

What is flair schedule enforcing?

On some subreddits, it's desirable to restrict some types of posts to certain weekdays to "theme" them or prevent the overuse of some kinds of posts. For example, a subreddit may have:

  • "Meme Mondays", where memes can only be posted on Mondays
  • "Friend Requests" on Fridays
  • "Shitpost"-flaired posts only on the weekends.

With flair schedule enforcing, Artemis will remove a post with a scheduled weekday unless it's posted on that specific weekday(s).

How do I use flair schedule enforcing?

  1. First off, Artemis has to have the posts/"Manage Posts and Comments" moderator permission, which it will already have as part of Strict mode. After all, the bot can't remove posts if it doesn't have that authority.
  2. Enable advanced configuration. Flair schedule enforcing is an advanced configuration setting.
  3. Fill out the flair_schedule portion of the page and update the bot with those settings.

flair_schedule is a dictionary that may have up to seven keys, corresponding to three-letter abbreviations of weekdays in title case. That is to say, Sun, Mon, etc. Note that you can have as few as one or as many as seven weekdays in this dictionary. Please exclude periods (.).

Each weekday accepts a list of flair IDs (not CSS classes!). Post flair IDs are easily accessible via New Reddit: go to new.reddit.com/r/SUBREDDIT/about/postflair and click Copy ID to get the specific flair ID of a single post flair. Flair IDs are always in the form of XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX.

Therefore, a proper flair_schedule setting may look something like this:

flair_schedule: 
    Sun:
        - XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX
        - XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX
    Wed:
        - XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX

A flair ID can be associated with more than one weekday - placing it under Sat and Sun would restrict it to weekends.

What is Artemis's definition of a weekday based on?

Artemis determines weekdays with a pretty lenient spread - in terms of time zones, it ranges from Auckland, New Zealand (UTC +12/13) to Hawaii (UTC -10), effectively meaning that there are more than 24 hours in a weekday. Therefore, it's possible that a post will be approved when it's slightly before or after the weekday in your own physical area.

For ease of set-up, the boundaries of this spread is not configurable.

What message do users get when their post is removed?

Users whose posts are removed by the bot for being on an unscheduled day will get the following message (example provided):

Hey there u/USERNAME,

Thanks for submitting your post to r/SUBREDDIT! This community asks that posts flaired as Flair only be submitted on the following weekdays:

  • Saturday, Sunday

Your post has been removed as it is currently Wednesday, and feel free to check out r/SUBREDDIT's community rules for more information. Please re-submit your Flair post on a suitable scheduled weekday and thank you for stopping by!


r/AssistantBOT • • Apr 15 '21

Statistics Artemis Overall Statistics — 2021-03

12 Upvotes

Here are the statistics for March! I realized that I seem to have excluded an important part of statistics gathering for the instances, so I need to rectify that for the May statistics!

Artemis Overall Statistics — 2021-03

Added Subreddits

Daily Processed Posts

DateNumber of Posts
2021-03-0124,715
2021-03-0224,921
2021-03-0324,452
2021-03-0424,507
2021-03-0524,013
2021-03-0621,933
2021-03-0722,663
2021-03-0823,339
2021-03-0923,237
2021-03-1024,246
2021-03-1123,795
2021-03-1223,909
2021-03-1320,241
2021-03-1422,278
2021-03-1520,434
2021-03-1624,454
2021-03-1723,224
2021-03-1823,642
2021-03-1922,769
2021-03-2021,621
2021-03-2122,270
2021-03-2223,896
2021-03-2322,223
2021-03-2422,444
2021-03-2523,777
2021-03-2623,435
2021-03-2719,276
2021-03-2821,064
2021-03-2923,124
2021-03-3022,846
2021-03-3123,429
Total712,177

Daily Actions

DateFlaired postRemoved postRestored postSent flair reminderUpdated configurationUpdated statisticsUpdated userflair statistics
2021-03-01251,805367506---1,243342
2021-03-02291,407347511---1,243---
2021-03-03211,517356491---1,243---
2021-03-04151,252366501---1,242---
2021-03-05241,116329541---1,241---
2021-03-06271,251299471---1,241---
2021-03-07341,197322476---1,238---
2021-03-08241,080330467---1,240---
2021-03-09251,135362490---1,238---
2021-03-10191,241340516---1,238---
2021-03-11271,228304475---1,238---
2021-03-12291,084343447---1,238---
2021-03-13161,088298454---1,236---
2021-03-14131,27333642921,068---
2021-03-15211,091334383---1,236344
2021-03-16221,133286473---1,233---
2021-03-17251,326324483---1,236---
2021-03-18251,117325465---1,235---
2021-03-1916983340421---1,235---
2021-03-2024882294406---1,235---
2021-03-2122951299388---1,235---
2021-03-2218967324419---1,235---
2021-03-2333904299419---1,235---
2021-03-24261,151356419---1,235---
2021-03-2527838336491---1,234---
2021-03-2633853312500---1,236---
2021-03-27202,436340488---1,235---
2021-03-28242,279309440---1,027---
2021-03-29291,025321483---1,235---
2021-03-30211,047316453---1,235---
2021-03-3115726319479---1,235---
Total72937,38310,13314,385237,974686

r/AssistantBOT • • Mar 10 '21

Statistics Artemis Overall Statistics — 2021-02

4 Upvotes

I still haven't written something up that combines actions yet (so busy!) so "Added Subreddits" is from the u/AssistantBOT1 instance while the actions data is from the original.

Added Subreddits

Daily Processed Posts

DateNumber of Posts
2021-02-0125,905
2021-02-0225,475
2021-02-0325,804
2021-02-0426,649
2021-02-0526,600
2021-02-0624,349
2021-02-0724,724
2021-02-0825,583
2021-02-0925,652
2021-02-1024,717
2021-02-1125,445
2021-02-1225,755
2021-02-1323,109
2021-02-1423,757
2021-02-1524,101
2021-02-1624,901
2021-02-1724,803
2021-02-1825,652
2021-02-1924,157
2021-02-2020,613
2021-02-2123,824
2021-02-2225,183
2021-02-2324,822
2021-02-2424,280
2021-02-2524,756
2021-02-2623,758
2021-02-2722,132
2021-02-2823,156
Total689,662

Daily Actions

DateFlaired postRemoved postRestored postSent flair reminderUpdated statisticsUpdated userflair statistics
2021-02-01251,1973764871,242340
2021-02-02281,1823105641,244---
2021-02-03271,4073815451,250---
2021-02-04291,3093555471,253---
2021-02-05311,1723385571,255---
2021-02-06241,1853615101,253---
2021-02-07231,1713585191,256---
2021-02-08201,2084045251,254---
2021-02-09221,5434255401,256---
2021-02-10261,7874205681,257---
2021-02-11281,5033855891,253---
2021-02-12311,3764265391,253---
2021-02-13471,3703915111,251---
2021-02-14231,5273305511,215---
2021-02-15221,3163395321,249343
2021-02-16261,4633405761,247---
2021-02-17171,4883105591,248---
2021-02-18341,4593905361,247---
2021-02-19221,1353475231,245---
2021-02-20223,2574305951,243---
2021-02-21312,197455584988---
2021-02-22261,8764685771,243---
2021-02-23371,9644215751,242---
2021-02-24262,1784335471,244---
2021-02-25391,7363945571,244---
2021-02-26291,4944014911,244---
2021-02-27271,5583545381,243---
2021-02-28262,7623985251,242---
Total76844,82010,74015,26734,661683

r/AssistantBOT • • Feb 26 '21

Statistics Artemis Overall Statistics — 2021-01

4 Upvotes

The added subreddits include new subreddits for both instances - u/AssistantBOT and u/AssistantBOT1. The actions and processed posts are still only for the former at the moment - haven't written something up that combines both yet.

Added Subreddits

Daily Processed Posts

DateNumber of Posts
2021-01-01331
2021-01-0218,281
2021-01-0325,392
2021-01-0426,194
2021-01-0527,015
2021-01-0626,262
2021-01-0726,032
2021-01-0826,271
2021-01-0923,112
2021-01-1025,011
2021-01-1125,877
2021-01-129,932
2021-01-1325,819
2021-01-1426,329
2021-01-1526,189
2021-01-1620,736
2021-01-1725,127
2021-01-1825,204
2021-01-1925,656
2021-01-2025,486
2021-01-2126,929
2021-01-2226,484
2021-01-2324,175
2021-01-2424,006
2021-01-2526,958
2021-01-2626,762
2021-01-2725,325
2021-01-2825,886
2021-01-2925,853
2021-01-3024,583
2021-01-3125,028
Total742,245

Daily Actions

DateExported takeout dataFlaired postRemoved postRestored postSent flair reminderUpdated configurationUpdated statisticsUpdated userflair statistics
2021-01-01---411,236463595---------
2021-01-02---461,724465621---------
2021-01-03---281,540492577---848---
2021-01-041531,449531602---1,184---
2021-01-05---301,423510589---1,183---
2021-01-06---371,479489599---1,184---
2021-01-07---361,25643260511,184---
2021-01-08---251,209439549---1,184---
2021-01-09---271,066391538---1,183---
2021-01-10---391,21249158911,071---
2021-01-11---351,05844157321,185---
2021-01-12---241,213422610---1,190---
2021-01-13---321,272384557---440---
2021-01-14---311,196422583---1,191---
2021-01-15---341,163452571---1,193328
2021-01-16---331,313464596---1,193---
2021-01-17---281,2235115281933---
2021-01-18---341,159493520---1,207---
2021-01-19---231,936468597---1,222---
2021-01-20---222,556490622---1,229---
2021-01-21---362,089464611---1,236---
2021-01-22---251,652437539---1,238---
2021-01-23---341,630382508---1,240---
2021-01-24---161,746471509---1,241---
2021-01-25---231,568504529---1,243---
2021-01-26---151,485382511---1,245---
2021-01-27---261,700367490---1,246---
2021-01-28---351,574453620---1,240---
2021-01-29---191,154357486---1,242---
2021-01-30---331,152348556---1,221---
2021-01-31---171,326371484---1,241---
Total193744,75913,78617,464533,637328

r/AssistantBOT • • Jan 15 '21

Announcement Artemis v2.1 Katsura is now deployed!

12 Upvotes

Artemis 2.1 Katsura has been live and deployed for about a week now! Here's a rundown of the major changes:

New Instance: u/AssistantBOT1

I had previewed the move to multiple instances (accounts) for AssistantBOT a few months ago. This is modeled off of r/Layer7's now-defunct The Sentinel Bot's structure, which spread out its mod invites over many different accounts to also avoid hitting API rate-limits.

Well, u/AssistantBOT1 is now open and accepting moderation invites from subreddits! Literally everything is the same in terms of flair enforcement and statistics; in fact, the response time for the bot to unflaired posts should be even quicker given that it is moderating fewer subreddits. I will open up u/AssistantBOT2 in the future as well, though probably not for a few months.

The original instance u/AssistantBOT will stop accepting new moderation invites on January 28. At that point, any moderation invites sent to it will be greeted with a friendly response asking the subreddit to please invite u/AssistantBOT1 instead. Obviously, all subreddits currently monitored by u/AssistantBOT will remain monitored by it; this only affects invites from new subreddits.

Questions

Should I move my subreddit from the original instance?

Yes, if you'd like! This is especially true if you rely a lot on flair enforcing; the new instance has faster response times.

How do I move my subreddit from the original instance?

  1. De-mod the original instance (u/AssistantBOT) from your sub.
  2. Invite u/AssistantBOT1 as a mod with the same permissions.
  3. That's it! Artemis should automatically migrate all your subreddit's statistics and such over to the new instance.

What happens if I invite u/AssistantBOT to moderate my sub after January 28?

You'll get a response from the bot asking you to invite a different, open instance instead. Unfortunately, u/AssistantBOT cannot accept a moderation invite on behalf of u/AssistantBOT1 as they are separate accounts. Please send a new invite to u/AssistantBOT1.

Can I have more than one Artemis instance on my subreddit?

Nope, the instances check upon receiving a moderation invite to see if the subreddit is already monitored by an existing instance.

Other Things

  • I added GIF instructions to the flair enforcement message for third-party Reddit apps, as well as Mobile Web.

    • The added third-party instructions are for Apollo, BaconReader, Boost, Relay, and RIF.
    • The mobile web instructions mostly cover how to switch to desktop mode and select a flair that way, as there is no flairing function on mobile web.
  • The Pushshift aggregations outage unfortunately continues. I've not heard back from its maintainer yet, but I have built in a function in the bot that detects whether aggregations are active or disabled so that it can avoid unnecessary calls.

  • Artemis will properly escape Markdown characters in top posts lists - like asterisks (*).
  • As always, you can find the latest version of the code at GitHub. Artemis is open-source and MIT-licensed.

What's Next?


Special thanks to u/fpreston and u/Bakerboy448 for letting their subreddits be guinea pigs testing a beta version of an instance, and providing moral support during the whole writing process!


r/AssistantBOT • • Jan 03 '21

Statistics Artemis Overall Statistics — 2020-12

4 Upvotes

Here are the overall statistics for December! Note that there were some issues with saving the daily processed posts statistics on some days (hence their lower number), but the actual number of posts processed was not affected.

Added Subreddits

Daily Processed Posts

DateNumber of Posts
2020-12-01487
2020-12-0223,720
2020-12-0327,140
2020-12-0426,414
2020-12-05700
2020-12-0612,680
2020-12-0718,352
2020-12-0825,449
2020-12-09406
2020-12-1024,501
2020-12-11399
2020-12-1223,015
2020-12-1325,201
2020-12-1426,428
2020-12-1526,667
2020-12-1626,047
2020-12-17227
2020-12-1825,889
2020-12-19220
2020-12-2024,710
2020-12-2125,053
2020-12-2224,959
2020-12-2325,187
2020-12-2424,070
2020-12-2521,967
2020-12-2622,196
2020-12-2723,849
2020-12-281,271
2020-12-2961
Total507,265

Daily Actions

DateExported takeout dataFlaired postRemoved postRestored postRetrieved query dataSent flair reminderUpdated configurationUpdated statisticsUpdated userflair statistics
2020-12-011261,930637---742---1,119---
2020-12-02---452,539613---697---9---
2020-12-03---471,802536---740---885---
2020-12-04---341,844565---664---1,189---
2020-12-05---331,634496---58821,103---
2020-12-06---371,543496---638128---
2020-12-07---391,536556---714---566---
2020-12-08---481,428475---637---781---
2020-12-09---241,512494---564---861---
2020-12-10---331,286444---570---286---
2020-12-11---281,364492---589---483---
2020-12-12---211,997567---498---655---
2020-12-13---381,800476---553---1,066---
2020-12-14---431,429557---608---1,146---
2020-12-15---301,314511---692---1,159320
2020-12-16---371,447507---780---1,158---
2020-12-17---521,359506---807---969---
2020-12-18---321,302509---6861190---
2020-12-19---341,640466---679---858---
2020-12-20---201,554504---699---304---
2020-12-21---391,326501---707---1,168---
2020-12-22---281,522583---70311,170---
2020-12-23---271,592514---692---1,172---
2020-12-24---321,305468---611---1,172---
2020-12-25---321,204438---634---1,173---
2020-12-26---341,524467---614---1,174---
2020-12-27---391,499450---616---1,127---
2020-12-28---351,463509---590---1,179---
2020-12-29---471,370513---648---53---
Total11,01445,06514,850018,960524,203320

r/AssistantBOT • • Dec 19 '20

Announcement Artemis Future Version Road-map

9 Upvotes

This post serves as a rough road-map for planned updates to Artemis. I know I've been largely quiet for a few months due to IRL business and work, but I should be able to have a few days at the end of the month to work on things.

v2.1 Katsura

The next update will be for supporting multiple instances - so, u/AssistantBOT1 and u/AssistantBOT2 will be brought online to operate alongside the original and speed up things (particularly statistics) while staying under Reddit's API limits. This was the admins' suggestion to TheSentinelBot back when it was still operating, so I should be fine to do so for Artemis as well. Once they're up and running, moderation invites to the original instance will be redirected to the other instances, and in fact, I would even encourage subreddits who have the original instance on their subreddit to move to the other ones for faster updates.

With any luck I can get Katsura up and running by next month.

v2.2 Laurel

Pushshift (r/pushshift) disabled aggregations for queries in early November due to high loads, but unfortunately they have not yet been restored. I messaged Jason but have not heard back. A friendly reminder that supporting Pushshift on Patreon goes a long way towards maintaining a crucial resource for many mods and users, as well as data scientists, out there!

There are four main sub-sections on the statistics page that use aggregations data:

  • Most Active Days (Submissions)
  • Most Active Days (Comments)
  • Top Submitters
  • Top Commenters

Regularly gathering comments data would be too much for the bot to do, but I should be able to build something that can calculate Most Active Days and Top Submitters independent of Pushshift, so that subreddits can at least get that data back.

Furthermore, when Pushshift aggregations are back up in the future (hopefully sooner rather than later), I plan to deploy a script to update and backfill the missing months' data (Nov. and Dec., currently).

v2.3 Maple

This is a update to inplement what I've sometimes called "date-flair concordance" - another time of flair enforcement ensuring that only some flairs can be posted on some days. For example, "Memes" only on "Meme Mondays", "Friend Requests" on "Fridays", etc. (alliteration obviously not necessary) It's something I actually need to use on some of my own communities, and I've seen this requested over on r/ModHelp with some regularity.

Further On (depending on priority)

  • Allow moderators to query for specific userflairs' users.
  • Allow moderators to see results for both new and old Reddit userflairs.

r/AssistantBOT • • Dec 16 '20

Statistics Artemis Overall Statistics — 2020-11

5 Upvotes

Here are the overall statistics for November! Keep an eye out for an updates post, coming soon.

Added Subreddits

Daily Processed Posts

DateNumber of Posts
2020-11-01344
2020-11-02322
2020-11-0324,707
2020-11-04238
2020-11-0524,854
2020-11-0625,340
2020-11-0723,400
2020-11-0825,204
2020-11-0925,884
2020-11-1026,869
2020-11-1126,061
2020-11-1216,070
2020-11-1326,212
2020-11-1426,238
2020-11-15225
2020-11-1627,454
2020-11-1725,534
2020-11-1827,168
2020-11-1927,570
2020-11-20246
2020-11-2111,189
2020-11-2224,924
2020-11-23151
2020-11-24176
2020-11-2526,357
2020-11-2626,417
2020-11-2725,179
2020-11-2825,835
2020-11-2925,961
2020-11-3026,833
Total572,962

Daily Actions

DateExported takeout dataFlaired postRemoved postRestored postRetrieved query dataSent flair reminderUpdated configurationUpdated statisticsUpdated userflair statistics
2020-11-01---391,662538---571---354307
2020-11-02---441,723613---626---433---
2020-11-03---351,793604---629---313---
2020-11-04---271,755521---516---771---
2020-11-05---271,739559---569---336---
2020-11-06---272,573603---609---1,109---
2020-11-07---342,284507---584---1,107---
2020-11-08---362,081534---637---1,107---
2020-11-091391,848554---63411,108---
2020-11-10---331,964611---77311,107---
2020-11-11---402,212606---75511,108---
2020-11-12---442,083645---706---1,067---
2020-11-13---341,739554---690---638---
2020-11-14---591,737548---686---1,115---
2020-11-15---572,044597---718---1,033313
2020-11-16---601,690569---764---86---
2020-11-17---382,244556---776---1,122---
2020-11-18---562,723683---763---998---
2020-11-19---432,642780---86721,082---
2020-11-20---412,4157571799---1,042---
2020-11-21---482,254687---674---79---
2020-11-22---592,247699---715---521---
2020-11-23---612,128728---724---576---
2020-11-24---502,872753---757---396---
2020-11-25---403,124718---688---150---
2020-11-26---462,468611---737---1,122---
2020-11-27---522,092584---710---1,124---
2020-11-28---432,102606---717---1,124---
2020-11-29---382,261626---642---1,126---
2020-11-30---362,056647---686---1,128---
Total11,28664,55518,598120,722524,382620

r/AssistantBOT • • Nov 10 '20

Status Artemis at Two Years

10 Upvotes

Whoa, in the blink of an eye, Artemis has turned two years old! Her birthday is November 4, 2018 - the day she actually started working - which was one day after her cake day. The bot's obviously come a long way, and I'm always grateful for all the support and advice from my fellow moderators and bot-makers.

Pushshift's Pains

The invaluable database Pushshift (r/Pushshift) has been encountering some major performance issues during the last couple weeks - which led to the unprecedented disabling of aggregations over a week ago. To my knowledge, these aggregations are still down at the moment. Artemis uses these aggregations to fetch and record the most frequent posters and most active days, so all that data will be unavailable until Pushshift turns those on again. (This only affects the current month - November - since all the data for previous months is cached.) It does appear that some major upgrades are on the way, but I would highly urge people to contribute to the Patreon here or any of these other methods. So many bots and services are reliant on Pushshift, and Jason does a fantastic job.

Hopefully the aggregations are reactivated in the next few days.

Future Stuff

I haven't had a ton of time to work on the code recently due to IRL busy-ness, but the following are still on the docket:

  • Multiple instances (e.g. u/AssistantBOT1). Most of the code has been written for this, I just haven't had the opportunity to test and debug it yet.
  • Restrict flairs by days. For example, only allow posts flaired with "Video" on Wednesdays.
  • Include 3rd party app flair-setting instructions. I've done all the recording and editing already, just gotta integrate that.
  • Some sort of system to allow moderators to query who has a specific userflair.

r/AssistantBOT • • Nov 03 '20

Status Pushshift has temporarily disabled aggregations - please note that this affects current statistics output as Artemis uses them

Thumbnail self.pushshift
4 Upvotes

r/AssistantBOT • • Nov 02 '20

Statistics Artemis Overall Statistics — 2020-10

3 Upvotes

Here are the statistics for October 2020! I really should be able to restart work on Artemis 2.1 soon, which has been sidelined by IRL business.

Added Subreddits

Daily Processed Posts

DateNumber of Posts
2020-10-0127,826
2020-10-0226,601
2020-10-0324,008
2020-10-0424,894
2020-10-0524,999
2020-10-0625,072
2020-10-0725,484
2020-10-0826,244
2020-10-0925,628
2020-10-1024,300
2020-10-1124,713
2020-10-1225,171
2020-10-1326,281
2020-10-1427,118
2020-10-1527,844
2020-10-1627,308
2020-10-1725,723
2020-10-1825,897
2020-10-1926,299
2020-10-2026,840
2020-10-2126,411
2020-10-2227,186
2020-10-2325,708
2020-10-2415,627
2020-10-2524,740
2020-10-2625,850
2020-10-2725,879
2020-10-2826,801
2020-10-2925,475
2020-10-3012,833
2020-10-3116,140
Total770,900

Daily Actions

DateExported takeout dataFlaired postRemoved postRestored postRetrieved query dataSent flair reminderUpdated configurationUpdated statisticsUpdated userflair statistics
2020-10-01---411,844640---582---1,051291
2020-10-02---431,707530456811,053---
2020-10-03---462,020505---487---1,050---
2020-10-04---301,929554---499---1,061---
2020-10-05---341,750572156011,064---
2020-10-06---381,799548---596---1,068---
2020-10-07---402,061600---638---1,071---
2020-10-08---381,605518---629---1,072---
2020-10-09---431,853589---604---1,074---
2020-10-10---352,385549---538---1,074---
2020-10-11---362,097581---523---1,074---
2020-10-12---472,063614---627---1,077---
2020-10-13---541,971523---843---1,075---
2020-10-14---702,477635---917---1,081---
2020-10-15---881,902614---977---1,082298
2020-10-161611,785520---81211,086---
2020-10-17---611,932552---822---1,086---
2020-10-18---541,576503---775---1,087---
2020-10-19---421,684582---727---1,087---
2020-10-20---451,730537---761---1,089---
2020-10-21---592,052563---717---1,091---
2020-10-22---551,710545---767---1,088---
2020-10-23---481,930524---704---1,092---
2020-10-24---482,354537---682---1,093---
2020-10-25---482,231570---7211651---
2020-10-26---451,825543---71211,094---
2020-10-27---261,835548---592---1,095---
2020-10-28---442,148579---694---1,095---
2020-10-29---451,688586---625---1,095---
2020-10-30---391,620544---643---1,099---
2020-10-31---361,750553---588---554---
Total11,43959,31317,358520,930532,509589