🎭 Bishokus

A versatile French Discord bot designed to enhance and entertain your server. (also available in English)

---

✨ About

Originally developed by Lenoch, the bot was rewritten to improve functionality and maintainability.

Built with: Nextcord | Data Storage: MySQL

📋 Table of Contents

• 🚀 Quick Start
• ⚙️ Dev Setup
  • 🐧 Linux Setup
  • 🪟 Windows Setup
• 🤝 Contributing
• 💬 Support

---

🚀 Quick Start

Add Bishokus to Your Server

➕ Add Bishokus to Your Server

Once added, use /help to see all available commands!

---

🤝 Contributing

Have ideas or found a bug? We'd love to hear from you!

📝 Submit Suggestions & Bug Reports

All feedback is appreciated and will be considered.

---

⚙️ Dev Setup

Setup for Linux

🐍 Setup Python

1. Install Python using your package manager:

   sudo apt update
   sudo apt install python3 python3-venv python3-pip

2. Create & Activate Virtual Environment:

   python3 -m venv .venv
   source .venv/bin/activate

3. Install Dependencies:

   # Install nextcord (Discord library)
   git clone -b components_v2 https://github.com/alentoghostflame/nextcord
   cd nextcord
   POETRY_DYNAMIC_VERSIONING_BYPASS=0.0.1 pip install .
   cd ..
   
   # Install other requirements
   pip install -r requirements.txt

🗄️ Setup MySQL

1. Install MySQL:

   sudo apt update
   sudo apt install mysql-server

2. Start MySQL Service:

   sudo systemctl start mysql
   sudo systemctl enable mysql

3. Secure MySQL Installation:

   sudo mysql_secure_installation

4. Create Database & User:

   sudo mysql -u root -p

   CREATE DATABASE your_database_name;
   CREATE USER 'your_username'@'localhost' IDENTIFIED WITH caching_sha2_password BY 'your_password';
   GRANT ALL PRIVILEGES ON your_database_name.* TO 'your_username'@'localhost';
   FLUSH PRIVILEGES;
   EXIT;

🔧 Configure Application

1. Open config/config.json
2. Update with your database credentials and Discord bot token
3. Reference config/config.example.json for the structure

---

Setup for Windows

🐍 Setup Python

1. Install Python:

   • Download from python.org
   • Run the installer and ensure "Add Python to PATH" is checked

2. Create & Activate Virtual Environment:

   python -m venv .venv
   .venv\Scripts\activate.bat

3. Install Dependencies:

   # Install nextcord (Discord library)
   git clone -b components_v2 https://github.com/alentoghostflame/nextcord
   cd nextcord
   $env:POETRY_DYNAMIC_VERSIONING_BYPASS="0.0.1"
   pip install .
   cd ..
   
   # Install other requirements
   pip install -r requirements.txt

🗄️ Setup MySQL

1. Install MySQL:

   • Download MySQL Installer Community
   • Run the installer and follow the setup wizard

2. Create Database & User:

   Option 1: Using MySQL CLI

   mysql -u root -p --port 3306

   Then run:

   CREATE DATABASE your_database_name;
   CREATE USER 'your_username'@'localhost' IDENTIFIED WITH caching_sha2_password BY 'your_password';
   GRANT ALL PRIVILEGES ON your_database_name.* TO 'your_username'@'localhost';
   FLUSH PRIVILEGES;
   EXIT;

   Option 2: Use the MySQL Installer GUI to create the database interactively

🔧 Configure Application

1. Open config/config.json
2. Update with your database credentials and Discord bot token
3. Reference config/config.example.json for the structure

---

💬 Support

• Discord Community: Join our Discord
• Issues & Bugs: GitHub Issues
• Discussions: GitHub Discussions

---

Made with ❤️ by the Bishokus community

⬆ Back to Top