UtilsBot+

A modern, feature-rich Discord bot with AI integration, interactive games, network tools, security utilities, and developer commands—all through slash commands.

✨ Features

🤖 AI-Powered: Chat with Google Gemini directly in Discord
🎮 Interactive Games: Play Wordle with friends
🌐 Network Tools: Screenshots, IP lookup, URL expansion
🔐 Security Utilities: 2FA codes, QR generation, password tools
ℹ️ Information: Bot stats, help system, version info
⚙️ Developer Tools: Command sync, code evaluation, hot reload

📖 Documentation

For comprehensive guides, command examples, and detailed setup instructions, visit our GitHub Wiki:

• 🆕 For Users - Friendly guide to all commands
• 🚀 Quick Start - Setup in 5 minutes
• 🔧 Configuration - Detailed settings
• 👨‍💻 For Developers - Technical details

🚀 Quick Start

Prerequisites

• Python 3.11+
• Discord Bot Token
• Google Gemini API Key (free)

Setup (5 minutes)

# 1. Clone and enter directory
git clone <your-repository-url>
cd utils-bot-plus

# 2. Run automated setup
chmod +x setup.sh && ./setup.sh

# 3. Install dependencies  
pip install -r requirements.txt

# 4. Configure .env file (edit with your tokens)
# BOT_TOKEN=your_discord_bot_token
# GEMINI_API_KEY=your_gemini_api_key
# DEV_IDS=your_discord_id

# 5. Initialize database and start
python migrations/init_db.py
python main.py

First Steps

1. Generate invite link: Use python generate_invite.py or /invite command
2. Invite bot to your server with applications.commands scope
3. Use /info to verify bot is working
4. Try /help to see all available commands
5. Use /sync if commands don't appear

💡 Tip: Run python generate_invite.py --help for different permission levels

🛠️ Support

Having issues? Check our troubleshooting guides:

• Common Issues - Setup problems and solutions
• Bot Won't Start - Token and dependency issues
• Commands Not Working - Permission fixes

Need help? Join our [Discord Server] (soon) or open an issue.

📋 Commands Overview

Command	Description	Example
/chat	Chat with AI	/chat message:"Hello!"
/wordle	Play Wordle game	/wordle
/screenshot	Capture website	/screenshot url:"google.com"
/totp	Generate 2FA code	/totp secret:"YOUR2FA"
/invite	Generate bot invite	/invite permissions:"recommended"
/info	Bot statistics	/info
/help	Command help	/help category:"AI"

See all commands →

🏗️ Technical Details

• Language: Python 3.11+ with discord.py 2.4+
• Database: SQLite with SQLAlchemy async ORM
• Architecture: Modular cogs with slash commands only
• APIs: Google Gemini, ip-api, ScreenshotOne (optional)

For technical documentation, see:

• Architecture - Code structure and design
• API Reference - Internal APIs
• Deployment - Production setup

📄 License

MIT License - see LICENSE file for details.

---

📖 Full Documentation • 🚀 Quick Start • 💬 User Guide • 🐛 Issues