Group Guardian

Group Guardian is an open source Telegram bot designed to help group administrators maintain a clean and safe environment for their communities. The bot offers two main functionalities:

• Word Slagging: With the word slagging feature, the bot can detect and remove inappropriate language or spam messages in a group.You can define a list of banned words or phrases in slang words file, and the bot will automatically delete any message containing them.

• Image Filtering: The bot also includes an image filtering feature that can automatically detect and remove pornographic or NSFW images in a group and sent a censored version of the image.

Getting Started

To use Group Guardianship, simply add the bot to your Telegram group and promote to admin.If anyone sends a message containing offensive language or an NSFW image, the bot will automatically delete the message and send a censored version of it instead.

Required Configs

• BOT_TOKEN - Get from @BotFather
• API_ID - Get it from telegram.org
• API_HASH - Get it from telegram.org

Deploy 🚀

Easiest Heroku Deploy 🤭

Host Locally 🤕

1. Clone this repository to your local machine using:

   git clone https://github.com/nacbots/group-guardian
   

2. Install the required dependencies using pip:

   cd group-guardian
   pip install -r requirements.txt
   

3. Create a new bot in Telegram and get your API token (you can follow the instructions here).

4. Configure the bot's settings by editing the config.py file.

5. Start the bot by running:

   python3 main.py
   

6. Add the bot to your Telegram group and enjoy a clean and safe environment!

Support Group:

Contributors

• @NikhilEashy

• @Muhsina-km

Contributing

If you find a bug or have a suggestion for a new feature, please open an issue on this repository or submit a pull request. We welcome contributions from the community!