Personal Telegram Bot ^v0.1.0

• 🎨 Beautiful UI — modern interface with emojis and intuitive navigation
• 🏢 Company Profile — display company name, description, and website
• ✏️ Write Message — dedicated message writing interface
• 📩 Smart Forwarding — all user messages forwarded to administrator with user info
• 🛡️ Security — built-in protection against XSS and malicious content
• 📊 Statistics — admin commands for bot monitoring
• 📱 Cross-Platform — runs on server, desktop, or mobile device (Termux)
• ⚡ Asynchronous — high performance using asyncio and aiogram
• 🔧 Easy Configuration — simple JSON configuration file

Quick Start:

1. Create a bot via @BotFather — save the token
2. Get your Chat ID via @my_id_bot

git clone https://github.com/smartlegionlab/personal-telegram-bot.git
cd personal-telegram-bot

python -m venv venv
source venv/bin/activate
pip install -r requirements.txt

.env file

PERSONAL_API_TOKEN="your_bot_token_from_botfather"
ADMIN_CHAT_ID="your_numeric_chat_id"

.config.json file

{
    "name": "Your Company Name",
    "description": "Detailed description of your company or personal services.",
    "url": "https://your-website.com"
}

For All Users

• /start — Show welcome message with main menu

For Admin Only

• /stats — View detailed bot statistics (messages processed, unique users, errors)
• /health — Check bot status and basic statistics

# Prevent device from sleeping
termux-wake-lock

# Install packages
pkg update && pkg upgrade
pkg install python python-pip git vim rust

# Clone and setup
git clone https://github.com/smartlegionlab/personal-telegram-bot.git
cd personal-telegram-bot

# Create config files
touch .env .config.json
vim .env
vim .config.json

# Setup Python
python -m venv venv
source venv/bin/activate
pip install -r requirements.txt

# Start the bot
python bot.py

Your bot now runs directly on your Android phone!

• Message Validation — checks for malicious content and XSS attempts
• Length Limits — messages limited to 4000 characters
• Content Filtering — blocks scripts and dangerous patterns
• Input Sanitization — all user input is properly validated
• Secure Forwarding — admin receives safe, formatted messages

• Language: Python 3.8+
• Framework: aiogram
• Async: asyncio
• Platform: Server / Desktop / Termux (Android)
• License: BSD 3-Clause