Python Telegram Bot MongoDB python-telegram-bot AsyncIO Games

View on GitHub:
github.com/sukhrobyangibaev/wordlebot

WordleBot is a fun and educational Telegram bot that brings the popular Wordle game to Telegram users. Supporting English, Russian, and Spanish, it’s perfect for language learners, trivia fans, and anyone who enjoys word puzzles.

img

The bot lets users choose their interface and game language, select word length, and play interactive rounds with hints and definitions. It’s a great way to challenge your vocabulary and learn new words in different languages—all within Telegram.

img img img

Key Features

  • Multilingual Support: Play in English, Russian, or Spanish. Choose both your interface and game language.
  • Custom Word Length: Select 4, 5, or 6-letter words for a tailored challenge.
  • Hints & Definitions: Get word hints from Wikipedia, helping you learn as you play.
  • User Progress Tracking: The bot remembers your stats and preferences for a seamless experience.
  • Rich Telegram Integration: Interactive keyboards, formatted messages, and language-specific layouts.
  • Admin Broadcasts & Error Reporting: Admins can send messages to all users, and errors are logged and reported for quick fixes.

Technical Architecture

  • Backend: Written in Python, using the python-telegram-bot library for async Telegram API integration.
  • Database: Uses MongoDB to store users, chats, and word lists for each language and word length.
  • Word Sources: Loads word lists from JSON files and organizes them by language and length for fast random selection.
  • Wikipedia Integration: Fetches word definitions and summaries for hints, using the wikipedia-api library.
  • Logging & Error Handling: All actions are logged, and exceptions are reported to the developer via Telegram.

Example Workflow

  1. User starts the bot:
    The bot greets the user and asks for their native language.
  2. Language and word selection:
    Users choose the game language and word length (4, 5, or 6 letters).
  3. Gameplay:
    The bot picks a random word. Users guess words, and the bot provides feedback with colored tiles (⬜, 🟧, 🟩) and keyboard hints.
  4. Hints and definitions:
    After each round, the bot can provide a Wikipedia-based definition of the word.
  5. Admin features:
    Admins can broadcast messages to all users and receive error reports directly in Telegram.

Technologies Used

  • Python 3
  • python-telegram-bot
  • MongoDB
  • wikipedia-api
  • AsyncIO
  • requests (for external API calls)

This project shows how Telegram bots can make classic games interactive, multilingual, and educational—right inside your chat. Try it out and challenge your friends to a Wordle duel in your favorite language!