REO

Reo is a modern, multipurpose Discord bot featuring a seamless web dashboard, comprehensive server security, advanced music playback, and automated community management tools.

Showcase

Overview

Music

Bot UI

Features

• Discord bot with hybrid commands
• MongoDB Database
• FastAPI dashboard
• Music controller with live artwork, queue, and activity
• Security and automod controls
• Tickets, giveaways, welcomer, and command management
• English and Hindi help menu support

Stack

• Python
• discord.py
• wavelink
• FastAPI
• MongoDB

Project Layout

• main.py - bot entry point
• reo/src - commands, events, and runtime modules
• reo/surface - dashboard and web routes
• reo/engine - bot core
• storage - Mongo-backed storage layer
• .env - local environment config

Setup

1. Install dependencies

pip install -r requirements.txt

2. Create environment file

Create .env:

TOKEN=""

PREFIX=""

SHARD_COUNT=""

BOT_NAME="Reo"

# Web / API Hosting
WEB_HOST="0.0.0.0"
WEB_PORT="25572"


# Automation Features
SYNC_EMOJIS="False"

# OAuth2 / Dashboard Configuration
DISCORD_CLIENT_ID=""
DISCORD_CLIENT_SECRET=""
DASHBOARD_SECRET=""
DASHBOARD_BASE_URL="http://localhost:25572"

# MongoDB Database Configuration
MONGO_URI=""

3. Discord application setup

In the Discord Developer Portal:

• copy your Application ID into DISCORD_CLIENT_ID
• copy your Client Secret into DISCORD_CLIENT_SECRET
• add this redirect URL:

http://localhost:25572/dashboard/auth/callback

If you use a custom domain, replace the localhost URL with your real dashboard domain in both the portal and DASHBOARD_BASE_URL.

4. Start the bot

python main.py

5. Open the dashboard

http://localhost:25572/dashboard

Login with Discord, choose a server you manage, and configure it from the dashboard.

Dashboard Areas

• Overview
• Security
• Moderation
• Music
• Commands
• Logs
• Giveaways
• Tickets
• Welcomer

Notes

• Only guild owners, administrators, or members with manage server access can manage a server in the dashboard.
• The music page updates live while the bot is running.
• The server language setting affects the help menu output.

License

MIT License

Copyright (c) 2026 Codex Development