
image-remove-background
Removes the background from an image, leaving the foreground subject with transparency. Use when you need to isolate subjects, create cutouts, or prepare images for compositing.
Removes the background from an image, leaving the foreground subject with transparency. Use when you need to isolate subjects, create cutouts, or prepare images for compositing.
Image Remove Background
Removes the background from an image, leaving only the foreground subject with transparency.
Command
agent-media image remove-background --in <path> [options]
Inputs
| Option | Required | Description |
|---|---|---|
--in |
Yes | Input file path or URL |
--out |
No | Output path, filename or directory (default: ./) |
--provider |
No | Provider to use (local, fal, replicate) |
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:
agent-media image remove-background --in portrait.jpg
Remove background using specific provider:
agent-media image remove-background --in portrait.jpg --provider replicate
Providers
local
Runs locally on CPU using Transformers.js, no API key required.
- Uses
Xenova/modnetmodel - Models downloaded on first use (~25MB)
- You may see a
mutex lock failederror — ignore it, the output is correct if"ok": true
agent-media image remove-background --in portrait.jpg --provider local
fal
- Requires
FAL_API_KEY - Uses
birefnet/v2model
replicate
- Requires
REPLICATE_API_TOKEN - Uses
birefnetmodel
You Might Also Like
Related Skills

songsee
Generate spectrograms and feature-panel visualizations from audio with the songsee CLI.
moltbot
slack-gif-creator
Knowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."
anthropics
algorithmic-art
Creating algorithmic art using p5.js with seeded randomness and interactive parameter exploration. Use this when users request creating art using code, generative art, algorithmic art, flow fields, or particle systems. Create original algorithmic art rather than copying existing artists' work to avoid copyright violations.
anthropics
brand-guidelines
Applies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.
anthropics
theme-factory
Toolkit for styling artifacts with a theme. These artifacts can be slides, docs, reportings, HTML landing pages, etc. There are 10 pre-set themes with colors/fonts that you can apply to any artifact that has been creating, or can generate a new theme on-the-fly.
anthropics
canvas-design
Create beautiful visual art in .png and .pdf documents using design philosophy. You should use this skill when the user asks to create a poster, piece of art, design, or other static piece. Create original visual designs, never copying existing artists' work to avoid copyright violations.
anthropics