This project is a minimalistic Telegram bot that uses the rembg API to remove backgrounds from images sent by Telegram users. The bot is built with aiogram and supports a simple database for tracking users and processed images using MariaDB.
Try this bot in action here.
- Supports commands like
/start,/info,mode_fileandmode_sticker - Removes the background from images sent by users
- Tracks the number of images processed per user
- Docker and Docker Compose (for containerized deployment)
- Python 3.10+ (for manual deployment)
- MariaDB database server
Clone the repository:
git clone https://github.com/EvilFreelancer/telegram-rembg-bot.git
cd telegram-rembg-botCopy compose configuration:
cp docker-compose.dist.yml docker-compose.ymlSet up your environment variables by creating a .env file and populating it with the following:
# Telegram bot settings
TELEGRAM_BOT_TOKEN=123:asdzxc
TELEGRAM_BOT_REMBG_URL="http://rembg:7000/api/remove?url="
TELEGRAM_BOT_DB_HOSTNAME=mariadb
TELEGRAM_BOT_DB_PORT=3306
TELEGRAM_BOT_DB_DBNAME=rembg
TELEGRAM_BOT_DB_USERNAME=remuser
TELEGRAM_BOT_DB_PASSWORD=rempass
TELEGRAM_BOT_DB_DIALECT=mariadb
# Database settings
MYSQL_ROOT_PASSWORD=root_pass
MYSQL_ROOT_HOST=%
MYSQL_DATABASE=rembg
MYSQL_USER=remuser
MYSQL_PASSWORD=rempass
You need to set at least TELEGRAM_BOT_TOKEN, all other settings can use default values.
Start the services using Docker Compose:
docker compose up -dThe bot is now running and connected to the rembg API.
Note:
- For GPU acceleration with rembg, configure your Docker host to support NVIDIA GPUs. Follow the instructions in my post on setting up Linux for running and training neural networks
- Modify the
rembgservice indocker-compose.ymlto enable GPU acceleration
/start- registers the user and displays a welcome message/info- shows the number of images processed by the user/mode_file- returns images without background as document (default)/mode_sticker- returns images without background as sticker- Upload an image to remove its background
This project is licensed under the MIT License.
