🧩 WSKUSERBOT

⚡ WordSeek Auto-Solver for Telegram

---

🎯 What is WSKUSERBOT?

WSKUSERBOT is a powerful Telegram userbot that automatically plays and wins the @WordSeekBot word game. It uses an entropy-based smart solver algorithm that picks the optimal guess to split remaining candidates most evenly — winning games in the fewest possible attempts.

💡 Think of it as Wordle on autopilot, but for Telegram's WordSeek game!

✨ Features

🧠 Smart Solver Entropy-based word elimination algorithm Supports 4, 5, and 6 letter word modes Pre-cached word lists for instant solving Optimal starter word selection	🤖 Auto Play Auto-starts games with hupp command Auto-reads WordSeek responses Auto-sends optimal guesses Configurable delay between guesses
📊 Stats & Tracking Win/loss tracking per user Streak & best streak records One-attempt win counter Export stats to file	👥 Multi-User Support Multiple user clients simultaneously Per-user session management MongoDB-powered persistence Owner-controlled bot management

🚀 Deployment

📋 Prerequisites

Requirement	Details
🐍 Python	3.11+
🔑 Telegram API	Get from my.telegram.org
🤖 Bot Token	Get from @BotFather
🍃 MongoDB	Free cluster at MongoDB Atlas

⚡ Quick Setup

# 1️⃣ Clone the repository
git clone https://github.com/SUDEEPBOTS/WSKUSERBOT.git
cd WSKUSERBOT

# 2️⃣ Install dependencies
pip install -r requirements.txt

# 3️⃣ Configure environment
cp sample.env .env

🔧 Environment Variables

API_ID=12345                    # Telegram API ID
API_HASH=your_api_hash          # Telegram API Hash
BOT_TOKEN=123456:ABC-xyz        # Bot Token from BotFather
MONGO_URI=mongodb+srv://...     # MongoDB Connection URI
OWNER_ID=123456789              # Your Telegram User ID

▶️ Run the Bot

# Run directly
bash start

# Or with Docker 🐳
docker build -t wskuserbot .
docker run -d --env-file .env wskuserbot

💬 Commands

🔒 Private Chat (DM)

Command	Description
/start	Start the bot & get welcome message
.mode [4/5/6]	Switch word length mode
.delay [seconds]	Set delay between guesses
.stats	View your game statistics
.export	Export stats as text file
.das	Show current session info
.total	View word count per mode
.reset confirm	Reset all your stats
.id	Get your Telegram ID
.logout	Delete session & stop games

👥 Group Chat

Command	Description
hupp	Start auto-playing in this group
bye	Stop the current game

🏗️ Project Structure

WSKUSERBOT/
├── 📄 config.py              # Environment config loader
├── 🐳 Dockerfile             # Docker container setup
├── 📋 requirements.txt       # Python dependencies
├── 📋 sample.env             # Example environment file
├── ▶️  start                  # Startup script
│
└── WSKUSERBOT/               # Main package
    ├── 🔧 __init__.py        # Pyrogram client init
    ├── 🚀 __main__.py        # Bot entry point
    ├── 📊 logging.py         # Colored logging setup
    ├── 👥 user_manager.py    # Multi-user client manager
    ├── 🖼️ start.jpeg         # Welcome image
    │
    └── plugins/              # Bot plugins
        ├── 🎮 game.py        # Game session handler
        ├── 🧩 solver.py      # Entropy-based word solver
        ├── ⚙️ commands.py     # Command handlers
        └── 👋 start.py       # /start command

🧠 How the Solver Works

┌─────────────────────────────────────────────────┐
│               ENTROPY SOLVER                     │
├─────────────────────────────────────────────────┤
│                                                  │
│  1. 📚 Load word list (4/5/6 letters)           │
│  2. 🎯 Pick optimal starter (letter frequency)  │
│  3. 📨 Send guess to WordSeek                   │
│  4. 📖 Read color-coded feedback                │
│  5. 🧮 Calculate entropy for each candidate     │
│  6. ✂️  Eliminate impossible words               │
│  7. 🔄 Pick next guess (max entropy split)      │
│  8. 🏆 Repeat until solved!                     │
│                                                  │
└─────────────────────────────────────────────────┘

The solver picks the guess that maximizes information gain — splitting the remaining word pool as evenly as possible across all possible feedback patterns.

🛡️ Tech Stack

Technology	Purpose
Pyrofork	Telegram MTProto client (Pyrogram fork)
Motor	Async MongoDB driver
TgCrypto	Fast Telegram encryption
aiohttp	Async HTTP requests
Docker	Containerized deployment

📜 License

This project is open source and available under the MIT License.

---

⭐ Star this repo if you found it useful!