https://github.com/dmytro-varich/ukrainian-patrol-bot

Ukrainian Patrol Bot — телеграм-бот з відкритим кодом, який автоматично фільтрує повідомлення, допомагаючи створити позитивне та виключно україномовне середовище в групах. Бот блокує повідомлення російською мовою, забезпечуючи чистоту та відповідність спілкування україномовним стандартам.
https://github.com/dmytro-varich/ukrainian-patrol-bot

aiogram3 python telegram-bot ukrainian-language

Last synced: 21 days ago
JSON representation

Ukrainian Patrol Bot — телеграм-бот з відкритим кодом, який автоматично фільтрує повідомлення, допомагаючи створити позитивне та виключно україномовне середовище в групах. Бот блокує повідомлення російською мовою, забезпечуючи чистоту та відповідність спілкування україномовним стандартам.

• Host: GitHub
• URL: https://github.com/dmytro-varich/ukrainian-patrol-bot
• Owner: dmytro-varich
• Created: 2024-02-24T16:29:09.000Z (11 months ago)
• Default Branch: main
• Last Pushed: 2024-06-11T16:55:09.000Z (7 months ago)
• Last Synced: 2024-06-12T01:36:35.772Z (7 months ago)
• Topics: aiogram3, python, telegram-bot, ukrainian-language
• Language: Python
• Homepage: https://t.me/ukrainian_patrol_bot
• Size: 5.32 MB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# [Ukrainian Patrol Bot](https://t.me/ukrainian_patrol_bot)

**Ukrainian Patrol Bot** — це телеграм-бот з відкритим кодом, який автоматично фільтрує повідомлення, допомагаючи створити позитивне та виключно україномовне середовище в групах. Бот блокує повідомлення російською мовою, забезпечуючи чистоту та відповідність спілкування україномовним стандартам. (Також бот має фільтр нецензурних висловів у групі) 

![image](https://github.com/dmytro-varich/Ukrainian-Patrol-Bot/assets/136006220/98b9142d-ea77-4dc0-ba45-d9347d35a929)

## Особливості

- **Україномовна фільтрація:** Бот аналізує та блокує повідомлення російською мовою.

- **Фільтрація нецензурних висловів:** Бот автоматично виявляє та блокує повідомлення з нецензурними висловами, забезпечуючи культурну атмосферу спілкування.

## Технології

- **aiogram3:** [Фреймворк](https://docs.aiogram.dev/) для створення телеграм-ботів на [Python](https://www.python.org/), що забезпечує зручний і ефективний спосіб розробки та інтеграції функціональності бота.

- **NLP технології:** Використання різноманітних технологій для аналізу та визначення мови в повідомленнях, включаючи детекцію мови, токенізацію, лемматизацію, морфологічний розбір за допомогою [pymorphy3](https://pypi.org/project/pymorphy3/), використання моделей представлення слів, таких як [FastText](https://fasttext.cc/docs/en/python-module.html), а також різні перекладачі з бібліотеки [deep_translator](https://deep-translator.readthedocs.io/).

- **Регулярні вирази:** Використання патернів для виявлення нецензурних висловів та уникнення виключень у пропозиціях за допомогою бібліотеки [re](https://docs.python.org/3/library/re.html).

  

## Використання

1. Для початку введіть команду `/start` в особистих повідомленнях.

2. Додайте бота до групи, натиснувши кнопку «➕ Додати мене в групу», та надайте йому права адміністратора, щоб він міг фільтрувати повідомлення.

3. Щоб увімкнути фільтрацію, введіть команду `/start`, а щоб вимкнути — `/stop`.

4. Якщо ви хочете додати слова, які не потрібно блокувати, додайте їх до списку за допомогою команди `/addwords слово#1, слово#2` (перераховуючи слова через кому).

5. Якщо ви хочете видалити слова зі списку, скористайтеся командою `/deletewords` і виберіть слово.

6. Щоб увімкнути або вимкнути фільтрацію ненормативної лексики в групі, скористайтеся командою `/swearcontrol`.

   

## Подальші оновлення

Телеграм-бот розроблений за принципом [MVP](https://en.wikipedia.org/wiki/Minimum_viable_product) (мінімально життєздатний продукт), що означає подальший розвиток і оновлення продукту за наявності відповідної підтримки, тобто попиту на розвиток проекту. Наступним можливим етапом є *інтеграція моделей штучного інтелекту* для розпізнавання та класифікації слів.