README.md

---
title: Imager
emoji: 🌍
colorFrom: yellow
colorTo: pink
sdk: gradio
sdk_version: 5.1.0
app_file: gradio_imager.py
pinned: false
license: apache-2.0
---
# IMAGER - Advanced Image Processing Tool 🖼️

IMAGER is a versatile image processing toolkit that offers both a CLI interface for bulk processing and a user-friendly Gradio web interface. It supports various image manipulation features including background removal, resizing, cropping, and background color adjustment.

## Features 🚀

- **Background Removal**: Automatically remove image backgrounds using the `rembg` library
- **Smart Cropping**: Autocrop images based on content
- **Flexible Resizing**: Resize images while maintaining aspect ratio
- **Padding Control**: Add customizable padding around images
- **Background Customization**: Set custom background colors or use color names
- **Preset Settings**: Choose from predefined configurations (S/M/L, light/dark themes)
- **Dual Interface**: Use either CLI for batch processing or Gradio web interface for single images

## Installation 🔧

```bash
# Install required packages
pip install Pillow rembg onnxruntime gradio
```

## CLI Usage (imager.py) 💻

Perfect for bulk processing images. Place images in the `./input` directory and run:

```bash
python imager.py -b -c -r 800x600 -p 10
```

### Command-Line Arguments
- `-b, --background_removal`: Enable background removal
- `-c, --crop`: Enable autocropping
- `-r, --resize AxB`: Resize to AxB pixels (maintains aspect ratio)
- `-p, --padding PIXELS`: Add padding around the image
- `-bg, --background BACKGROUND`: Add background (color name, hex code, or image path)

### CLI Example
```bash
# Process images with background removal, crop, and resize to 320x280
python imager.py -b -c -r 320x280 -p 10

# Add a green background
python imager.py -b -c -r 320x280 -p 10 -bg green
```

## Gradio Web Interface (gradio_imager.py) 🌐

For processing single images with real-time preview:

```bash
python gradio_imager.py
```

### Web Interface Features
1. Upload an image or use example images
2. Choose from preset settings or customize:
   - Enable/disable cropping
   - Toggle background removal
   - Set custom dimensions (e.g., "480x480")
   - Adjust padding (0-200 pixels)
   - Choose background color

### Standard Settings ⚙️
- **Light Theme**: S (240x240), M (480x480), L (960x960)
- **Dark Theme**: Same sizes with dark background (#2A373D)

## Background Color Palettes 🎨

### Grayscale Monochrome
| Color Name     | Hex Code |
|----------------|----------|
| Light Gray     | #D1D1D3 |
| Lavender Gray  | #C6C6C7 |
| Silver Foil    | #AFAFB0 |
| Quick Silver   | #A4A4A5 |
| Spanish Gray   | #999999 |

### Feminine Soft Neutrals
| Color Name    | Hex Code |
|---------------|----------|
| Alabaster     | #F4EEE1 |
| Dark Vanilla  | #C4BDAC |
| Dust Storm    | #EBCFC4 |
| Pale Silver   | #D3C4BE |
| Desert Sand   | #E9CCB1 |

### Neutral Brown
| Color Name      | Hex Code |
|-----------------|----------|
| Café Noir       | #4E3829 |
| Coffee          | #6B513E |
| Beaver          | #8E7766 |
| Khaki           | #B09C8D |
| Champagne Pink  | #E6D7CE |

## Code Structure 📁

- `imager.py`: CLI interface for batch processing
- `gradio_imager.py`: Gradio web interface
- `image_processor.py`: Core image processing functions
- `/data/examples/`: Example images for testing

## Technical Stack 🛠️

- `Gradio` for web interface
- `PIL` for image processing
- `rembg` for background removal
- `onnxruntime` for ML operations

## Contributing 🤝

Contributions are welcome! Feel free to fork the repository and submit pull requests.

## License 📜

This project is open-source and available under the MIT License.

---

Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference