# Background Removal Tool - Project Assets

> **Purpose**: Self-hosted background removal API for Etsy t-shirt workflow

---

## Core Files

| File | Description |
|------|-------------|
| `cutoutai.py` | Core BiRefNet processing (365 lines) |
| `api.py` | FastAPI server with webhooks (351 lines) |
| `Dockerfile` | Production container |
| `requirements.txt` | Python dependencies |
| `test_cutout.py` | Automated test script |

---

## Configuration

| File | Description |
|------|-------------|
| `PROMPT.md` | Ralph development instructions |
| `@fix_plan.md` | Task priority tracking |
| `specs/requirements.md` | Technical specifications |

---

## Test Outputs

| File | Description |
|------|-------------|
| `test_output.png` | Synthetic test result |
| `real_test_output.png` | cosmic_bloom.png result |
| `hard_test_output.png` | ChatGPT image result (3.6MB input) |

---

## Key Features

- **Models**: matting, general, portrait, lite, hr, dynamic
- **API**: REST + Webhook (n8n compatible)
- **Output**: PNG, base64
- **Thresholding**: 0.2 (capture_all) / 0.4 (standard)

---

## Deployment Status

| Target | Status |
|--------|--------|
| Local | ✅ Ready |
| Railway | ⬜ Not deployed |
| HuggingFace | ⬜ Not deployed |

---

## Claude Code Quick Start

```powershell
# Start Claude Code with CCR (Gemini backend)
$env:Path = "C:\Users\jonat_cau4\AppData\Local\nvm\v22.21.1;C:\Users\jonat_cau4\AppData\Roaming\npm;" + $env:Path
$env:CLAUDE_BASE_URL = "http://127.0.0.1:3456"
cd "C:\Users\jonat_cau4\.gemini\antigravity\scratch\background removal tool"
claude
```

---

## Related Projects

| Project | Relationship |
|---------|--------------|
| `etsy tshirt project` | Primary consumer of this API |
| `system-instructions` | CCR/Ralph configuration |

---

*Last Updated: Dec 28, 2025*