personal-discord-bot GitHub Details, Stars and Alternatives | OpenRepoFinder
0ab2bcf6 / repository
personal-discord-bot
A minimalistic framework for building a highly individualized Discord bot. This repository provides a barebones structure with key components and modules for rapid customization and development. The focus is on simplicity, extensibility, and adaptability for unique user needs.
A transparent discovery signal based on current public GitHub metadata.
Recent activity35% weight
10
Community adoption25% weight
0
Maintenance state20% weight
100
License clarity10% weight
100
Project information10% weight
100
This score does not audit code, security, maintainers, documentation quality, or suitability. Verify the repository and its current documentation before adoption.
README preview
Personal Discord Bot
A barebones structure for a self-hosted Discord bot with custom features, designed for easy individualization and extensibility.
A HuggingFace token, if used (obtainable from HuggingFace.co)
A src/personal-discord-bot/cookies.txt (in this exact path) to use the music bot for youtube (detailed instructions listed here)
Configuration
The bot uses a src/personal-discord-bot/config.yaml file to manage settings for the bot and its cogs. This file should be located in the project root and contain:
Bot Settings: General configuration like the Discord bot token and command prefix
Cog Configurations: A section for each cog, where every cog must include an enabled key (set to true or false) to toggle its functionality. Additional variables specific to each cog (e.g., channel IDs, role IDs, API keys) can be defined as needed. Edit src/personal-discord-bot/config.yaml to match your desired setup before starting the bot.
Installation
To test or run the bot, install the project locally. I recommend creating a virtual environment to isolate dependencies and avoid conflicts with your system’s Python environment.
Virtual Environment
Set up a virtual environment to keep your project dependencies separate:
python3 -m venv botenv
Activate the virtual environment:
On Linux/macOS:
source botenv/bin/activate
And on Windows:
Powershell:
.\botenv\Scripts\Activate.ps1
cmd:
botenv\Scripts\activate.bat
Once activated, your terminal should show (botenv) to indicate the virtual environment is active.
Local Installation
Now navigate into the root folder and install the project locally:
python3 -m pip install -e .
Usage:
To run the bot effectively, follow these steps, especially if hosting it on a remote server:
Create a Separate Screen Session (Linux/macOS)
Use the screen tool to run the bot in a detachable terminal session:
screen -S discordbot
This creates a session named discordbot
Enter the Screen
After creating the screen you should be attached to it. If you’ve detached (see below), reattach to the session:
screen -r discordbot
Start the Bot
Ensure your virtual environment is active (see Virtual Environment). Run the bot with:
python3 -m personal-discord-bot
Detach from the Screen
To leave the bot running in the background, press Ctrl+A, then D. This detaches you without stopping the bot.
Exit the Screen (if needed)
To stop the bot and close the session, reattach with screen -r discordbot, stop the bot (Ctrl+C), then type:
