Repository navigation
Home
Selldone Background Removal is a self-hosted FastAPI service that removes the background from images using deep learning. Send an image to POST /remove-bg and receive a transparent PNG at the original size. It uses the pre-trained IS-Net model from DIS (recommended) or the earlier U²-Net model, and runs on CPU or an NVIDIA GPU.
- First time? Follow Getting Started to install, download the model and make your first call.
- Integrating it into an app? See the API Reference and Client Examples.
- Choosing a model? Read Models.
- Running it on a server? Read Deployment.
| Page | What you'll learn |
|---|---|
| Getting Started | Prerequisites, install, model download, first request. |
| API Reference | The /remove-bg endpoint: request, response, headers, errors. |
| Models | IS-Net vs U²-Net, weight files, inference settings, how the mask is applied. |
| Client Examples | cURL, Python, JavaScript and PHP examples. |
| Deployment | Host binding, GPU, workers, reverse proxy and security. |
| FAQ | Common questions and troubleshooting. |
| Item | Value |
|---|---|
| Language / framework | Python, FastAPI, PyTorch |
| Endpoint |
POST /remove-bg (multipart field file) |
| Output |
image/png with transparent background |
| Models | IS-Net isnet-general-use.pth (new), U²-Net u2net.pth (old) |
| Run | uvicorn service.app:app --host localhost --port 8000 |
| License | GPL-3.0 |
Background removal is an independent microservice with no dependency on other Selldone packages. In a Selldone workflow it prepares clean product images before they are uploaded with the Backoffice SDK and displayed in a Storefront.
- backoffice-sdk — Admin API client; upload images to products (wiki).
- storefront — Production-ready Vue 3 storefront (wiki).
- excel — Excel templates for bulk product import.
- gpt — Custom GPT for Selldone (wiki).
- All Selldone repositories
IS-Net comes from Highly Accurate Dichotomous Image Segmentation (DIS) — https://xuebinqin.github.io/dis/index.html. U²-Net — https://github.com/xuebinqin/U-2-Net.