agntswrm avatar

Image Remove Background

This removes image backgrounds and outputs transparent PNGs, useful for product shots, profile pictures, or anything you're compositing later. It wraps the agent-media CLI and supports three providers: a local Transformers.js option that runs on CPU without API keys, plus Fal and Replicate for cloud processing. The local provider is decent for quick jobs but you'll want Fal's birefnet model if you need high resolution output, since it supports custom resolution parameters. Returns a JSON response with the output path and file info. The mutex lock error on local runs is apparently harmless, which is the kind of quirk you just learn to ignore.

skills.sh installs
207
GitHub stars
6
last updated
Aug 21, 2026

Install

$ npx -y skills add agntswrm/agent-media --skill image-remove-background --agent claude-code

Installs into .claude/skills of the current project.

Files

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

Sponsors

Details

Repository
github.com/agntswrm/agent-media
Category
AI & Agent Building
First seen
Jun 3, 2026

More from agntswrm/agent-media

All 2
1buiducnhat avatarfixbuiducnhat/agent-skillsfix207skills.sh installs
2prompt-security avatarclawtributorprompt-security/clawsecHarness-neutral community incident reporting for AI agents. Contribute to collective security by reporting threats.207skills.sh installs
3daffy0208 avatarproduct-analystdaffy0208/ai-dev-standardsTrack user metrics and provide data-driven insights for product decisions. Use when measuring product health, analyzing user behavior, conducting cohort analysi206skills.sh installs
4proffesor-for-testing avatartechnical-writingproffesor-for-testing/agentic-qeWrite clear, engaging technical content from real experience. Use when writing blog posts, documentation, tutorials, or technical articles.205skills.sh installs
5jorgealves avatarindustry-standard-reviewerjorgealves/agent_skillsSimulates a Senior Engineer PR review to teach professional communication and industry naming standards. Use to prepare students for professional engineering en202skills.sh installs
6daffy0208 avatarquality-auditordaffy0208/ai-dev-standardsComprehensive quality auditing and evaluation of tools, frameworks, and systems against industry best practices with detailed scoring across 12 critical dimensi201skills.sh installs