Join the chat at Gem Version


This library provides an easy way to run bots and scripts that use Reddit API.
I (/u/nakilon) currently run near 10 bots with it.


Python (and so PRAW) sucks.


I'm not usually publish every program (since there are thousand of them and adequate programmer knows that publishing everything is like throwing trash on street) but I'll add bots here so you could see how to use the library.
The examples folder includes:

  • sexypizza -- bot that updates wiki page with current flairs statistics
  • devflairbot -- bot that flairs posts when some specifically flaired user comments there
  • mlgtv -- bot that updates sidebar with currently streaming twitch channels
  • councilofricks -- bot that flairs users according to Google Spreadsheet
  • wallpaper -- bot that reports images with dimensions being not the same as in title
  • cptflairbot3 -- bot that sets user flair according to request submitted via web form
    also publishes its activily log here via Google Cloud Platform automations (Apps Script and Functions)
  • oneplus -- bot that removes and modmails about links to 1080x1920 images
  • yayornay -- bot that flairs posts according to voting in top level comments
  • realtimeww2 -- bot that posts tweets to a subreddit from a Twitter user timeline
  • johnnymarr -- another Twitter timeline streaming bot working in the similar way
  • largeimages -- this was my first bot -- it uses two approaches to track the most high resolution photos posted anywhere on Reddit to x-post them to subreddit /r/largeimages
  • largeimagesreview -- script that was used /r/largeimages to calculates quality of x-posts from different subreddits based on mods activity (remove/approve) so it showed that /r/pics and /r/foodporn should better be excluded:

         pics            Total: 98     Quality: 19%  
      wallpapers         Total: 69     Quality: 52%  
      wallpaper          Total: 45     Quality: 51%  
       woahdude          Total: 30     Quality: 66%  
       CityPorn          Total: 17     Quality: 82%  
       FoodPorn          Total: 13     Quality: 7%  
       MapPorn           Total: 13     Quality: 46%  
       SkyPorn           Total: 11     Quality: 45%  
       carporn           Total: 11     Quality: 45%  

    InfrastructurePorn Total: 9 Quality: 77%

     EarthPorn      Total: 23  Quality: 82%   ✅⛔✅✅✅✅⛔✅✅✅✅✅⛔⛔✅✅✅✅✅✅✅✅✅  
      FoodPorn      Total: 5   Quality: 0%    ⛔⛔⛔⛔⛔                   
      carporn       Total: 4   Quality: 0%    ⛔⛔⛔⛔                    
      CityPorn      Total: 4   Quality: 100%  ✅✅✅✅                    
     spaceporn      Total: 4   Quality: 100%  ✅✅✅✅                    
      MapPorn       Total: 4   Quality: 50%   ✅⛔✅⛔                    

    BotanicalPorn Total: 3 Quality: 66% ✅✅⛔
    CemeteryPorn Total: 2 Quality: 0% ⛔⛔
    MilitaryPorn Total: 2 Quality: 50% ✅⛔
    DessertPorn Total: 2 Quality: 50% ⛔✅
    pic Total: 2 Quality: 100% ✅✅
    ArchitecturePorn Total: 2 Quality: 50% ✅⛔
    AbandonedPorn Total: 2 Quality: 100% ✅✅


$ gem install reddit_bot

or via Gemfile:

source ""
gem "reddit_bot"


require "reddit_bot"

You obviously can't run these examples as is, because they use local configs that are not in git repo, like secrets.yaml file for Reddit authorization of the following format:

:client_id: Kb9.......6wBw
:client_secret: Fqo.....................AFI
:password: mybotpassword
:login: MyBotUsername
# :user_agent: optional_custom_useragent_to_bypass_reddit_spam_protection

To change the log level:

RedditBot.logger.level = Logger::ERROR

To update the gem version in Gemfile.lock when using Gemfile like this: gem "reddit_bot", "~>1.1.0", do the:

$ bundle update reddit_bot

Contributing and License

Bug reports and pull requests are welcome.
The gem is available as open source under the terms of the MIT License.


  • write more usage instructions here
  • manual on how to create bots with Reddit web interface and run via bash console
  • about NetHTTPUtils dependency; and that get_response returns String code not Integer like request_data