mcpField
I
image-remove-background

image-remove-background

github.com/agntswrmCreative & media6205 installsUpdated 34w ago
Repository

About image-remove-background

image-remove-background is a command-line skill that removes image backgrounds and outputs the foreground subject with transparency. It supports local CPU processing as well as fal and replicate providers.

Key features

  1. 01Remove backgrounds while keeping the subject
  2. 02Accept local files or URLs
  3. 03Choose local, fal, or replicate providers
  4. 04Set an output path
  5. 05Set output resolution with fal

Use cases

  1. 01Create transparent portraits
  2. 02Process local or remote images
  3. 03Use fal to process images at a chosen resolution

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/agntswrm/agent-media --skill image-remove-background

After installing, type/image-remove-backgroundin Claude Code to confirm it loaded.

Details

From the project README

Image Remove Background

Removes the background from an image, leaving only the foreground subject with transparency.

Command

npx agent-media@latest image remove-background --in <path> [options]

Inputs

OptionRequiredDescription
--inYesInput file path or URL
--outNoOutput path, filename or directory (default: ./)
--providerNoProvider to use (local, fal, replicate)
--resolutionNoOutput resolution (e.g., "2048x2048"). Supported by fal Dynamic model.

Output

Returns a JSON object with the processed image path:

{
  "ok": true,
  "media_type": "image",
  "action": "remove-background",
  "provider": "fal",
  "output_path": "nobg_123_abc.png",
  "mime": "image/png",
  "bytes": 34567
}

Examples

Remove background from local file:

npx agent-media@latest image remove-background --in portrait.jpg

Remove background using specific provider:

npx agent-media@latest image remove-background --in portrait.jpg --provider replicate

Remove background at full resolution (fal Dynamic model):

npx agent-media@latest image remove-background --in portrait.jpg --provider fal --resolution 2048x2048

Providers

local

Runs locally on CPU using Transformers.js, no API key required.

  • Uses Xenova/modnet model
  • Models downloaded on first use (~25MB)
  • You may see a mutex lock failed error — ignore it, the output is correct if "ok": true
npx agent-media@latest image remove-background --in portrait.jpg --provider local
fal
  • Requires FAL_API_KEY
  • Uses birefnet/v2 model with General Use (Dynamic) variant
  • Supports --resolution option (e.g., "2048x2048") for processing at full input resolution
replicate
  • Requires REPLICATE_API_TOKEN
  • Uses birefnet model

Comments

Markdown supported