https://github.com/ririkoai/ririkobot

⛩️🌸 Meet Ririko AI, a powerful AI-powered Discord bot with Twitch Live Notifier, Reaction Roles, Giveaways, OpenAI, Stable Diffusion, Moderations, Anime / Manga Finder and more features. A Discord bot you can call your companion! Based on Discord.js v14. By @earnestangel
https://github.com/ririkoai/ririkobot

ai anime bot chatbot discord discord-bot discord-js discord-js-v14 discordjs javascript moderation-discord-bot music ririko-ai slash-commands twitch

Last synced: 11 months ago
JSON representation

Host: GitHub
URL: https://github.com/ririkoai/ririkobot
Owner: RirikoAI
License: mit
Created: 2023-02-26T12:18:30.000Z (over 3 years ago)
Default Branch: master
Last Pushed: 2025-07-25T13:39:12.000Z (11 months ago)
Last Synced: 2025-07-25T15:52:41.663Z (11 months ago)
Topics: ai, anime, bot, chatbot, discord, discord-bot, discord-js, discord-js-v14, discordjs, javascript, moderation-discord-bot, music, ririko-ai, slash-commands, twitch
Language: TypeScript
Homepage: https://ririko.ai
Size: 24.7 MB
Stars: 55
Watchers: 5
Forks: 5
Open Issues: 11
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

[![RirikoAI](https://circleci.com/gh/RirikoAI/RirikoBot.svg?style=svg)](https://app.circleci.com/pipelines/github/RirikoAI/RirikoBot?branch=master)
[![codecov](https://codecov.io/github/ririkoai/ririkobot/branch/beta%2F1.0.0/graph/badge.svg?token=EBD0B7CJ76)](https://codecov.io/github/ririkoai/ririkobot)
[![CodeFactor](https://www.codefactor.io/repository/github/ririkoai/ririkobot/badge/master)](https://www.codefactor.io/repository/github/ririkoai/ririkobot/overview/master)
[![Docker Pulls](https://img.shields.io/docker/pulls/ririkoai/ririkobot.svg)](https://hub.docker.com/r/ririkoai/ririkobot)

[![All Contributors](https://img.shields.io/badge/all_contributors-3-orange.svg?style=flat-square)](#contributors-)

Ririko AI

# Hi there! I'm Ririko AI! 👋

I am a Discord bot that can do a lot of things, including:

Image Generation
Chatbot
Fun Commands
Moderation
Music

Economy
Games
Giveaways
EXP System
...and many more!

See [full list of commands here](https://github.com/RirikoAI/RirikoBot/wiki/LIST:-All-commands-supported-by-Ririko-AI)

Join [our Discord server](https://discord.gg/uw3JTwwWYT) if you need help or just want to chat.

## Deploy to Render (Recommended, Easiest)

Click the button below to deploy Ririko AI to Render. You'll need to provide your Discord bot token, App ID, and other
configurations in the Render
dashboard. [Click here to see the instructions](https://github.com/RirikoAI/RirikoBot/wiki/DEPLOY:-Deploying-to-Render.com).

[![Deploy to Render](https://render.com/images/deploy-to-render-button.svg)](https://render.com/deploy?repo=https%3A%2F%2Fgithub.com%2FRirikoAI%2FRirikoBot)

## Running Ririko AI using Docker (Recommended)

First, you need to have the Docker software installed on your machine. You can find the installation instructions for your OS below:

| Windows Install Link | Linux Install Link | MacOS Install Link | Raspberry Pi Install Link |
|--------------------------------------------------------------------------------|-------------------------------------------------------------|------------------------------------------------------------------------|------------------------------------------------------------------------------------|
| [Docker for Windows](https://docs.docker.com/desktop/install/windows-install/) | [Docker for Linux](https://docs.docker.com/engine/install/) | [Docker for Mac](https://docs.docker.com/desktop/install/mac-install/) | [Docker for Raspberry Pi](https://docs.docker.com/engine/install/raspberry-pi-os/) |

### Setup docker-compose.yml

```bash
# Download the docker-compose.yml file
$ curl -o docker-compose.yml https://install.ririko.ai/docker-compose.yml

# Configure the docker-compose.yml file by adding your Discord bot token, App ID, and other configurations
$ notepad docker-compose.yml # Windows
$ nano docker-compose.yml # Linux / MacOS

# After configuring the docker-compose.yml file, run the following command to start the bot
$ docker compose up -d
```

That's it. You should now have Ririko AI running on your machine. You can rerun `docker compose up -d` to start the bot
again after stopping it or if you changed the configuration in the docker-compose.yml file.

If you want to build the image yourself,
click [here](https://github.com/RirikoAI/RirikoBot/wiki/TUTORIAL:-Building-your-own-Docker-image)

## Install without using Docker (Not recommended)

### Download and install prerequisites

1. Download Node here: https://nodejs.org/en/download.
2. Download FFmpeg here: https://github.com/RirikoAI/RirikoBot/wiki/Extra-configurations-for-Music-Bot.

### Note:

Here's the tricky part, `canvas` and `better-sqlite3` are notoriously known for being difficult to install on Windows.
If you are using Windows and just wants to enjoy using Ririko, we extremely recommend using the recommended methods
above. Save yourself the headache.

```bash
# Install the dependencies and configure the project
$ npm run setup

# Copy .env.example to .env
$ cp .env.example .env # Set your Discord bot token here

# development mode
$ npm run start:dev

# production mode
$ npm run start:prod
```

## Post-installation steps

After installing Ririko AI, you need to set up the AI chatbot, Stable Diffusion, and others:
[Click here to see the instructions](https://github.com/RirikoAI/RirikoBot/wiki/TUTORIAL:-Post%E2%80%90installation-settings)

If you want to use the AI features, head over to this page [AI README.md](https://github.com/RirikoAI/RirikoBot/blob/master/src/ai/README.md)

## Run tests

```bash
# unit tests
$ npm run test

# e2e tests
$ npm run test:e2e

# test coverage
$ npm run test:cov
```

## Contributors ✨

Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):

_{Earnest Angel}
💻 🎨 🚇 ⚠️

_Aki
💻 🎨⚠️

_{Muhammad Afiq Danial Bin Azruliswal}
⚠️ 💻