| # 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* | |