Pulls random images from Derpibooru for your Discord server's enjoyment.
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.



standard-readme compliant

Pulls random images from Derpibooru for your Discord server's enjoyment.

Table of Contents



  • Python 3.5
  • pip
  • OPTIONAL: Knowledge of virtualenv


  1. $ git clone https://github.com/BytewaveMLP/randibooru

  2. OPTIONAL: Set up a virtualenv in .env/

  3. $ pip install -r requirements.txt

    • NOTE: If you receive errors when pip is installing derpybooru, this is due to an upstream bug in DerPyBooru. The package maintainer has not been around to fix their setup.py script, so for now, you'll have to install both requests and derpybooru by hand, in that order using pip install. Sorry about this, but it's out of my hands.
  4. $ python3 randibooru.py

  5. $ $EDITOR config.ini

    Fill in your information for Derpibooru and Discord

    • Obtain a client ID and API key for Discord here
    • Obtain a Derpibooru API key here
  6. OPTIONAL: Make any additional changes to your configuration file

  7. $ python3 randibooru.py

  8. Complete and use this link to invite your instance of Randibooru to a server: https://discordapp.com/oauth2/authorize?client_id=YOUR_CLIENT_ID_HERE&scope=bot&permissions=19456

    Alternatively, use the link generated in the console output of the bot.

If you don't want to set up Randibooru yourself, feel free to invite the public version of Randibooru to a server of your choice. Please do not overload the bot, however, as requests are logged. We will find you if you mess anything up!


Just run the configured command in chat (prefix + command). By default, this is !rb. Randibooru should handle the rest for you.



We accept PRs! If you have a change you'd like to submit to us, let us know! We'll consider adding it if we feel it's useful. We advise using a virtualenv set up in .env/ to avoid polluting your global package space.

If you're reporting an issue, please make sure to follow the issue template provided. Also, consider checking our Trello first to ensure the issue isn't already being worked on, and make sure to avoid double-posting issues. If it's already been reported, we promise we'll get to it eventually!


Copyright (c) Eliot Partridge, 2016-17. Licensed under the MIT License.