A Telegram translator bot that uses X.AI API to translate between any languages.

• 🌐 Universal translation between 18+ languages
• 🏳️ Flag emojis for easy language identification
• 🔄 Two-step language selection flow (source and target)
• 🎛️ Easy language selection via inline buttons
• 📝 Handles up to 2000 characters per request
• ⚡ Error handling for API failures
• 🌍 Multilingual user interface (Arabic/English)
• 🗄️ MongoDB integration for user data storage
• 📊 Admin statistics
• 🔐 Subscription requirement system

NinjaTranslate/
├── bot/
│   ├── __init__.py
│   ├── bot.py           # Main bot module with polling
│   ├── db.py            # Database operations
│   ├── handlers.py      # Message handlers
│   ├── keyboards.py     # Telegram keyboards
│   ├── localization.py  # UI translations
│   └── translations.py  # Translation service
├── config.py            # Configuration
├── main.py              # Entry point (polling mode)
├── .env-example         # Example env file
├── requirements.txt     # Dependencies
└── README.md            # This file

1. Clone this repository
2. Create a .env file with your tokens:

   BOT_TOKEN=your_telegram_bot_token_here
   XAI_API_KEY=your_xai_api_key_here
   MONGO_URI=mongodb://localhost:27017
   MONGO_DB=ninja_translate_bot
   CHANNEL_ID_1=@your_first_channel
   CHANNEL_ID_2=@your_second_channel
   ADMIN_IDS=123456789,987654321

3. Install dependencies:

   pip install -r requirements.txt

4. Run the bot:

   python main.py

1. Start a chat with your bot on Telegram
2. Subscribe to the required channels
3. Send /start to begin translation
4. Select the source language
5. Select the target language
6. Send any text (up to 2000 characters) to translate

• /start - Start the bot and display source language selection
• /translate or /tr - Start a new translation
• /language or /lang - Change the interface language
• /stats - View bot usage statistics (admin only)

🇬🇧 English • 🇸🇦 Arabic • 🇪🇸 Spanish • 🇫🇷 French • 🇩🇪 German • 🇨🇳 Chinese • 🇷🇺 Russian • 🇵🇹 Portuguese • 🇯🇵 Japanese • 🇮🇹 Italian • 🇰🇷 Korean • 🇹🇷 Turkish • 🇳🇱 Dutch • 🇸🇪 Swedish • 🇵🇱 Polish • 🇻🇳 Vietnamese • 🇮🇳 Hindi • 🇺🇦 Ukrainian

Телеграм-бот для перевода, использующий API X.AI для перевода между любыми языками.

• 🌐 Универсальный перевод между 18+ языками
• 🏳️ Эмодзи с флагами для легкой идентификации языков
• 🔄 Двухэтапный процесс выбора языка (исходный и целевой)
• 🎛️ Простой выбор языков через встроенные кнопки
• 📝 Обрабатывает до 2000 символов за запрос
• ⚡ Обработка ошибок API
• 🌍 Многоязычный пользовательский интерфейс
• 🗄️ Интеграция с MongoDB для хранения данных
• 📊 Статистика для администраторов
• 🔐 Система обязательной подписки

NinjaTranslate/
├── bot/
│   ├── __init__.py
│   ├── bot.py           # Главный модуль бота (polling режим)
│   ├── db.py            # Операции с базой данных
│   ├── handlers.py      # Обработчики сообщений
│   ├── keyboards.py     # Клавиатуры Telegram
│   ├── localization.py  # Переводы интерфейса
│   └── translations.py  # Сервис перевода
├── config.py            # Конфигурация
├── main.py              # Точка входа (polling режим)
├── .env-example         # Пример env-файла
├── requirements.txt     # Зависимости
└── README.md            # Этот файл

1. Клонируйте этот репозиторий
2. Создайте файл .env с вашими токенами:

   BOT_TOKEN=your_telegram_bot_token_here
   XAI_API_KEY=your_xai_api_key_here
   MONGO_URI=mongodb://localhost:27017
   MONGO_DB=ninja_translate_bot
   CHANNEL_ID_1=@your_first_channel
   CHANNEL_ID_2=@your_second_channel
   ADMIN_IDS=123456789,987654321

3. Установите зависимости:

   pip install -r requirements.txt

4. Запустите бота:

   python main.py

1. Начните чат с вашим ботом в Telegram
2. Подпишитесь на требуемые каналы
3. Отправьте /start, чтобы начать перевод
4. Выберите исходный язык
5. Выберите целевой язык
6. Отправьте любой текст (до 2000 символов) для перевода

• /start - Запустить бота и отобразить выбор исходного языка
• /translate или /tr - Начать новый перевод
• /language или /lang - Изменить язык интерфейса
• /stats - Просмотреть статистику (только для администраторов)

🇬🇧 Английский • 🇸🇦 Арабский • 🇪🇸 Испанский • 🇫🇷 Французский • 🇩🇪 Немецкий • 🇨🇳 Китайский • 🇷🇺 Русский • 🇵🇹 Португальский • 🇯🇵 Японский • 🇮🇹 Итальянский • 🇰🇷 Корейский • 🇹🇷 Турецкий • 🇳🇱 Нидерландский • 🇸🇪 Шведский • 🇵🇱 Польский • 🇻🇳 Вьетнамский • 🇮🇳 Хинди • 🇺🇦 Украинский

Телеграм-бот для перекладу, що використовує API X.AI для перекладу між будь-якими мовами.

• 🌐 Universal переклад між 18+ мовами
• 🏳️ Емодзі з прапорами для легкої ідентифікації мов
• 🔄 Двоетапний процес вибору мови (вихідна та цільова)
• 🎛️ Простий вибір мов через вбудовані кнопки
• 📝 Обробляє до 2000 символів за запит
• ⚡ Обробка помилок API
• 🌍 Багатомовний інтерфейс користувача
• 🗄️ Інтеграція з MongoDB для зберігання даних
• 📊 Статистика для адміністраторів
• 🔐 Система обов'язкової підписки

NinjaTranslate/
├── bot/
│   ├── __init__.py
│   ├── bot.py           # Головний модуль бота (polling режим)
│   ├── db.py            # Операції з базою даних
│   ├── handlers.py      # Обробники повідомлень
│   ├── keyboards.py     # Клавіатури Telegram
│   ├── localization.py  # Переклади інтерфейсу
│   └── translations.py  # Сервіс перекладу
├── config.py            # Конфігурація
├── main.py              # Точка входу (polling режим)
├── .env-example         # Приклад env-файлу
├── requirements.txt     # Залежності
└── README.md            # Цей файл

1. Клонуйте цей репозиторій
2. Створіть файл .env з вашими токенами:

   BOT_TOKEN=your_telegram_bot_token_here
   XAI_API_KEY=your_xai_api_key_here
   MONGO_URI=mongodb://localhost:27017
   MONGO_DB=ninja_translate_bot
   CHANNEL_ID_1=@your_first_channel
   CHANNEL_ID_2=@your_second_channel
   ADMIN_IDS=123456789,987654321

3. Встановіть залежності:

   pip install -r requirements.txt

4. Запустіть бота:

   python main.py

1. Почніть чат зі своїм ботом у Telegram
2. Підпишіться на необхідні канали
3. Надішліть /start, щоб почати переклад
4. Виберіть вихідну мову
5. Виберіть цільову мову
6. Надішліть будь-який текст (до 2000 символів) для перекладу

• /start - Запустити бота та відобразити вибір вихідної мови
• /translate або /tr - Почати новий переклад
• /language або /lang - Змінити мову інтерфейсу
• /stats - Переглянути статистику (тільки для адміністраторів)

🇬🇧 Англійська • 🇸🇦 Арабська • 🇪🇸 Іспанська • 🇫🇷 Французька • 🇩🇪 Німецька • 🇨🇳 Китайська • 🇷🇺 Російська • 🇵🇹 Португальська • 🇯🇵 Японська • 🇮🇹 Італійська • 🇰🇷 Корейська • 🇹🇷 Турецька • 🇳🇱 Нідерландська • 🇸🇪 Шведська • 🇵🇱 Польська • 🇻🇳 В'єтнамська • 🇮🇳 Хінді • 🇺🇦 Українська

{
  "user_id": 123456789,
  "username": "username",
  "first_name": "First",
  "last_name": "Last", 
  "ui_lang": "en",
  "last_activity": "ISODate(...)",
  "subscription_verified": true,
  "subscription_last_checked": "ISODate(...)"
}