Home - utils-bot/utils-bot-plus GitHub Wiki
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:
- 2. Getting Started - Installation and basic setup
- 3. For Users - User-friendly guide to all commands
- 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