Skip to content


Repository files navigation


Free and open-source bot for Discord.


Yuuki is not actively maintained. Only security and critical bug fixes will be made.


You can invite the publicly usable version of the bot or host your own version to gain full control and access to owner commands.
You can find a list of commands on the wiki.



For Docker (Recommended):

  • A Docker installation, including docker and docker-compose binaries.
    • On Debian-based Linux distros this is usually as simple as apt install docker-compose - for advanced installations check out the documentation

For standalone:

  • Ruby 2.4.0+
  • Bundler (gem install bundler)
  • Locally running Redis (apt install redis-server ?)

Note: We do not currently support running standalone on bare Windows platforms. It should work, but no guarantees or support are made.
For Windows it's recommended to use WSL (WSL1 and WSl2 are both fine) or Docker Desktop.

Install and run

  1. Clone the repo: git clone --recursive
  2. cd into the repo: cd Yuuki-Bot

Then either

Docker (Recommended)

  1. Generate a configuration file. You have a few choices:
    • Run the guided script: docker-compose run yuuki ./config.rb
    • Create a config/config.yml manually: see config/ for details.
    • Uncomment and edit the environment variables in docker-compose.yml
  2. Run the bot: docker-compose up
    To fork it to the background, instead use docker-compose up -d. You can check the running logs with docker-compose logs yuuki.



  1. Create a config file, either through the guided script (ruby config.rb) or manually (See config/
  2. Install bundler if you haven't already: gem install bundler
  3. Install the bundle: bundle install
  4. Run the bot. For Linux: sh For Windows: run_windows.bat.


  1. Pull any changes from the repo: git pull
  2. Check any config changes. In the future more work will be needed on our side to better support this.
    • If anything errors, make sure to check the new config.example.yml and update your config.yml accordingly.


  1. Update the containers: docker-compose pull
  2. Start or restart the containers: docker-compose up -d


  1. Install/update the gem dependancies: bundle install
  2. Run the bot: sh or run_windows.bat

Please report any issues to Erisa | <@228574821590499329> on Discord, or open an Issue!
You can also join our server for support! (Or to find me)


Important Information

Use of this bot is at your own discretion. The bot's current code is viewable at this repository, feel free to review the code to verify its safety. The creator(s) of this code accept no responsibility for any repercussions that occur as a result of adding this bot.

The @Yuuki-Chan help command on the publicly running bot should always show the commit hash of the running code (If a version is shown, omit the first g after that version to get the commit hash) For example at time of writing the bot returns 990bcb5, which corresponds to this code state.




Upstream developers