localimgstudio

Local image processing pipeline for background removal and upscaling.

Setup

Install dependencies with uv:

uv venv --clear --python 3.13
uv sync

Run

uv run uvicorn main:app --reload --port 8000

Open http://localhost:8000 in your browser.

Models

Background Removal

via rembg

• birefnet-general: Best all-rounder (default)
• birefnet-portrait: Optimized for portraits
• ben: BEN — good hair/edge detail
• isnet-general-use: ISNet general
• u2net: Legacy U2Net

Upscaling

Spandrel backend

• realesrgan-x4: 4x — Photos (default)
• realesrgan-x2: 2x — Photos
• realesrgan-x4-anime: 4x — Anime / illustrations

rembg handles downloading bg removal models automatically (~200–700 MB, cached in ~/.u2net/).

Experimental support for downloading upscaling models. Try downloading from UI first.

Place the .pth files in models/:

• RealESRGAN_x4plus.pth: https://github.com/xinntao/Real-ESRGAN/releases/download/v0.1.0/RealESRGAN_x4plus.pth
• RealESRGAN_x2plus.pth: https://github.com/xinntao/Real-ESRGAN/releases/download/v0.2.1/RealESRGAN_x2plus.pth
• RealESRGAN_x4plus_anime_6B.pth: https://github.com/xinntao/Real-ESRGAN/releases/download/v0.2.2.4/RealESRGAN_x4plus_anime_6B.pth