Sign inSign up

withoutbg/withoutbg-openweights-v3-service-cpu

By withoutbg

•Updated 2 days ago

Self-hosted withoutBG v3 background removal API (CPU, ONNX, FastAPI).

Image
0

3.5K

withoutbg/withoutbg-openweights-v3-service-cpu repository overview

⁠withoutBG Open Weights v3 — Inference API (CPU)

Self-hosted withoutBG⁠ open weights background removal API. Runs the v3 ONNX model on CPU with a FastAPI service — no GPU required.

⁠Quick start

docker run --rm -p 8000:8000 withoutbg/withoutbg-openweights-v3-service-cpu:latest

Health check: http://localhost:8000/health

⁠Platforms

Published for linux/amd64 and linux/arm64. Docker pulls the matching architecture automatically (Intel/AMD, Apple Silicon, AWS Graviton, etc.).

⁠API

EndpointMethodDescription
/healthGETLiveness probe
/readyGETReadiness probe (model loaded)
/v1/remove-backgroundPOSTRemove image background (raw image or multipart)
/v1/licensesGETModel and dependency licenses
/docsGETOpenAPI / Swagger UI

Same input/output schema as the withoutBG Mac Local API: send a raw JPEG/PNG body (or multipart field image); response is image/png with headers X-Latency-Ms, X-Route-Category and X-Route-Pipeline (matting or birefnet). Use ?output=matte for a grayscale alpha matte instead of the default cutout.

curl -X POST \
  --data-binary @photo.jpg \
  -H "Content-Type: image/jpeg" \
  http://127.0.0.1:8000/v1/remove-background \
  -o result.png
curl -X POST "http://127.0.0.1:8000/v1/remove-background?output=matte" \
  -H "Content-Type: image/png" \
  --data-binary @photo.png \
  -o matte.png

⁠Model

The withoutBG Open Weights 10.8.0 bundle (~1.5 GB, baked into the image): a trained router sends fine strands, soft detail and transparency to the withoutBG matting model, and hard opaque objects, flat scenes and vehicles to BiRefNet. Only the selected branch runs.

ImageUse case
withoutbg/withoutbg-openweights-v3-service-gpuSame API, GPU acceleration
withoutbg/withoutbg-openweights-v3-app-cpuWeb UI + API (CPU)
withoutbg/withoutbg-openweights-v3-app-gpuWeb UI + API (GPU)

Tag summary

Content type

Image

Digest

sha256:ae90afd18…

Size

1 GB

Last updated

2 days ago

docker pull withoutbg/withoutbg-openweights-v3-service-cpu