README-ru.md

⚡ Zapper: Telegram Anti-Spam Bot

Telegram-бот, созданный с использованием aiogram, который автоматически фильтрует спам-сообщения на основе фраз, характерных для определенного языка, и отслеживает статистику спама для каждого группового чата.

Функции

• Обнаружение спама на основе фраз для английского и русского языков
• Динамическое отслеживание спама для каждого группового чата, где находится бот
• Поддержка дополнительных языков путем добавления новых фраз в файл spam_phrases.txt
• Безопасное хранение конфиденциальной информации, такой как токены ботов, в файле .env

Структура проекта

~/
├── .env.example           # Пример файла .env
├── .gitignore             # Для исключения конфиденциальных файлов и кешей Python
├── bot.py                 # Главный скрипт бота
├── requirements.txt       # Зависимости Python
├── spam_phrases.txt       # Файл со списком спам-фраз
├── LICENSE                # Лицензия MIT
├── README-ru.md           # Документация (на русском)
└── README.md              # Документация на английском

Инструкции по настройке

1. Клонируйте репозиторий:

   git clone https://github.com/RGB-Outl4w/zapper-TGAB.git
   cd zapper-TGAB

2. Создайте и настройте файл .env:

• [НЕОБЯЗАТЕЛЬНО] Скопируйте файл .env.example в .env:

cp .env.example .env

• Измените файл .env так, чтобы в нём был ваш токен Телеграм-бота:

BOT_TOKEN=ваш-токен-бота-здесь

3. Установите зависимости: Убедитесь, что у вас установлен Python. Затем установите необходимые библиотеки:

   pip install -r requirements.txt

4. Добавьте спам-фразы: Добавьте спам-фразы в spam_phrases.txt и другие файлы локализации, если необходимо. Каждая фраза должна быть на новой строке и иметь следующий формат:

   language:phrase
   

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

   python bot.py