MedusaXD UserBot 🐍⚡

MedusaXD UserBot is a Powerful, Pluggable Telegram UserBot written in Python using Pyrogram. Unleash the power of automation! 🐍⚡

Features ✨

• 🔌 Pluggable Architecture: Easy to add/remove plugins
• ⚡ Fast & Efficient: Built with Pyrogram for optimal performance
• 🛡️ Secure: Owner verification and sudo user system
• 📊 Database Support: MongoDB integration for data persistence
• 🎯 Rich Commands: 100+ commands across multiple categories
• 🐳 Docker Ready: Containerized for easy deployment
• ☁️ Cloud Deploy: Ready for Render.com, Heroku, and other platforms
• 📝 Comprehensive Logging: Channel logging and console output
• 🔄 Auto Restart: Automatic restart on crashes
• 🎨 Customizable: Highly configurable with environment variables

Plugin Categories 📂

Admin Tools 👮‍♂️

• User management (ban, kick, mute, promote)
• Chat administration
• Anti-spam protection
• Welcome/goodbye messages

Fun & Entertainment 🎮

• Memes and jokes
• Games and quizzes
• Text animations
• Sticker management

Utility Tools 🛠️

• File management and downloads
• System information
• URL shortening
• QR code generation

Miscellaneous 🌟

• Weather information
• Language translation
• Currency conversion
• News and updates

Quick Deploy 🚀

Deploy to Render.com (Recommended)

1. Fork this repository
2. Create a new Web Service on Render.com
3. Connect your forked repository
4. Set environment variables (see Configuration)
5. Deploy!

Deploy with Docker

# Clone the repository
git clone https://github.com/yourusername/MedusaXD-UserBot.git
cd MedusaXD-UserBot

# Copy and edit environment file
cp config.env.sample config.env
# Edit config.env with your values

# Build and run with Docker Compose
docker-compose up -d

Configuration ⚙️

Required Environment Variables

# Telegram API Credentials (get from https://my.telegram.org)
API_ID=your_api_id
API_HASH=your_api_hash

# Session String (generate using session_generator.py)
SESSION_STRING=your_session_string

# Database URL (MongoDB)
DATABASE_URL=mongodb://username:password@host:port/database

# Owner Configuration
OWNER_ID=your_telegram_user_id
LOG_CHANNEL_ID=your_log_channel_id

# Command Triggers
CMD_TRIGGER=.
SUDO_TRIGGER=!

# Workers
WORKERS=8

Optional Environment Variables

# Heroku (if deploying to Heroku)
HEROKU_API_KEY=your_heroku_api_key
HEROKU_APP_NAME=your_app_name

# Progress Bars
FINISHED_PROGRESS_STR=█
UNFINISHED_PROGRESS_STR=░

# Download Path
DOWN_PATH=downloads/

# Single Instance
ASSERT_SINGLE_INSTANCE=true

Installation 📦

Prerequisites

• Python 3.8 or higher
• MongoDB database
• Telegram API credentials
• Session string

Local Installation

1. Clone the repository

   git clone https://github.com/yourusername/MedusaXD-UserBot.git
   cd MedusaXD-UserBot

2. Install dependencies

   pip install -r requirements.txt

3. Generate session string

   python session_generator.py

4. Configure environment

   cp config.env.sample config.env
   # Edit config.env with your values

5. Run the userbot

   python -m userge

Commands 📋

Basic Commands

• .help - Show help menu
• .ping - Check bot latency
• .alive - Check if bot is running
• .restart - Restart the bot
• .shutdown - Shutdown the bot

Plugin Management

• .load <plugin> - Load a plugin
• .unload <plugin> - Unload a plugin
• .reload <plugin> - Reload a plugin
• .plugins - List all plugins

Admin Commands

• .ban <user> - Ban a user
• .unban <user> - Unban a user
• .kick <user> - Kick a user
• .mute <user> - Mute a user
• .unmute <user> - Unmute a user

For a complete list of commands, use .help in your Telegram chat.

Development 👨‍💻

Project Structure

MedusaXD-UserBot/
├── userge/                 # Core framework
│   ├── core/              # Core components
│   ├── plugins/           # Built-in plugins
│   ├── utils/             # Utility functions
│   ├── __init__.py        # Main client
│   ├── config.py          # Configuration
│   └── main.py            # Main logic
├── plugins/               # External plugins
│   ├── admin/             # Admin tools
│   ├── fun/               # Fun commands
│   ├── misc/              # Miscellaneous
│   ├── tools/             # Utility tools
│   └── utils/             # Utility plugins
├── Dockerfile             # Docker configuration
├── docker-compose.yml     # Docker Compose
├── requirements.txt       # Python dependencies
└── README.md              # This file

Creating Plugins

from userge import userge, Message, filters

# Command handler
@userge.on_cmd("hello", about="Say hello")
async def hello_cmd(message: Message):
    await message.edit("Hello, World!")

# Filter handler
@userge.on_filters(filters.text & filters.private)
async def private_handler(message: Message):
    await message.reply("This is a private message!")

Support 💬

• Telegram Channel: @MedusaXD_Updates
• Telegram Group: @MedusaXD_Support
• Issues: GitHub Issues

Contributing 🤝

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Add tests if applicable
5. Submit a pull request

License 📄

This project is licensed under the GNU General Public License v3.0 - see the LICENSE file for details.

Disclaimer ⚠️

This userbot is for educational purposes only. Use it responsibly and in accordance with Telegram's Terms of Service. The developers are not responsible for any misuse of this software.

Credits 🙏

• Pyrogram - MTProto API framework
• UsergeTeam - Original Userge project inspiration
• All contributors and supporters

---

Made with ❤️ by the MedusaXD Team 🐍⚡