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:

  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

๐Ÿ› ๏ธ For Bot Administrators

๐Ÿ’ป For Developers

โœจ 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

๐Ÿค 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