Repository navigation
BG Studio CLI v1.0.0 - Initial Stable Release
A powerful command-line tool for intelligent background removal from images using AI.
Features
- 5 AI Models - Choose from multiple pre-trained models optimized for different scenarios
- Custom Backgrounds - Replace transparency with solid colors (hex, RGB, or named colors)
- Advanced Post-Processing - Noise reduction, edge smoothing, and contrast enhancement
- Edge Blending - Natural-looking soft edges for professional results
- Fast Processing - Efficient background removal with optional speed optimizations
- Easy CLI - Intuitive command-line interface with extensive options
Installation
git clone https://github.com/MichailSemoglou/bg-studio-cli.git
cd bg-studio-cli
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txtQuick Start
# Basic usage
python bgstudio.py your_image.jpg
# With custom red background
python bgstudio.py your_image.jpg -b "#FF0000"Example
See the included example with an alabaster alabastron artifact (5th–4th century B.C., Cyprus) demonstrating background removal with custom red background.
Requirements
- Python 3.8+
- rembg >= 2.0.0
- Pillow >= 9.0.0
- numpy >= 1.21.0
- onnxruntime >= 1.12.0