Spaces:

Repcak00
/

background_remover

Sleeping

App Files Files Community

background_remover / README.md

Repcak00

Update README.md

5a2b642 verified about 1 month ago

preview code

raw

history blame contribute delete

4.52 kB

A newer version of the Streamlit SDK is available: 1.55.0

Upgrade

metadata

title: Background Remover
emoji: 💻
colorFrom: indigo
colorTo: blue
sdk: streamlit
sdk_version: 1.54.0
python_version: '3.10'
app_file: src/app.py
pinned: false
license: agpl-3.0

🎨 Background Remover

A powerful, user-friendly desktop application for removing image backgrounds and replacing them with custom colors. Built with Streamlit and powered by state-of-the-art AI models.

✨ Features

🖼️ Batch Processing - Upload and process multiple images at once
🤖 Multiple AI Models - Choose from 7 different background removal models
🎨 Custom Background Colors - Replace backgrounds with any color you choose
🔍 Transparency Options - Keep transparent backgrounds or fill with solid colors
📦 Bulk Download - Download all processed images as a convenient ZIP file
⚡ Real-time Preview - See original and processed images side by side
🖥️ Desktop-First Design - Clean, intuitive interface built for productivity

🚀 Quick Start

Prerequisites

Python 3.11 or higher
pip package manager

Installation

Clone the repository

git clone <repository-url>
cd background-remover

Install dependencies

Using the project file:
```
pip install -e .
```
Run the application
```
streamlit run src/app.py
```

The app will open in your default web browser at http://localhost:8501

📖 Usage

Select Your Preferences
- Choose a background color using the color picker
- Select an AI model (recommended: birefnet-dis for objects with holes)
- Choose transparency mode: keep transparent or fill with color
Upload Images
- Click "Browse files" or drag and drop
- Supports PNG, JPG, and JPEG formats
- Upload single or multiple images
Process Images
- Click "🚀 Process All Images"
- Watch the progress bar as images are processed
- Review results in the side-by-side comparison view
Download Results
- Click "📥 Download All" to get a ZIP file
- All images are saved as PNG to preserve quality

🤖 Available AI Models

Model	Best For	Performance
birefnet-dis	Objects with holes/details	⭐⭐⭐⭐⭐
birefnet-general-lite	Fast general-purpose	⭐⭐⭐⭐
birefnet-general	High-quality general use	⭐⭐⭐⭐⭐
isnet-general-use	General purpose	⭐⭐⭐⭐
u2net	Legacy general use	⭐⭐⭐
birefnet-massive	Maximum accuracy	⭐⭐⭐⭐⭐
bria-rmbg	Commercial-grade	⭐⭐⭐⭐

🛠️ Tech Stack

Streamlit - Web application framework
rembg - AI-powered background removal
Pillow - Image processing
NumPy - Numerical operations
ONNX Runtime - AI model inference

📋 Requirements

streamlit>=1.30
rembg>=2.0.50
pillow>=10.0
numpy>=1.24
onnxruntime>=1.17

🤝 Contributing

Contributions are welcome! This project is licensed under AGPL-3.0, which means:

✅ You can use, modify, and distribute this software
✅ You must share your modifications under the same license
✅ You must make source code available for network use (SaaS)

Please feel free to:

Report bugs
Suggest features
Submit pull requests

📄 License

This project is licensed under the GNU Affero General Public License v3.0 or later (AGPL-3.0-or-later).

See LICENSE for full terms.

Third-Party Components

This software includes the following third-party components:

rembg - Copyright (c) 2020-present Daniel Gatis
License: MIT - See LICENSES/MIT-rembg.txt

⚠️ Disclaimer

This software is provided "as is" without warranty of any kind. The AI models used for background removal may not be perfect for all images. Results may vary depending on image quality and complexity.

🙏 Acknowledgments

Thanks to Daniel Gatis for the excellent rembg library
Built with ❤️ using Streamlit

Made with 🎨 and Python