# Remove Background

> Remove backgrounds from images using AI segmentation. Use when user asks to remove, delete, or make transparent backgrounds from photos or images.

- **Type:** Skill
- **Install:** `agentstack add skill-nc9-skills-remove-background`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [nc9](https://agentstack.voostack.com/s/nc9)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [nc9](https://github.com/nc9)
- **Source:** https://github.com/nc9/skills/tree/main/remove-background

## Install

```sh
agentstack add skill-nc9-skills-remove-background
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Remove Background

Remove image backgrounds using BiRefNet_lite model. Runs locally on CPU, MPS (Apple Silicon), or CUDA.

## When to Use

- User wants to remove background from an image
- User wants a transparent PNG version of an image
- User wants to isolate a subject from its background

## Requirements

No API keys required. Model downloads automatically on first run (~100MB, cached).

## Command

```bash
./scripts/remove_background  [options]
```

## Options

| Option | Description |
|--------|-------------|
| `input` | Input image path (required) |
| `-o, --output` | Output path (default: `{name}_nobg.png`) |
| `-c, --crop` | Smart crop to foreground bounding box |
| `-p, --padding` | Padding around crop in pixels (default: 0) |
| `--device` | Force device: cuda/mps/cpu (default: auto-detect) |
| `-f, --format` | Output: json (default) or table |

## Examples

```bash
# Basic usage - outputs photo_nobg.png
./scripts/remove_background photo.jpg

# Smart crop to subject
./scripts/remove_background photo.jpg --crop

# Smart crop with 20px padding
./scripts/remove_background photo.jpg --crop --padding 20

# Custom output path
./scripts/remove_background photo.jpg -o transparent.png

# Force CPU (if MPS has issues)
./scripts/remove_background photo.jpg --device cpu

# Human-readable output
./scripts/remove_background photo.jpg --format table
```

## Output Format

JSON (default):
```json
{
  "input": "photo.jpg",
  "output": "photo_nobg.png",
  "device": "mps",
  "original_size": [1920, 1080],
  "output_size": [800, 600],
  "cropped": true,
  "crop_box": [120, 80, 920, 680],
  "model": "ZhengPeng7/BiRefNet_lite"
}
```

## Notes

- First run downloads model (~100MB), subsequent runs use cache
- Output is always PNG with alpha channel (transparency)
- Device auto-detection: CUDA > MPS > CPU
- MPS (Apple Silicon) may have some op fallbacks to CPU

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [nc9](https://github.com/nc9)
- **Source:** [nc9/skills](https://github.com/nc9/skills)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-nc9-skills-remove-background
- Seller: https://agentstack.voostack.com/s/nc9
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.