Welcome to UtilsBot+ Wiki

A modern, feature-rich Discord bot built with Python 3.11+ and discord.py 2.4+

UtilsBot+ provides comprehensive utilities including AI integration, interactive games, network tools, security features, and developer commands—all through intuitive slash commands.

🚀 Quick Start

New to UtilsBot+? Start here:

1. 2. Getting Started - Installation and basic setup
2. 3. For Users - User-friendly guide to all commands
3. 4. Commands Reference - Complete technical command list

📚 Documentation Navigation

👥 For Discord Users

• 3. For Users - 🌟 START HERE! Easy guide to using all bot features
• 4. Commands Reference - Complete list of commands with examples
• 12. Troubleshooting - Common issues and solutions
• 13. FAQ - Frequently asked questions

🛠️ For Bot Administrators

• 2. Getting Started - Step-by-step installation guide
• 5. Configuration Guide - Environment setup and customization
• 6. Deployment Guide - Production deployment options
• 16. Docker Automated Setup Guide - Automated Docker deployment for hosting services
• 17. Hosting Service Deployment Guide - Deploy to Render, Railway, Heroku, and other services
• 11. Security Guide - Security features and best practices

💻 For Developers

• 7. Developer Guide - Code structure and contribution guide
• 8. Architecture Overview - System design and components
• 9. Database Schema - Database structure and models
• 10. API Integrations - External service integrations
• 15. Secure Code Execution Guide - Code execution features and file upload capabilities

✨ Key Features

🤖 AI Integration

• Google Gemini 1.5 Flash integration for intelligent responses
• Interactive chat sessions with context awareness
• Free tier with generous limits (15 requests/minute)

🎮 Interactive Games

• Full Wordle implementation with color-coded feedback
• Game statistics and progress tracking
• Extensible game framework for future additions

🌐 Network Tools

• Website screenshots with customizable options
• IP geolocation with comprehensive data
• URL unshortening with security checks

🔐 Security & Utilities

• TOTP generation for two-factor authentication
• QR code creation with multiple sizes
• Text encoding/decoding (Base64, hashing)
• Secure password generation

🛠️ Developer Tools

• Command synchronization (global and guild-specific)
• Code evaluation with secure sandboxing
• Hot reloading for development efficiency
• Comprehensive logging and monitoring

🏗️ Architecture Highlights

• Slash Commands Only - Modern Discord UX
• Async-First Design - High performance and responsiveness
• Modular Cog System - Easy feature management
• Type Safety - Full type hints and validation
• Database Integration - SQLAlchemy with async support
• Comprehensive Error Handling - Robust error management

🔧 Technology Stack

• Discord.py 2.4+ - Modern Discord API wrapper
• SQLAlchemy 2.0 - Async database ORM
• Google Generative AI - Gemini 1.5 Flash integration
• Pydantic 2.8+ - Configuration validation
• Structlog - Structured logging
• aiohttp/httpx - Async HTTP clients

📖 Getting Help

• New User? Start with 3. For Users - the friendliest guide to get started!
• Issues: GitHub Issues
• Discussions: GitHub Discussions
• Wiki: You're here! Browse the numbered sections above
• Technical Docs: TECHNICAL_WIKI.md for detailed technical information

🤝 Contributing

We welcome contributions! See 7. Developer Guide for:

• Code structure and standards
• Setting up development environment
• Submitting pull requests
• Adding new features

📄 License

UtilsBot+ is open source software licensed under the MIT License.

---

Navigation: 2. Getting Started → 3. For Users → 4. Commands Reference