EN | CN

Kurumi — Discord Bot

A multi-purpose Discord bot focused on moderation, automation, and useful utilities.
Feature-complete, stable, and ready to serve.

✨ Features

Kurumi comes packed with 42 commands designed to make server management easier and more fun.

  🛡️ AutoMod — Advanced protection against spam and profanity to keep your chat clean.
  🔧 Moderation — Essential tools for kicking, banning, and managing users efficiently.
  ℹ️ Information — Detailed server info, user info, and utility lookups.
  🔨 Manager Tools — Administration utilities for server configuration.
  🎀 Utilities — Miscellaneous fun and useful commands for your community.

---

🚀 Project Status

Note: Kurumi has reached its final version.
The bot is feature-complete and the development focus is now on stability and polish. New features may be added occasionally, but the core experience is finished.

🛠️ Installation & Setup

Follow these steps to get Kurumi running on your machine.

1. Clone the repository

git clone https://github.com/Dendroculus/kurumi-discord-bot.git
cd kurumi-discord-bot

2. Set up a Virtual Environment (optional but recommended)

# Create the environment
python -m venv venv

# Activate it:
# Windows (PowerShell)
venv\Scripts\Activate.ps1

# Windows (cmd)
venv\Scripts\activate

# Linux / macOS
source venv/bin/activate

3. Install dependencies

pip install -r requirements.txt

Core libraries:

• discord.py
• better_profanity
• aiohttp
• python-dotenv
• asyncpg
• Pillow

4. Configure environment Create a .env file in the project root and add your credentials:

DISCORD_TOKEN=your_bot_token_here
DATABASE_URL=postgresql://user:pass@localhost/dbname
GOOGLE_SAFE_BROWSING_API_KEY=AIzaYour_api_key_here

5. Launch

python main.py

🎨 Credits & Attribution

Artwork

The chibi character artwork featured in this project is created by @pypy_nemui.
Used here solely for non-commercial, portfolio purposes.

Data sources

Anime information and character data is powered by the AniList API

⚖️ License & Disclaimer

This project is open-sourced under the MIT License — see LICENSE.

Disclaimer:

• Kurumi is an independent project and is not affiliated with, endorsed by, or supported by Discord Inc.
• All anime characters and artwork belong to their respective creators.
• Emoji assets are custom-made by the developer. If you fork this repo, please upload the emoji files to your Discord Developer Portal and update the IDs in the code.

_{Made with 💜 by Dendroculus}