Nova Bingo AI Assistant 🎰

A Telegram bot for the Nova Bingo real-time multiplayer Bingo platform. Built with Python and python-telegram-bot.

Features

• 14 slash commands — /start, /help, /howtoplay, /play, /rules, /deposit, /withdraw, /balance, /jackpot, /bonus, /activegames, /mytickets, /support, /responsiblegaming
• AI-style chat — responds to natural-language questions about gameplay, wallets, rules, and more
• Casino-style personality — friendly, fast, exciting, and professional
• Responsible gaming — promotes safe play in every interaction

Quick Start

Prerequisites

• Python 3.10+
• A Telegram bot token from @BotFather

Setup

# Clone the repo
git clone https://github.com/betysam55/nova-bingo-bot.git
cd nova-bingo-bot

# Create virtual environment
python3 -m venv venv
source venv/bin/activate

# Install dependencies
pip install -r requirements.txt

# Configure environment
cp .env.example .env
# Edit .env and add your TELEGRAM_BOT_TOKEN

Run

python -m src.bot

Project Structure

nova-bingo-bot/
├── src/
│   ├── bot.py              # Entry point
│   ├── config.py           # Configuration & env vars
│   ├── handlers/
│   │   ├── commands.py     # /start, /help, /play, etc.
│   │   ├── messages.py     # AI chat handler
│   │   └── errors.py       # Error handler
│   └── utils/
│       └── responses.py    # All response templates
├── .env.example
├── requirements.txt
├── pyproject.toml
└── README.md

Commands

Command	Description
/start	Welcome message
/help	List all commands
/howtoplay	Step-by-step guide
/play	Join a game room
/rules	Full game rules
/deposit	Add funds
/withdraw	Cash out winnings
/balance	Check balance
/jackpot	Jackpot info
/bonus	Bonus patterns
/activegames	See live games
/mytickets	View tickets
/support	Get help
/responsiblegaming	Safe play tips

Configuration

Variable	Description	Required
TELEGRAM_BOT_TOKEN	Bot token from @BotFather	Yes
LOG_LEVEL	Logging level (DEBUG, INFO, WARNING, ERROR)	No (default: INFO)

License

MIT