Skip to content

Group Guardian is a Telegram bot for admins to maintain a safe community.

License

Notifications You must be signed in to change notification settings

NACBots/group-guardian

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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

Deploy 🚀

Easiest Heroku Deploy 🤭

herokudeploy-01

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

pyrogram

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!