Skip to content

Latest commit

 

History

17 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation





"Making language barriers disappear, one translation at a time."


◈ Overview

BotAM is a powerful, multi-engine translation bot for Telegram with smart language detection and a professional, Persian-friendly UI. It runs input through a 4-layer fallback translation system — if one engine fails, another instantly takes over — so a translation is never dropped.

Every session tracks personal statistics, translation history, and a gamified level system, all wrapped in a clean, intuitive interface. Translations complete in under 2 seconds across 15+ languages, with automatic source-language detection.



◈ Why BotAM?

Three Pillars

◆ Multi-Engine Translation 4 backup systems — Google, Bing, Yandex, Baidu — chained as automatic fallbacks

◆ Smart Language Detection Pattern-based script recognition (Persian, Arabic, Cyrillic, Chinese...) fused with API detection

◆ Gamified Experience Personal stats, translation history, and a 5-tier level system from Beginner to Master



◈ Key Features

▶ Feature Description Status
Smart language detection Automatically identifies input language via pattern matching and API cross-check ✅
Multi-engine translation 4 backup translation systems — Google, Bing, Yandex, Baidu ✅
4-layer fallback system If one service fails, the next in the chain takes over automatically ✅
Lightning-fast responses Translations completed in under 2 seconds ✅
15+ languages Comprehensive language coverage with auto-detect ✅
User statistics Detailed personal analytics and progress tracking ✅
Translation history Last 10 translations saved per user ✅
Gamified levels 5-tier ranking from Beginner to Translation Master ✅
Professional UI Clean, intuitive interface with native Persian support ✅
Data persistence User preferences and history saved automatically ✅
24/7 uptime Continuous service availability ✅
Voice translation Speech-to-text, then translate ⏳
File & image translation PDF/DOCX/TXT support, plus OCR for images ⏳
Personal API access Custom API endpoint for developers ⏳


◈ System Architecture

graph TD
    A[💬 User Message] --> B[🔍 Language Detection]
    B --> C{Pattern + API Match}
    C --> D[🌐 Translation Engine]
    D -->|Try 1| E[Google Translate]
    E -->|Fail| F[Bing Translator]
    F -->|Fail| G[Yandex Translate]
    G -->|Fail| H[Baidu Translate]
    E -->|Success| I[✅ Result Delivered]
    F -->|Success| I
    G -->|Success| I
    H -->|Success| I
    I --> J[📊 Stats & History Updated]
    I --> K[🏆 Level Progress Checked]
Loading


◈ Supported Languages

🇺🇸 English    🇮🇷 Persian    🇸🇦 Arabic      🇫🇷 French
🇩🇪 German     🇪🇸 Spanish    🇮🇹 Italian     🇷🇺 Russian
🇯🇵 Japanese   🇰🇷 Korean     🇨🇳 Chinese     🇹🇷 Turkish
🇵🇹 Portuguese 🇮🇳 Hindi      🇳🇱 Dutch       🔍 Auto-detect


◈ Bot Commands

/start          → initialize the bot and show the main menu
/help           → display comprehensive help guide
/stats          → show your translation statistics
/info           → display bot information and system stats


◈ User Levels & Gamification

Level Translations Required Badge
📘 Beginner 0–49 New User
⭐ Advanced 50–99 Active User
💎 Expert 100–499 Power User
🏆 Professional 500–999 Expert
👑 Translation Master 1000+ Master


◈ Usage Examples

Basic translation

User: Hello, how are you?
Bot:  سلام، چطور هستید؟

Auto language detection

User: Bonjour mon ami
Bot:  🔍 Detected: French → Persian
      سلام دوست من

Settings management

  • Change source language — select from 15+ options
  • Change target language — set your preferred output
  • View history — last 10 translations saved
  • Reset settings — return to default configuration


◈ Installation & Setup

Prerequisites: Python 3.9+ · a Telegram bot token from @BotFather

01   Install dependencies

pip install python-telegram-bot==13.15
pip install translators
pip install requests

02   Set your environment variables

export BOT_TOKEN="your_telegram_bot_token"
export ADMIN_ID="your_telegram_user_id"

03   Run it

# This code is for viewing only — cannot be copied or used.
# To use the bot, visit: https://t.me/translator7adc7aminbot


◈ Tech Stack

Layer Technology
Language Python 3.9+
Bot framework python-telegram-bot
Translation Google · Bing · Yandex · Baidu (4-layer fallback)
Language detection Pattern-based regex + API cross-check
Persistence JSON-based user database


◈ Advanced Features

Smart language detection

def _pattern_detect_language(self, text):
    patterns = {
        'fa': r'[\u0600-\u06FF]',    # Persian/Arabic script
        'ar': r'[\u0621-\u064A]',    # Arabic specific
        'ru': r'[а-яё]',             # Cyrillic
        'zh': r'[\u4e00-\u9fff]',    # Chinese characters
        # ... more patterns
    }

Fallback chain

translators_to_try = [
    ('Google', 'google'),
    ('Bing', 'bing'),
    ('Yandex', 'yandex'),
    ('Baidu', 'baidu'),
]


◈ Security & Privacy

Guarantee Detail
No data mining Personal conversations are not stored
Secure API All translation requests are encrypted
Privacy first Only translation history (optional) is saved
GDPR compliant User data can be deleted on request


◈ Viewing Only

⚠️ This is proprietary software for viewing purposes only. Shared for educational and demonstration purposes.

🚫 Prohibited No copying · no modification · no redistribution · no commercial use · no derivative works

✅ Permitted View the code for learning · read the documentation · use the official bot

Interested in using this code for your own project? Contact the developer for proper licensing.



◈ Roadmap

Upcoming

  • 🎙️ Voice translation — speech-to-text, then translate
  • 📄 File support — PDF, DOCX, TXT
  • 🖼️ Image translation — OCR + translate
  • 🔑 Personal API — custom access for developers
  • 📦 Bulk translation — multiple texts at once
  • ⭐ Translation quality scoring
Version Highlights
v6.0 Multi-engine system with 4 fallback APIs
v5.0 Advanced UI with gamification
v4.0 User statistics and history tracking
v3.0 Language detection improvements
v2.0 Multi-language support expansion
v1.0 Initial release


◈ Creator



📧 amintivanix2@gmail.com  ·  🌐 allin1wrench.ir

⭐ If this project is useful to you, drop a star!



◈ License

© 2026 Amin Moniry (AminTivanix2) — All Rights Reserved

This software is proprietary and confidential. Unauthorized copying, modification, distribution, or use of this software, via any medium, is strictly prohibited without the express written permission of the copyright holder. Full details in LICENSE.



About

Detect any language automatically and translate instantly across 15+ languages, powered by your choice of engine — Google, Bing, Yandex, or Baidu. Enjoy a clean, Persian-friendly interface, track your translation history, and count on rock-solid 24/7 uptime.

Topics

Resources

Stars

6 stars

Watchers

0 watching

Forks

Contributors

Languages