Skip to content

one-zero-eight/chat-helper

This branch is 2 commits ahead of IgorDuino/inno-chat-cleaner:main.

Folders and files

NameName
Last commit message
Last commit date

Latest commit

author
Anna Belyakova
Mar 3, 2025
3e04fd9 · Mar 3, 2025

History

5 Commits
Mar 3, 2025
Nov 13, 2024
Nov 13, 2024
Mar 2, 2024
Mar 2, 2024
Nov 13, 2024
Mar 2, 2024
Nov 13, 2024
Nov 13, 2024
Nov 13, 2024
Nov 13, 2024

Repository files navigation

inno-chat-cleaner

Python aiogram Dokku Docker

Simplest bot for removing join/left notifications in Telegram chats. Built with Python and aiogram, this bot can automatically delete messages about users joining or leaving a group. It also requests admin privileges upon being added to a group to perform message deletion.

Features

  • Automatically deletes join/leave messages in groups.
  • Requests admin privileges upon being added to a group for message management.
  • Error handling for message deletion failures.
  • Logging for monitoring and troubleshooting.

Prerequisites

  • Python 3.12 or newer
  • Docker and Docker Compose (for Docker deployment)
  • A Dokku server (for Dokku deployment)

Setup and Deployment

Using Docker Compose

  1. Clone this repository:

git clone https://github.com/one-zero-eight/chat-helper.git cd chat-helper

  1. Create a .env file in the root directory with your Telegram bot token:
TELEGRAM_API_TOKEN=your_telegram_bot_token
  1. Build and run the container:

docker-compose up --build

Deploying with Dokku

  1. On your Dokku server, create a new app:

dokku apps:create inno-chat-cleaner

  1. Set the environment variable for your Telegram bot token:

dokku config:set inno-chat-cleaner TELEGRAM_API_TOKEN=your_telegram_bot_token

  1. Add the Dokku remote to your local repository:

git remote add dokku dokku@your-dokku-server.com:inno-chat-cleaner

  1. Push your app to Dokku:

git push dokku master

Usage

Once deployed, the bot will start monitoring for join/leave messages and delete them automatically. It will also request admin privileges upon being added to a group to ensure it has the necessary permissions to manage messages.

About

Simplest bot for removing join/left notifications

Resources

License

Security policy

Stars

Watchers

Forks

Languages

  • Python 98.6%
  • Dockerfile 1.4%