Mac headless server#

Automation-only build of withoutBG for Mac. Same Local API as the desktop app, without the GUI. For interactive work, install withoutBG for Mac.

When headless is appropriate#

  • CI pipelines on Apple Silicon runners
  • Automation-only boxes with no desktop session
  • Scripted batch jobs that only need HTTP on port 8000

Local API#

Base URL http://127.0.0.1:8000. Same endpoints as the unified app: GET /health, GET /openapi.json, POST /v1/remove-background. Full reference: Local API docs.

Common flags: --port, --start. See the Mac repo README for the current DMG name (WithoutBG-Server-{version}.dmg).

Related#